Apache 模块 mod_remoteip

RemoteIPHeader 指令

RemoteIPHeader 指令触发 mod_remoteip 将指定 header-field 头的值视为用户代理 IP 地址或中间用户代理 IP 地址列表，这取决于 RemoteIPInternalProxy 和 RemoteIPTrustedProxy 指令的进一步配置。除非使用这些其他指令，否则 mod_remoteip 将信任所有呈现 RemoteIPHeader IP 值的主机。

RemoteIPHeader X-Client-IP

RemoteIPHeader X-Forwarded-For

RemoteIPInternalProxy 指令

RemoteIPInternalProxy 指令添加一个或多个地址（或地址块）以信任为呈现用户代理 IP 的有效 RemoteIPHeader 值。与 RemoteIPTrustedProxy 指令不同，当从这些代理传递时，此头中呈现的任何 IP 地址（包括私有内联网地址）都将被信任。

RemoteIPHeader X-Client-IP
RemoteIPInternalProxy 10.0.2.0/24
RemoteIPInternalProxy gateway.localdomain

RemoteIPInternalProxyList 指令

RemoteIPInternalProxyList 指令指定在启动时解析的文件，并构建一个地址（或地址块）列表以信任为呈现用户代理 IP 的有效 RemoteIPHeader 值。

'#' 井号字符指定注释行，否则每个空格或换行符分隔的条目都将与 RemoteIPInternalProxy 指令相同的方式进行处理。

RemoteIPHeader X-Client-IP
RemoteIPInternalProxyList conf/trusted-proxies.lst

# Our internally trusted proxies;
10.0.2.0/24         #Everyone in the testing group
gateway.localdomain #The front end balancer

RemoteIPProxiesHeader 指令

RemoteIPProxiesHeader 指令指定一个头，mod_remoteip 将在其中收集所有信任以解析请求的用户代理 IP 的中间客户端 IP 地址列表。请注意，中间 RemoteIPTrustedProxy 地址将记录在此头中，而任何中间 RemoteIPInternalProxy 地址将被丢弃。

RemoteIPHeader X-Forwarded-For
RemoteIPProxiesHeader X-Forwarded-By

RemoteIPProxyProtocol 指令

RemoteIPProxyProtocol 指令启用或禁用 PROXY 协议连接头的读取和处理。如果使用 On 标志启用，则上游客户端必须在每次打开连接时发送头，否则连接将被中止，除非它在 RemoteIPProxyProtocolExceptions 指令提供的禁用主机列表中。

虽然此指令可以在任何虚拟主机中指定，但重要的是要理解，由于 PROXY 协议是基于连接的且与协议无关，因此启用和禁用实际上是基于 IP 地址和端口的。这意味着，如果您对同一主机和端口具有多个基于名称的虚拟主机，并且您为其中任何一个启用它，那么它将为所有虚拟主机启用（具有该主机和端口）。这也意味着，如果您尝试在一个虚拟主机中启用 PROXY 协议，而在另一个虚拟主机中禁用，则该操作将不起作用；在这种情况下，最后一个虚拟主机获胜，并且将记录一条通知，指示哪个设置被覆盖。

Listen 80
<VirtualHost *:80>
    ServerName www.example.com
    RemoteIPProxyProtocol On

    #Requests to this virtual host must have a PROXY protocol
    # header provided. If it is missing, the connection will
    # be aborted
</VirtualHost>

Listen 8080
<VirtualHost *:8080>
    ServerName www.example.com
    RemoteIPProxyProtocol On
    RemoteIPProxyProtocolExceptions 127.0.0.1 10.0.0.0/8

    #Requests to this virtual host must have a PROXY protocol
    # header provided. If it is missing, the connection will
    # be aborted except when coming from localhost or the
    # 10.x.x.x RFC1918 range
</VirtualHost>

RemoteIPProxyProtocolExceptions 指令

RemoteIPProxyProtocol 指令启用或禁用 PROXY 协议连接头的读取和处理。有时，希望要求客户端提供 PROXY 头，但允许其他客户端在没有头的情况下连接。此指令允许服务器管理员配置单个主机或 CIDR 主机范围，这些主机或范围可以这样做。这通常对监控和管理流量到上游负载均衡器后面的虚拟主机服务器很有用。

RemoteIPTrustedProxy 指令

RemoteIPTrustedProxy 指令添加一个或多个地址（或地址块）以信任为呈现用户代理 IP 的有效 RemoteIPHeader 值。与 RemoteIPInternalProxy 指令不同，这些代理报告的任何内联网或私有 IP 地址（包括 10/8、172.16/12、192.168/16、169.254/16 和 127/8 块（或在 IPv6 公共 2000::/3 块之外）都不会被信任为用户代理 IP，并且将保留在 RemoteIPHeader 头的值中。

RemoteIPHeader X-Forwarded-For
RemoteIPTrustedProxy 10.0.2.16/28
RemoteIPTrustedProxy proxy.example.com

RemoteIPTrustedProxyList 指令

RemoteIPTrustedProxyList 指令指定在启动时解析的文件，并构建一个地址（或地址块）列表以信任为呈现用户代理 IP 的有效 RemoteIPHeader 值。

'#' 井号字符指定注释行，否则每个空格或换行符分隔的条目都将与 RemoteIPTrustedProxy 指令相同的方式进行处理。

RemoteIPHeader X-Forwarded-For
RemoteIPTrustedProxyList conf/trusted-proxies.lst