ngx_http_proxy_module

模組功能

轉發請求至另一臺主機

1、proxy_pass URL; 
    可用位置：location, if in location, limit_except 
    注意：proxy_pass後面路徑不帶uri時，會將location的uri傳遞（附加）給後端主機 
    server { 
        ... 
        server_name HOSTNAME; 
        root PATH；
        location /uri/ { 
            proxy_pass http://host[:port]; 最後沒有/  
        } 
        ...
 
 
    }
    上面示例： 
        http://HOSTNAME/uri
            --> http://host/uri 
        如果上面示例中有/，即：http://host[:port]/
        意味著：http://HOSTNAME/uri 
                 --> http://host/ #即置換 注意這裡容易踩坑

    proxy_pass後面的路徑是一個uri時，其會將location的uri替換為proxy_pass的uri 
    server { 
        ... 
        server_name HOSTNAME; 
        location /uri/ { 
            proxy_pass http://host/new_uri/;
        } 
        ...
 

    }
    http://HOSTNAME/uri/ --> http://host/new_uri/

    如果location定義其uri時使用了正則表示式的模式，則proxy_pass之後必須不能使用uri; 使用者請求時傳遞的uri將直接附加至後端伺服器之後 
    server { 
        ...
        server_name HOSTNAME; 
        location ~|~* /uri/ {  
            proxy_pass http://host; 不能加/
        } 
        ...
    }
    http://HOSTNAME/uri/ --> http://host/uri/

2
 
、proxy_set_header field value; 
    設定發往後端主機的請求報文的請求首部的值 
    可用位置：http, server, location 

    示例1：
    server{
        listen 80;
        server_name www.c.com;
        root /data/web3/;
        access_log  /data/logs/nginx2-access.log  main;
        location / {
                proxy_pass http://192.168.109.111;
                proxy_set_header X-Real-IP $proxy_add_x_forwarded_for; ####
        }
    }
    目標主機日誌記錄修改：
        LogFormat "%{X-Real-IP}i %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined

    示例2：
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        請求報文的標準格式如下：X-Forwarded-For: client1, proxy1, proxy2
        LogFormat "%{X-Forwarded-For}i %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined


3、proxy_cache_path; 
    定義可用於proxy功能的快取；
    可用位置：http 
    proxy_cache_path path [levels=levels] [use_temp_path=on|off] keys_zone=name:size[inactive=time] [max_size=size] [manager_files=number] [manager_sleep=time] [manager_threshold=time] [loader_files=number] [loader_sleep=time] [loader_threshold=time] [purger=on|off] [purger_files=number] [purger_sleep=time] [purger_threshold=time];

4、proxy_cache zone | off;   
    預設off指明呼叫的快取，或關閉快取機制；
    可用位置：http, server, location

5、proxy_cache_key string; 
    快取中用於“鍵”的內容預設值：proxy_cache_key $scheme $proxy_host $request_uri;
    可用位置：http, server, location

6、proxy_cache_valid [code ...] time; 
    定義對特定響應碼的響應內容的快取時長 
    定義在http{...}中 
    可用位置：http, server, location
    示例:
    proxy_cache_valid200 302 10m; 

示例：在http配置定義快取信
    proxy_cache_path /var/cache/nginx/proxy_cache levels=1:2:2 keys_zone=proxycache:20m inactive=120s max_size=1g; 
    呼叫快取功能，需要定義在相應的配置段，如server{...}；
    proxy_cache proxycache;
    proxy_cache_key $request_uri; 
    proxy_cache_valid 200 302 301 1h; 
    proxy_cache_valid any 1m;

7、proxy_cache_use_stale; 
    proxy_cache_use_staleerror | timeout | invalid_header| updating | http_500 | http_502 | http_503 | http_504 | http_403 | http_404 | off ... 
    在被代理的後端伺服器出現哪種情況下，可以真接使用過期的快取響應客戶端
    可用位置：http, server, location

8、proxy_cache_methods GET | HEAD | POST ...; 
    對哪些客戶端請求方法對應的響應進行快取，GET和HEAD方法總是被快取
    可用位置：http, server, location

9、proxy_hide_header field; 
    預設nginx在響應報文不傳遞後端伺服器的首部欄位Date, Server, X-Pad,  X-Accel-等，用於隱藏後端伺服器特定的響應首部
    可用位置：http, server, location

10、proxy_connect_timeout time; 
    定義與後端伺服器建立連線的超時時長，如超時會出現502錯誤，預設為60s，一般不建議超出75s，
    可用位置：http, server, location

11、proxy_send_timeout time; 
    將請求傳送給後端伺服器的超時時長；預設為60s
    可用位置：http, server, location

12、proxy_read_timeout time; 
    等待後端伺服器傳送響應報文的超時時長，預設為60s
    可用位置：http, server, location

ngx_http_proxy_module模組 詳細說明請參考官網 地址連結