proxyfile

The listener

listen, admin, client_address and remove_from_clients are the keys at the top of a proxyfile that hold no keys of their own: the ports of the gateway's two listeners, which address counts as the client's, and the headers it removes from every client request. HTTPS on the public listener is tls. The namespace of its metadata is envoy.namespace. Defaults says what every listener gets with no key.

Key Meaning Rule Class
listen The port of the public listener, on 0.0.0.0. Required. A whole number from 1 to 65535. core
admin The port of the admin listener, on 127.0.0.1; no admin listener when not written. A whole number from 1 to 65535. Not the same as listen. It answers only /ready, /stats and /server_info. core
client_address Which address counts as the client's: forwarded, the last address a proxy in front appended to X-Forwarded-For, or connection, the peer of the TCP connection. forwarded or connection. When not written: connection in a file that writes tls, forwarded otherwise. A rate limit by client and hash.client read it. core
remove_from_clients Headers removed from every client request before routing and before any filter; a name ending in * is a prefix. A list; each item is a lower-case header name, or a prefix ending in *. No route, filter or service sees a client's copy. Envoy holds header names in lower case, so a name with a capital would never match. core

The client's address

client_address says which address the gateway takes as the client's. hash.client and a rate limit by client read that address.

When not written, client_address is connection in a file that writes tls, because a gateway that terminates TLS usually faces its clients, and forwarded otherwise, as in every 2.0 file. A gateway that faces its clients over plain HTTP writes client_address: connection, and one with tls behind a proxy that sets X-Forwarded-For writes client_address: forwarded.