#我們知道nginx是web伺服器和代理伺服器,它一般工作在proxy server或負載平衡軟體(Haproxy ,Amazon Elastic Load Balancer (ELB)的後面。
首先,客戶端向代理伺服器或負載平衡軟體發起請求,然後請求會被轉發到nginx進行實際的web存取。
因為經過了多層軟體,所以客戶端的一些資訊例如ip位址,連接埠號碼等可能就會被隱藏,這對於我們問題分析,資料統計都是不利的。我們希望獲得客戶端真實的IP位址,以便獲取準確的請求環境。
這種情況下就需要用到PROXY protocol了。
#如果前面所說的proxy或LSB都實現了PROXY protocol協定的話,不管是HTTP, SSL , HTTP/2, SPDY, WebSocket 還是TCP協議,nginx都可以拿到客戶端的原始IP位址,從而根據原始IP位址進行一些特殊的操作,例如屏蔽惡意IP的訪問,根據IP不同展示不同的語言或頁面,或者更簡單的日誌記錄和統計等,都非常有效。
當然,如果想要支援PROXY protocol,對nginx的版本也是有要求的,具體版本需求如下:
想要支援PROXY protocol v2,需要NGINX Plus R16或NGINX Open Source 1.13.11。
想要支援ROXY protocol for HTTP,需要NGINX Plus R3或NGINX Open Source 1.5.12。
想要支援TCP client‑side PROXY protocol,需要NGINX Plus R7或NGINX Open Source 1.9.3。
在nginx中可以透過下面的變數來取得對應的客戶端資訊,具體而言如下所示:
$proxy_protocol_addr和$proxy_protocol_port 分別表示的是原始客戶端的IP位址和連接埠號碼。
$remote_addr 和 $remote_port表示的是load balancer的的IP位址和連接埠。
如果你使用了RealIP擴充模組,那麼這個模組會重寫$remote_addr 和 $remote_port這兩個值,將其替換成原始客戶端的IP位址和連接埠號碼。
然後使用$realip_remote_addr 和 $realip_remote_port來表示load balancer的的IP位址和連接埠。
在nginx中設定使用proxy protocol
在nginx中啟用proxy protocol
如果你的nginx已經是支援proxy protocol的版本,那麼啟用proxy protocol非常簡單,只需要在server中的listen中加入proxy_protocol即可,如下:
http { #... server { listen 80 proxy_protocol; listen 443 ssl proxy_protocol; #... } } stream { #... server { listen 112233 proxy_protocol; #... } }
大家比較熟悉的是http block,在nginx中,它表示對http/https的支持。 Nginx提供了對TCP/UDP協定的支持,這項功能透過stream模組實現,對許多人來說比較陌生。
使用Real‑IP modules
Real‑IP modules是nginx自帶的一個模組,可以透過下面的指令來查看nginx是否有安裝real-ip模組:
nginx -V 2>&1 | grep -- 'http_realip_module' nginx -V 2>&1 | grep -- 'stream_realip_module'
如果你目前使用的版本沒有real ip,也不要急,這時候你可能需要從原始碼編譯。
在編譯的過程中,我們需要執行一個configure指令,在這個configure指令中可以指定要開啟的功能,例如stream或http_ssl_module:
$ ./configure --sbin-path=/usr/local/nginx/nginx --conf-path=/usr/local/nginx/nginx.conf --pid-path=/usr/local/nginx/nginx.pid --with-pcre=../pcre-8.44 --with-zlib=../zlib-1.2.11 --with-http_ssl_module --with-stream --with-mail
如果要開啟real-ip功能,則可以新增:
--with-http_realip_module
如果nginx是運行在SLB或proxy之後的,那麼可以透過set_real_ip_from指令來指定代理程式或負載平衡伺服器的IP範圍,如下所示:
server { #... set_real_ip_from 192.168.1.0/24; #... }
http { server { #... real_ip_header proxy_protocol; } }
請求轉送
不管是http還是stream block,都可能會遇到請求向後續的upstream進行轉送的情況,對於upstream來說,他們希望收到的是真實客戶端IP位址,而不是proxy或slb的位址,那麼可以透過下面的設定來解決:
http { proxy_set_header X-Real-IP $proxy_protocol_addr; proxy_set_header X-Forwarded-For $proxy_protocol_addr; }
stream { server { listen 12345; proxy_pass example.com:12345; proxy_protocol on; } }
日誌記錄
日誌是一個非常重要的功能,對於定位問題,執行資料統計分析都非常有用,當然我們需要的是真實的客戶端IP位址。
###我們可以透過使用變數$proxy_protocol_addr在http和stream block中記錄對應的日誌,如下所示:###http { #... log_format combined '$proxy_protocol_addr - $remote_user [$time_local] ' '"$request" $status $body_bytes_sent ' '"$http_referer" "$http_user_agent"'; }
stream { #... log_format basic '$proxy_protocol_addr - $remote_user [$time_local] ' '$protocol $status $bytes_sent $bytes_received ' '$session_time'; }
以上是nginx中怎麼設定使用proxy protocol協定的詳細內容。更多資訊請關注PHP中文網其他相關文章!