This page is about Caddy 1 and will stay here forever.

User Guide


This directive adds PROXY protocol (both v1 and v2) support to Caddy. The PROXY PROTOCOL allows the client IP to be passed through a load balancer like those used in AWS or Google Cloud.

Full documentation


Enable PROXY Protocol Support

Requires all connections (both IPv4 and IPv6) to specify a PROXY header. Both V1 (human readable) and V2 (binary) protocol versions are supported, and will be auto-detected.

Filter by Source Address
proxyprotocol ::/0

Requires connections from the subnet, the IP, and any IPv6 address to specify a PROXY header. All connections from other sources will still operate normally, as if the proxyprotocol directive was not in use. Note It is important to filter to only trusted sources (e.g. proxies, LB), since it is trivial to spoof the source address otherwise.

Custom Timeout
proxyprotocol { timeout 3s }

Changes the timeout for reading the complete PROXY header to 3 seconds. The default is 5 seconds.

Related Links

Access the full documentation for this plugin off-site:

Plugin Help

Get help from the maintainers of the http.proxyprotocol plugin:

Plugin Website

Visit http.proxyprotocol's website for more information:

Plugin Author: Nathaniel Caza
Last Updated: 26 Jul 2019, 12:24 AM
This plugin is independent of the Caddy project and is not endorsed or maintained by Caddy developers. Use at your own risk. Do not file issues for this plugin on Caddy's bug tracker.