docs: Add forward_proxy_url parameter introduction (#405)

* Add forward_proxy_url parameter intro caddyserver/caddy#6114 * Update src/docs/markdown/caddyfile/directives/reverse_proxy.md Co-authored-by: Matt Holt <[email protected]> --------- Co-authored-by: Matt Holt <[email protected]>
caddyserver · Aug 19, 2024 · 5ab8f02 · 5ab8f02
1 parent 7b279d7
commit 5ab8f02
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/src/docs/markdown/caddyfile/directives/reverse_proxy.md b/src/docs/markdown/caddyfile/directives/reverse_proxy.md
@@ -529,6 +529,7 @@ transport http {
 	versions <versions...>
 	compression off
 	max_conns_per_host <count>
+	forward_proxy_url <url>
 }
 ```
 
@@ -593,6 +594,11 @@ transport http {
 
 - **max_conns_per_host** <span id="max_conns_per_host"/> optionally limits the total number of connections per host, including connections in the dialing, active, and idle states. Default: No limit.
 
+- **forward_proxy_url** <span id="forward_proxy_url"/> is a parameter that specifies the URL of a server that the HTTP transport will use to proxy requests to the upstream server. This parameter takes precedence over environment variables like HTTP_PROXY. When a value is provided for this parameter, requests will flow through the reverse proxy in the following order:
+  a. User Agent -> Reverse Proxy
+  b. Reverse Proxy -> Forward Proxy (specified by `forward_proxy_url`)
+  c. Forward Proxy -> Upstream Server
+
 
 
 #### The `fastcgi` transport