Describe the trusted_proxies key in README.md and config.example.yml, including the rightmost-non-proxy selection rule and the safe default of trusting no one. Record the unit in TODO.md. Model: opus-4-8
This commit is contained in:
@@ -126,6 +126,15 @@ Configured via YAML file (`--config`). Key settings:
|
||||
added to the always-enforced built-in ranges (loopback, private,
|
||||
link-local, CGNAT, benchmark, NAT64, and the like); an invalid CIDR
|
||||
aborts startup
|
||||
- `trusted_proxies` — list of CIDR ranges of the reverse proxies in front
|
||||
of pixa. `X-Forwarded-For` is believed only when the direct peer falls
|
||||
inside one of these ranges; the logged and login-recorded client
|
||||
address is then the rightmost forwarded entry that is not itself a
|
||||
trusted proxy. Otherwise the direct peer address is used and the header
|
||||
is ignored, so a client connecting directly cannot spoof its address.
|
||||
Omitted or empty trusts no one; an invalid CIDR aborts startup. Set
|
||||
this to your proxy's address range when deploying behind a reverse
|
||||
proxy
|
||||
- `upstream_fetch_timeout` — timeout for origin requests
|
||||
- `upstream_max_response_size` — max origin response size
|
||||
- `downstream_timeout` — client response timeout
|
||||
|
||||
Reference in New Issue
Block a user