Nginx應用-Location路由反向代理及重寫策略請求轉發-URL匹配規則 NGINX Reverse Proxy

NGINX Docs | NGINX Reverse Proxy https://docs.nginx.com/nginx/admin-guide/web-server/reverse-proxy/

NGINX Reverse Proxy

nginx反向代理（請求轉發-URL匹配規則） - 周XX - 博客園 https://www.cnblogs.com/zhouXX/p/7215316.html

nginx 作為目前最流行的web服務器之一，可以很方便地實現反向代理。

當在一台主機上部署了多個不同的web服務器，並且需要能在80端口同時訪問這些web服務器時，可以使用 nginx 的反向代理功能: 用 nginx在80端口監聽所有請求，並依據轉發規則(比較常見的是以 URI 來轉發)轉發到對應的web服務器上。

例如有 webmail , webcom 以及 webdefault 三個服務器分別運行在 portmail , portcom , portdefault 端口，要實現從80端口同時訪問這三個web服務器，則可以在80端口運行 nginx，然后將 /mail 下的請求轉發到 webmail 服務器，將 /com下的請求轉發到 webcom 服務器，將其他所有請求轉發到 webdefault 服務器。

假設服務器域名為example.com，則對應的 nginx http配置如下：

需要注意的是，在以上的配置中，webdefault 的代理服務器設置是沒有指定URI的，而 webmail 和 webcom 的代理服務器設置是指定了URI的(分別為 / 和 /main/)。
如果代理服務器地址中是帶有URI的，此URI會替換掉 location 所匹配的URI部分。
而如果代理服務器地址中是不帶有URI的，則會用完整的請求URL來轉發到代理服務器。

Nginx應用-Location路由反向代理及重寫策略 – 嗨！大佟！ http://www.qmailer.net/archives/249.html

一、Nginx的反向代理的路由策略

Nginx是著名的高性能Web服務器，應用在很多Web服務領域，同時開發和部署過程中，為了更好的控制接口API（或是WebService），我們需要嚴格的或是謹慎的規划URL的使用，這樣才能為以后的擴張、迭代打下良好的基礎，否則雜亂無章的URL使用，將是以后大規模擴展的噩夢。

Location的配置
語法規則：

 
                 location [=|~|~*|^~] /uri/ {…}

語法說明：

 
                 =   開頭表示精確匹配，不支持正則。 
                
                 ^~  開頭表示uri以某個常規字符串開頭，不支持正則，理解為匹配url路徑即可。nginx不對url做編碼，因此請求為/static/20%/aaa，可以被規則^~ /static/ /aaa匹配到（注意是空格）。 
                
                 ~和~* 開頭表示區分大小寫的和不區分大小寫的正則匹配。 
                
                 !~和!~* 開頭表示區分大小寫不匹配及不區分大小寫不匹配的正則匹配。 
                
                 / 通用匹配，任何請求都會匹配，通常放着配置的最后。

匹配優先級：

 
                 (1). 優先嘗試 全匹配( 也就是前綴 =) 
                
                 (2). 嘗試 路徑匹配 （ 也就是前綴 ^~） 
                
                 (3). 嘗試 正則匹配 （ 也就是前綴 ~* 或者 ~） 
                
                 (4). 字符串匹配 （也就是前綴為空） 
                
                 所以，前綴的優先級概括為： 
                
                 = > ^~ > ~, ~* > 空 
                
                 全匹配 > 路徑匹配 > 正則匹配 > 字符串匹配

示例：

 
                 # 字符串匹配 
                
                 location /static { 
                
                 alias  /home/www/static; 
                
                 access_log off; 
                
                 } 
                
                 # 路徑匹配，此時proxy_pass的結束 / 決定是否帶上匹配的路徑 
                
                 location ^~ /333/ { 
                
                 proxy_pass http://106.185.48.229/; 
                
                 } 
                
                 # 正則匹配，此時proxy_pass不能帶結束 / 
                
                 location ~ ^/(xxx|yyy)/ { 
                
                 proxy_pass http://106.185.48.229; 
                
                 } 
                
                 # 字符串匹配，此時proxy_pass的結束 / 決定是否帶上匹配得路徑 
                
                 location /zzz/ { 
                
                 proxy_pass http://106.185.48.229/; 
                
                 } 
                
                 # 默認匹配 
                
                 location / { 
                
                 proxy_pass http://127.0.0.1:8080; 
                
                 }

二、Nginx的Rewrite規則

語法規則：

 
                 rewrite 正則 替換 標志位

rewrite指令的最后一項參數為flag標記，flag標記有：

 
                 1.last   last是終止當前location的rewrite檢測,但會繼續重試location匹配並處理區塊中的rewrite規則。 
                
                 2.break  break是終止當前location的rewrite檢測,而且不再進行location匹配。 
                
                 3.redirect  返回302臨時重定向，瀏覽器地址會顯示跳轉后的URL地址。 
                
                 4.permanent  返回301永久重定向，瀏覽器地址會顯示跳轉后的URL地址。

示例：

 
                 # 正則匹配 
                
                 location ~ ^/(a|bb|ccc)/ { 
                
                 rewrite ^/([a-z]+)/(.*)$ http://106.185.48.229/$2?$1; 
                
                 } 
                
                 # 注：用括號括起來的參數為后面的 $1 $2 變量

三、Nginx常用設置

1.為了便於日志統計和分析，備注一個日志示例格式，供參考

 
                 log_format main '$time_iso8601|$remote_addr|$remote_user|$request_method|$uri|' 
                
                 '$status|$request_time|$request_length|$body_bytes_sent|$bytes_sent|' 
                
                 '$connection|$http_x_forwarded_for|$upstream_addr|$upstream_status|' 
                
                 '$upstream_response_time|$args|$http_referer|$http_user_agent'; 
                
                 access_log  logs/access.log  main;

2. 反向代理透傳客戶端IP設置

 
                 proxy_set_header Host $http_host; 
                
                 proxy_set_header X-Real-IP $remote_addr; 
                
                 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

3.常用的Nginx全局變量

 
                 $args #這個變量等於請求行中的參數。 
                
                 $content_length #請求頭中的Content-length字段。 
                
                 $content_type #請求頭中的Content-Type字段。 
                
                 $document_root #當前請求在root指令中指定的值。 
                
                 $host #請求主機頭字段，否則為服務器名稱。 
                
                 $http_user_agent #客戶端agent信息 
                
                 $http_cookie #客戶端cookie信息 
                
                 $limit_rate #這個變量可以限制連接速率。 
                
                 $request_body_file #客戶端請求主體信息的臨時文件名。 
                
                 $request_method #客戶端請求的動作，通常為GET或POST。 
                
                 $remote_addr #客戶端的IP地址。 
                
                 $remote_port #客戶端的端口。 
                
                 $remote_user #已經經過Auth Basic Module驗證的用戶名。 
                
                 $request_filename #當前請求的文件路徑，由root或alias指令與URI請求生成。 
                
                 $query_string #與$args相同。 
                
                 $scheme #HTTP方法（如http，https）。 
                
                 $server_protocol #請求使用的協議，通常是HTTP/1.0或HTTP/1.1。 
                
                 $server_addr #服務器地址，在完成一次系統調用后可以確定這個值。 
                
                 $server_name #服務器名稱。 
                
                 $server_port #請求到達服務器的端口號。 
                
                 $request_uri #包含請求參數的原始URI，不包含主機名，如：”/foo/bar.php?arg=baz”。 
                
                 $uri #不帶請求參數的當前URI，$uri不包含主機名，如”/foo/bar.html”。 
                
                 $document_uri #與$uri相同。

    server {
        listen       80 default_server;
        listen       [::]:80 default_server;
        server_name  _;
        root         /usr/share/nginx/html;

        # Load configuration files for the default server block.
        include /etc/nginx/default.d/*.conf;

location /api/ {
        proxy_pass http://apiServerHost:8002/api/;
}


        location / {
        }

        error_page 404 /404.html;
            location = /40x.html {
        }

        error_page 500 502 503 504 /50x.html;
            location = /50x.html {
        }
    }

瀏覽器端訪問網站A的所有的請求均被指向網頁服務器webServer

Request URL: http://webServer/9.js

Request URL: http://webServer/static/fonts/element-icons.2fad952a.woff

Request URL: http://webServer/api/cloud-resource-ecs/describe-instances/

網頁服務器webServer端
/api/cloud-resource-ecs/describe-instances/
/api/cloud-resource-shell/describe-commands/

通過Nginx將瀏覽器/api/請求做url透明轉發，不修改url
Using the URLconf defined in config.urls, Django tried these URL patterns, in this order:
注意

訪問http://webServer/api/，
Using the URLconf defined in config.urls, Django tried these URL patterns, in this order:

^api/ ^^user/modify-user-list/$ [name='user-modify-user-list']
^api/ ^^user/register/$ [name='user-register']
^api/ ^^cloud-resource-ecs/allocate-public-ip-address/$ [name='ecs-allocate-public-ip-address']
^api/ ^^cloud-resource-ecs/create-instance/$ [name='ecs-create-instance']

即瀏覽器端會暴露api接口服務端的調試信息。

nginx反向代理中數據是透明的。

server {
    listen 9000 default_server;
        root /usr/share/nginx/mobile;


        location /api/ {
                # proxy_set_header Host  $host;
                proxy_set_header X-Real-IP $remote_addr;
                proxy_pass http://127.0.0.1:8002/api/;
        }
        location /testngx/ {
                # proxy_set_header Host  $host;
                proxy_set_header X-Real-IP $remote_addr;
                proxy_pass http://127.0.0.1:9000/;
        }


}

:9000/testngx/#/about

same

:9000/#/about

api standard

server {
    listen 9000 default_server;
        root /usr/share/nginx/mobile;


        location /api/ {
                # proxy_set_header Host  $host;
                proxy_set_header X-Real-IP $remote_addr;
                proxy_pass http://127.0.0.1:8002/api/;
        }
        location /testngx/ {
                # proxy_set_header Host  $host;
                proxy_set_header X-Real-IP $remote_addr;
                proxy_pass http://127.0.0.1:9000/;
        }
        location /testapi/ {
                # proxy_set_header Host  $host;
                proxy_set_header X-Real-IP $remote_addr;
                proxy_pass http://apiServer/;
        }

}