COREDNS-PROXYPROTO(7) CoreDNS Plugins COREDNS-PROXYPROTO(7) NAME proxyproto - add PROXY protocol <https://www.haproxy.org/down- load/1.8/doc/proxy-protocol.txt> support. DESCRIPTION This plugin adds support for the PROXY protocol version 1 and 2. It allows CoreDNS to receive connections from a load balancer or proxy that uses the PROXY protocol to forward the original client's IP address and port infor- mation. SYNTAX proxyproto { allow <CIDR...> default <use|ignore|reject|skip> } If allow is unspecified, PROXY protocol headers are accepted from all IP addresses. The default option controls how connections from sources not listed in allow are handled. If default is unspecified, it defaults to ig- nore. The possible values are: - use: accept and use PROXY protocol head- ers from these sources - ignore: accept and ignore PROXY protocol headers from other sources - reject: reject connections with PROXY protocol headers from other sources - skip: skip PROXY protocol processing for connections from other sources, treating them as normal connections preserving the PROXY protocol headers. EXAMPLES In this configuration, we allow PROXY protocol connections from all IP ad- dresses: . { proxyproto forward . /etc/resolv.conf } In this configuration, we only allow PROXY protocol connections from the specified CIDR ranges and ignore proxy protocol headers from other sources: . { proxyproto { allow 192.168.1.1/32 192.168.0.1/32 } forward . /etc/resolv.conf } In this configuration, we only allow PROXY protocol headers from the speci- fied CIDR ranges and reject connections without valid PROXY protocol head- ers from those sources: . { proxyproto { allow 192.168.1.1/32 default reject } forward . /etc/resolv.conf } CoreDNS March 2026 COREDNS-PROXYPROTO(7)
NAME | DESCRIPTION | SYNTAX | EXAMPLES
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=coredns-proxyproto&sektion=7&manpath=FreeBSD+Ports+15.1.quarterly>