proxmox-mirrors/pve-docs
1
0
Fork 0
mirror of https://git.proxmox.com/git/pve-docs synced 2025-04-28 06:06:30 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

fix #5699: pveproxy: add docs for real IP support

Browse Source 
Signed-off-by: Thomas Skinner <thomas@atskinner.net>
This commit is contained in:
Thomas Skinner 2024-12-11 21:27:04 -06:00 committed by Fabian Grünbichler
parent 5b4f685606
commit 7da9c0cf1c
1 changed files with 29 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
pveproxy.adoc
View File

@ -198,6 +198,35 @@ content, if the client supports it. This can disabled in `/etc/default/pveproxy`
COMPRESSION=0
[[pveproxy_real_ip]]
Real Client IP Logging
----------------------
By default, `pveproxy` logs the IP address of the client that sent the request.
In cases where a proxy server is in front of `pveproxy`, it may be desirable to
log the IP of the client making the request instead of the proxy IP.
To enable processing of a HTTP header set by the proxy for logging purposes, set
`PROXY_REAL_IP_HEADER` to the name of the header to retrieve the client IP from. For
example:
PROXY_REAL_IP_HEADER="X-Forwarded-For"
Any invalid values passed in this header will be ignored.
The default behavior is log the value in this header on all incoming requests.
To define a list of proxy servers that should be trusted to set the above HTTP
header, set `PROXY_REAL_IP_ALLOW_FROM`, for example:
PROXY_REAL_IP_ALLOW_FROM="192.168.0.2"
The `PROXY_REAL_IP_ALLOW_FROM` setting also supports values similar to the `ALLOW_FROM`
and `DENY_FROM` settings.
IP addresses can be specified using any syntax understood by `Net::IP`. The
name `all` is an alias for `0/0` and `::/0` (meaning all IPv4 and IPv6
addresses).
ifdef::manvolnum[]
include::pve-copyright.adoc[]
endif::manvolnum[]