ngx_http_proxy_module模塊

1、proxy_pass URL;Context:location, if in location, limit_except

注意：proxy_pass後面路徑不帶uri時，會將location的uri傳遞（附加）給後端主機

server {
    ...
    server_name HOSTNAME;
    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/

2、proxy_set_header field value；(Context: http, server, location)設定發往後端主機的請求報文的請求首部的值

    proxy_set_header X-Real-IP(變量，可以隨意定義) $remote_addr;

    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

請求報文的標準格式如下：

    X-Forwarded-For: client1, proxy1, proxy2

    注意：需要在後端服務器配置文件中的日誌模板添加該變量

    LogFormat "%{X-Real-IP}i %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" " combined

    LogFormat "%{X-Forwarded-For}i %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" " combined

3、proxy_cache_path;(Context:http)定義可用於proxy功能的緩存；

    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;Context:http,server, location

    默認off,指明調用的緩存，或關閉緩存機制；

5、proxy_cache_key string;

    緩存中用於“鍵”的內容 默認值： proxy_cache_key $scheme$proxy_host$request_uri;

6、proxy_cache_valid [code ...] time;

    定義對特定響應碼的響應內容的緩存時長定義在http{...}中

    示例:

        proxy_cache_valid 200 302 10m;

        proxy_cache_valid 404 1m;

    示例：

        在http配置定義緩存信息

            proxy_cache_path /var/cache/nginx/proxy_cache levels=1:1:1 keys_zone=proxycache:20m inactive=120s max_size=1g;

        調用緩存功能，需要定義在相應的配置段，如server{...}；

            proxy_cache proxycache;(keys_zone定義的name)

            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_stale error | timeout | invalid_header | updating | http_500 | http_502 | http_503 | http_504 | http_403 | http_404 | off ...

    在被代理的後端服務器出現哪種情況下，可以真接使用過期的緩存響應客戶端

8、proxy_cache_methods GET | HEAD | POST ...;

    對哪些客戶端請求方法對應的響應進行緩存，GET和HEAD方法總是被緩存

9、proxy_hide_header field;

    默認nginx在響應報文不傳遞後端服務器的首部字段Date, Server, X-Pad, X-Accel-等，用於隱藏後端服務器特定的響應首部

10、proxy_connect_timeout time;

    定義與後端服務器建立連接的超時時長，如超時會出現502錯誤，默認爲60s，一般不建議超出75s，

11、proxy_send_timeout time;

    將請求發送給後端服務器的超時時長；默認爲60s

12、proxy_read_timeout time;

    等待後端服務器發送響應報文的超時時長，默認爲60s