From f472525926d44b72d54bceddcc404883804ffee2 Mon Sep 17 00:00:00 2001
From: Mike Rumph When used inside a Suppose the local server has address unix:
URL is DefaultRuntimeDir
aware.<Location>
section, the first argument is omitted and the local
+ directory is obtained from the <Location>
. The same will occur inside a
+ <LocationMatch>
section;
+ however, ProxyPass does not interpret the regexp as such, so it is necessary
+ to use ProxyPassMatch
in this situation instead.http://example.com/
;
thenhttp://example.com/mirror/foo/bar
to be internally converted
into a proxy request to http://backend.example.com/bar
.
The ProxyPass directive is not supported in <Directory>
or <Files>
sections.
If you require a more flexible reverse-proxy configuration, see the
+ RewriteRule
directive with the
+ [P]
flag.
The following alternative syntax is possible; however, it can carry a performance penalty when present in very large numbers. The advantage of the below syntax is that it allows for dynamic control via the @@ -1053,6 +1065,8 @@ ProxyPass "/mirror/foo" "http://backend.example.com" +
ProxyPass key=value
Parameters
In Apache HTTP Server 2.1 and later, mod_proxy supports pooled connections to a backend server. Connections created on demand can be retained in a pool for future use. Limits on the pool size @@ -1385,6 +1399,8 @@ ProxyPass "/" "balancer://mycluster/" stickysession=JSESSIONID|jsessionid nofail </Proxy> +
Additional ProxyPass Keywords
+Normally, mod_proxy will canonicalise ProxyPassed URLs. But this may be incompatible with some backends, particularly those that make use of PATH_INFO. The optional nocanon @@ -1398,18 +1414,6 @@ ProxyPass "/" "balancer://mycluster/" stickysession=JSESSIONID|jsessionid nofail The optional noquery keyword (available in httpd 2.4.1 and later) prevents this.
-When used inside a <Location>
section, the first argument is omitted and the local
- directory is obtained from the <Location>
. The same will occur inside a
- <LocationMatch>
section;
- however, ProxyPass does not interpret the regexp as such, so it is necessary
- to use ProxyPassMatch
in this situation instead.
This directive is not supported in <Directory>
or <Files>
sections.
If you require a more flexible reverse-proxy configuration, see the
- RewriteRule
directive with the
- [P]
flag.
The optional interpolate keyword, in combination with
ProxyPassInterpolateEnv
, causes the ProxyPass
to interpolate environment variables, using the syntax
diff --git a/docs/manual/mod/mod_proxy.xml.fr b/docs/manual/mod/mod_proxy.xml.fr
index 4122492fff..0e2b7371fd 100644
--- a/docs/manual/mod/mod_proxy.xml.fr
+++ b/docs/manual/mod/mod_proxy.xml.fr
@@ -1,7 +1,7 @@
-
+
diff --git a/docs/manual/mod/mod_proxy.xml.ja b/docs/manual/mod/mod_proxy.xml.ja
index c7e3f2fc0f..ebf4842605 100644
--- a/docs/manual/mod/mod_proxy.xml.ja
+++ b/docs/manual/mod/mod_proxy.xml.ja
@@ -1,7 +1,7 @@
-
+