nginx代理

示意圖
#https://coding.net/u/aminglinux/p/nginx/git/blob/master/proxy/pic.md
Nginx正向代理
#https://coding.net/u/aminglinux/p/nginx/git/blob/master/proxy/z_proxy.md
Nginx反向代理
#https://coding.net/u/aminglinux/p/nginx/git/blob/master/proxy/f_proxy.md
#緩沖和緩存 https://coding.net/u/aminglinux/p/nginx/git/blob/master/proxy/bu_ca.md

Nginx正向代理配置

Nginx正向代理使用場景并不多見。
需求場景1：
如果在機房中，只有一臺機器可以聯網，其他機器只有內網，內網的機器想用使用yum安裝軟件包，在能能聯網的機器上配置一個正向代理即可。

Nginx正向代理配置文件

server {
listen 80 default_server;
resolver 119.29.29.29;
location /
{
proxy_pass http://$host$request_uri;
}
}

Nginx正向代理配置執行說明

resolver

語法：resolver address;

address為DNS服務器的地址，國內通用的DNS 119.29.29.29為dnspod公司提供。 國際通用DNS 8.8.8.8或者8.8.4.4為google提供。
其他可以參考 http://dns.lisect.com/

示例：resolver 119.29.29.29;

default_server

之所以要設置為默認虛擬主機，是因為這樣就不用設置server_name了，任何域名解析過來都可以正常訪問。

proxy_pass

該指令用來設置要代理的目標url，正向代理服務器設置就保持該固定值即可。關于該指令的詳細解釋在反向代理配置中。

我們線上用到的正向代理proxy_pass 后面加的是一個具體的接口地址，內網環境只用來訪問這個內網地址如下圖

Nginx反向代理配置

Nginx反向代理在生產環境中使用很多的。

場景1：
域名沒有備案，可以把域名解析到香港一臺云主機上，在國外云主機做個代理，而網站數據是在大陸的服務器上。

示例1：
server
{
listen 80;
server_name aminglinux.com;

location /
{
    proxy_pass http://123.23.13.11/;
    proxy_set_header Host   $host;
    proxy_set_header X-Real-IP      $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

}

配置說明

1. proxy_pass

在正向代理中，已經使用過該指令。
格式很簡單： proxy_pass URL;
其中URL包含：傳輸協議（http://, https://等）、主機名（域名或者IP:PORT）、uri。

示例如下：
proxy_pass http://www.aminglinux.com/;
proxy_pass http://192.168.200.101:8080/uri;
proxy_pass unix:/tmp/www.sock;

對于proxy_pass的配置有幾種情況需要注意。
示例2：
location /aming/
{
proxy_pass http://192.168.1.10;
...
}

示例3：
location /aming/
{
proxy_pass http://192.168.1.10/;
...
}

示例4：
location /aming/
{
proxy_pass http://192.168.1.10/linux/;
...
}

示例5：
location /aming/
{
proxy_pass http://192.168.1.10/linux;
...
}

假設server_name為www.aminglinux.com
當請求http://www.aminglinux.com/aming/a.html的時候，以上示例2-5分別訪問的結果是

示例2：http://192.168.1.10/aming/a.html

示例3：http://192.168.1.10/a.html

示例4：http://192.168.1.10/linux/a.html

示例5：http://192.168.1.10/linuxa.html

2. proxy_set_header

proxy_set_header用來設定被代理服務器接收到的header信息。

語法：proxy_set_header field value;
field為要更改的項目，也可以理解為變量的名字，比如host
value為變量的值

如果不設置proxy_set_header，則默認host的值為proxy_pass后面跟的那個域名或者IP（一般寫IP），
比如示例4，請求到后端的服務器上時，完整請求uri為：http://192.168.1.10/linux/a.html

如果設置proxy_set_header，如 proxy_set_header host $host;
比如示例4，請求到后端的服務器完整uri為：http://www.aminglinux.com/linux/a.html

proxy_set_header X-Real-IP $remote_addr;和proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
用來設置被代理端接收到的遠程客戶端IP，如果不設置，則header信息中并不會透傳遠程真實客戶端的IP地址。
可以用如下示例來測試：

示例6(被代理端)
server{
listen 8080;
server_name www.aminglinux.com;
root /tmp/123.com_8080;
index index.html;
location /linux/ {
echo "$host";
echo $remote_addr;
echo $proxy_add_x_forwarded_for;
}
}

示例7（代理服務器上）
server {
listen 80;
server_name www.aminglinux.com;

location /aming/
{
proxy_pass http://192.168.1.10:8080/linux/;
proxy_set_header host $host;
proxy_set_header X-Real-IP      $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

}

3. proxy_redirect

該指令用來修改被代理服務器返回的響應頭中的Location頭域和“refresh”頭域。
語法結構為：
proxy_redirect redirect replacement;
proxy_redirect default;
proxy_redirect off;

示例8：
server {
listen 80;
server_name www.aminglinux.com;
index index.html;

location /
{
proxy_pass http://127.0.0.1:8080;
proxy_set_header host $host;
proxy_set_header X-Real-IP      $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

}

當請求的鏈接為 http://www.aminglinux.com/aming
結果會返回301，定向到了 http://www.aminglinux.com:8080/aming/

注意：返回301有幾個先決條件

1. location后面必須是/;
2. proxy_pass后面的URL不能加uri,只能是IP或者IP:port結尾，并不能以/結尾；
3. 訪問的uri必須是一個真實存在的目錄，如，這里的aming必須是存在的
4. 訪問的時候，不能以/結尾，只能是 www.aminglinux.com/aming

雖然，這4個條件挺苛刻，但確實會遇到類似的請求。解決方法是，加一行proxy_redirect http://$host:8080/ /;

示例9：
server {
listen 80;
server_name www.aminglinux.com;
index index.html;

location /
{
proxy_pass http://127.0.0.1:8080;
proxy_set_header host $host;
proxy_redirect http://$host:8080/ /;
proxy_set_header X-Real-IP      $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

}

nginx的proxy_buffering和proxy_cache

兩個都是nginx代理中內存設置相關的參數。

proxy_buffering設置

proxy_buffering主要是實現被代理服務器的數據和客戶端的請求異步。
為了方便理解，我們定義三個角色，A為客戶端，B為代理服務器，C為被代理服務器。

當proxy_buffering開啟，A發起請求到B，B再到C，C反饋的數據先到B的buffer上，
然后B會根據proxy_busy_buffer_size來決定什么時候開始把數據傳輸給A。在此過程中，如果所有的buffer被寫滿，
數據將會寫入到temp_file中。

相反，如果proxy_buffering關閉，C反饋的數據實時地通過B傳輸給A。

以下配置，都是針對每一個http請求的。

1. proxy_buffering on;
   該參數設置是否開啟proxy的buffer功能，參數的值為on或者off。
   如果這個設置為off，那么proxy_buffers和proxy_busy_buffers_size這兩個指令將會失效。
   但是無論proxy_buffering是否開啟，proxy_buffer_size都是生效的

2. proxy_buffer_size 4k;
   該參數用來設置一個特殊的buffer大小的。
   從被代理服務器（C）上獲取到的第一部分響應數據內容到代理服務器（B）上，通常是header，就存到了這個buffer中。
   如果該參數設置太小，會出現502錯誤碼，這是因為這部分buffer不夠存儲header信息。建議設置為4k。

3. proxy_buffers 8 4k;
   這個參數設置存儲被代理服務器上的數據所占用的buffer的個數和每個buffer的大小。
   所有buffer的大小為這兩個數字的乘積。

4. proxy_busy_buffer_size 16k;
   在所有的buffer里，我們需要規定一部分buffer把自己存的數據傳給A，這部分buffer就叫做busy_buffer。
   proxy_busy_buffer_size參數用來設置處于busy狀態的buffer有多大。

對于B上buffer里的數據何時傳輸給A，我個人的理解是這樣的：
1）如果完整數據大小小于busy_buffer大小，當數據傳輸完成后，馬上傳給A；
2）如果完整數據大小不少于busy_buffer大小，則裝滿busy_buffer后，馬上傳給A；

5. proxy_temp_path
   語法：proxy_temp_path path [level1 level2 level3]
   定義proxy的臨時文件存在目錄以及目錄的層級。

例：proxy_temp_path /usr/local/nginx/proxy_temp 1 2;
其中/usr/local/nginx/proxy_temp為臨時文件所在目錄，1表示層級1的目錄名為一個數字(0-9),2表示層級2目錄名為2個數字(00-99)

6. proxy_max_temp_file_size
   設置臨時文件的總大小，例如 proxy_max_temp_file_size 100M;

7. proxy_temp_file_wirte_size
   設置同時寫入臨時文件的數據量的總大小。通常設置為8k或者16k。

proxy_buffer示例

server
{
listen 80;
server_name www.aminglinux.com;
proxy_buffering on;
proxy_buffer_size 4k;
proxy_buffers 2 4k;
proxy_busy_buffers_size 4k;
proxy_temp_path /tmp/nginx_proxy_tmp 1 2;
proxy_max_temp_file_size 20M;
proxy_temp_file_write_size 8k;

location /
{
    proxy_pass      http://192.168.10.110:8080/;
    proxy_set_header Host   $host;
    proxy_set_header X-Real-IP      $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

}

}

proxy_cache設置

proxy_cache將從C上獲取到的數據根據預設規則存放到B上（內存+磁盤）留著備用，
A請求B時，B會把緩存的這些數據直接給A，而不需要再去向C去獲取。

proxy_cache相關功能生效的前提是，需要設置proxy_buffering on;

proxy_cache主要參數

1. proxy_cache
   語法：proxy_cache zone|off

默認為off，即關閉proxy_cache功能，zone為用于存放緩存的內存區域名稱。
例：proxy_cache my_zone;

從nginx 0.7.66版本開始，proxy_cache機制開啟后會檢測被代理端的HTTP響應頭中的"Cache-Control"、"Expire"頭域。
如，Cache-Control為no-cache時，是不會緩存數據的。

2. proxy_cache_bypass
   語法：proxy_cache_bypass string;

該參數設定，什么情況下的請求不讀取cache而是直接從后端的服務器上獲取資源。
這里的string通常為nginx的一些變量。

例：proxy_cahce_bypass $cookie_nocache $arg_nocache$arg_comment;
意思是，如果$cookie_nocache $arg_nocache$arg_comment這些變量的值只要任何一個不為0或者不為空時，
則響應數據不從cache中獲取，而是直接從后端的服務器上獲取。

3. proxy_no_cache
   語法：proxy_no_cache string;

該參數和proxy_cache_bypass類似，用來設定什么情況下不緩存。

例：proxy_no_cache $cookie_nocache $arg_nocache $arg_comment;
表示，如果$cookie_nocache $arg_nocache $arg_comment的值只要有一項不為0或者不為空時，不緩存數據。

4. proxy_cache_key
   語法：proxy_cache_key string;

定義cache key，如： proxy_cache_key $scheme$proxy_host$uri$is_args$args; （該值為默認值，一般不用設置）

5. proxy_cache_path
   語法：proxy_cache_path path [levels=levels] keys_zone=name:size [inactive=time] [max_size=size]

path設置緩存數據存放的路徑；

levels設置目錄層級，如levels=1:2，表示有兩級子目錄,第一個目錄名取md5值的倒數第一個值，第二個目錄名取md5值的第2和3個值。如下圖：

image

keys_zone設置內存zone的名字和大小，如keys_zone=my_zone:10m

inactive設置緩存多長時間就失效，當硬盤上的緩存數據在該時間段內沒有被訪問過，就會失效了，該數據就會被刪除，默認為10s。

max_size設置硬盤中最多可以緩存多少數據，當到達該數值時，nginx會刪除最少訪問的數據。

例：proxy_cache_path /data/nginx_cache/ levels=1:2 keys_zone=my_zone:10m inactive=300s max_size=5g

proxy_cache示例

http
{
...;

proxy_cache_path /data/nginx_cache/ levels=1:2 keys_zone=my_zone:10m inactive=300s max_size=5g;

...;

server
{
    listen 80;
    server_name www.aminglinux.com;
    proxy_buffering on;
    proxy_buffer_size 4k;
    proxy_buffers 2 4k;
    proxy_busy_buffers_size 4k;
    proxy_temp_path /tmp/nginx_proxy_tmp 1 2;
    proxy_max_temp_file_size 20M;
    proxy_temp_file_write_size 8k;

    location /
    {
        proxy_cache my_zone;
        proxy_pass      http://192.168.10.110:8080/;
        proxy_set_header Host   $host;
        proxy_set_header X-Real-IP      $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

    }

}

}

說明：核心配置為proxy_cache_path那一行。