Apache 模組 mod_remoteip

RemoteIPHeader 指令

RemoteIPHeader 指令觸發 mod_remoteip 將指定的 header-field 標頭值視為 useragent IP 位址，或中間 useragent IP 位址清單，但須視進一步設定 RemoteIPInternalProxy 和 RemoteIPTrustedProxy 指令而定。除非使用這些其他指令，否則 mod_remoteip 會信賴提供 RemoteIPHeader IP 值的所有主機。

RemoteIPHeader X-Client-IP

RemoteIPHeader X-Forwarded-For

RemoteIPInternalProxy 指令

RemoteIPInternalProxy 指令會新增一個或多個位址 (或位址區塊)，將該位址 (或位址區塊) 視為提供 useragent IP 的有效 RemoteIPHeader 值。與 RemoteIPTrustedProxy 指令不同，從這些 proxy 傳遞時，會信賴此標頭中提供的任何 IP 位址，包括私人內部網路位址。

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

RemoteIPInternalProxyList 指令

RemoteIPInternalProxyList 指令會指定在開機時剖析的檔案，並建立視為提供 useragent 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 會在其中收集所有可信賴用於解析請求的 useragent 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 指令添加一个或多个地址（或地址块），以使其可信，将呈现 useragent IP 的有效 RemoteIPHeader 值。与 RemoteIPInternalProxy 指令不同，此类代理报告的任何内部网或私有 IP 地址，包括 10/8、172.16/12、192.168/16、169.254/16 和 127/8 块（或 IPv6 公共 2000::/3 块之外），都不会被视为 useragent IP 可信，并保留在 RemoteIPHeader 标头的值中。

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