github graygnuorg/pound v4.4
Version 4.4

latest releases: v4.14, v4.13, v4.12...
22 months ago

New directive: HeaderOption

The HeaderOption directive controls what kind of "canned" headers pound adds to the HTTP request before passing it on to the backend. By default, it adds "forwarded" headers (X-Forwarded-For, X-Forwarded-Proto, and X-Forwarded-Port) and, if serving a HTTPS session, X-SSL-* headers.

The arguments to the HeaderOption directive enable or disable these canned headers. The default corresponds to

  HeaderOption forwarded ssl

To disable any kind of headers, precede its name with a no-:

  HeaderOption no-forwarded

The special keywords none and all, can be used to disable or enable all canned headers.

The HeaderOption directive can appear in the global scope or within a ListenerHTTP (or ListenerHTTPS) section.

Header modification and service matching

Header modification directives are applied after service matching directives (such as Header or HeadRequire). This is a disruptive change: in previous pound versions header removal was done prior to service selection.

Header modification order

Header modification directives are applied in the following order: HeaderOptions, HeaderRemove, HeaderAdd. In other words, built-in headers are added first. Then, header removal directives are applied. Finally, headers requested by the user are added. Added headers overwrite headers with the same name that may already be present in the request. Thus, you can use HeaderRemove and HeaderAdd to trim down headers added by HeaderOptions.

Back-references in Redirect and ACME statements

Arguments to Redirect and ACME statements can contain references to parenthesized subexpressions in the most recently matched URL, Header, or Host statements. Syntactically, $N refers to URL subexpression and %N refers to subexpression of Header (or Host). $0 and %0 are expanded to the entire URL or header (host). For example, to redirect all requests to https:

	Service
		Host -re ".+"
		URL ".*"
		Redirect "https://%0$0"
	End

Don't miss a new pound release

NewReleases is sending notifications on new releases.