Nginx配置文件結構。

下面是一個示例Nginx.conf文件，其中包含一些常見的指令塊：

# the number of worker processes to use
worker_processes 4;

# include additional configuration files
include /etc/nginx/conf.d/*.conf;

http {
  # HTTP server settings
  server {
    # listen on port 80
    listen 80;

    # server name
    server_name www.example.com;

    # default location
    location / {
      # root directory
      root /var/www/html;

      # index file
      index index.html;
    }
  }
}

在此示例中：

• worker_processes：指令指定Nginx應使用的工作進程數。

• include：指令用于包含其他配置文件。

• server：塊包含特定服務器的設置。

• location：塊指定默認位置的設置，即服務器的根URL。

了解更多的指令詳細信息，請參見Nginx官方文檔。

接下來，我們將概述在Nginx配置文件中最關鍵的幾個部分。

指令塊

HTTP塊

HTTP塊在Nginx配置文件中定義了HTTP服務器的全局配置參數。這些參數包括運行的工作進程的數量、允許的最大連接數、日志記錄的細節等。以下是一個Nginx配置文件中HTTP塊的示例：

http {
    worker_processes 4;  
    worker_rlimit_nofile 8192; 
    client_max_body_size 128m; 

    access_log /var/log/nginx/access.log; 
    error_log /var/log/nginx/error.log; 

    server {
        ...
    }
}

在該示例中，HTTP塊設定了工作進程的數量、文件描述符的最大數量以及客戶端請求允許的最大正文大小。它還指定了訪問和錯誤日志的位置，并且該HTTP塊內嵌了一個server塊，用于指定Web服務器的配置。

Server塊

在Nginx配置中，Server塊用于定義特定域名或一組域名的流量請求處理規則。允許您為同一服務器上托管的多個網站或應用程序定義不同的設置和行為。

以下是Nginx配置文件中服務器塊的示例：

server {
    listen 80;
    server_name www.example.com;

    location / {
        root /var/www/html/example;
        index index.html index.htm;
    }

    location /app {
        proxy_pass http://localhost:3000;
    }

    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
        root /usr/share/nginx/html;
    }
}

在此示例中，服務器只處理端口80上www.example.com域的未加密流量。

• listen指定服務器應偵聽端口80上的傳入連接。

• server_name指定此服務器塊應處理的域名。

• listen和server_name一起使用來定義服務器應該偵聽和處理流量的域和端口。

server_name指令

指定虛擬主機域名。

server_name name1 name2 name3

# example：
server_name www.example.com;

域名匹配的四種寫法：

• 精確匹配：server_name www.example.com

• 左側通配：server_name *.example.com

• 右側統配：server_name www.example.*

• 正則匹配：server_name ~^www\.example\.*$

匹配優先級：精確匹配 > 左側通配符匹配 > 右側通配符匹配 > 正則表達式匹配。

Location塊

在Nginx中，Location塊是用來定義服務器對于特定URL路徑或URL模式的請求處理規則。允許您根據網站或應用程序的不同部分定義不同的行為，如為特定目錄提供靜態文件，或將請求代理到另一臺服務器。

以下是Nginx配置文件中位置塊的示例：

server {
    ...

    location / {
        root /var/www/html/example;
        index index.html index.htm;
    }

    location /app {
        proxy_pass http://localhost:3000;
    }

    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
        root /usr/share/nginx/html;
    }
}

在此例子中：

• / 的位置塊指定應通過提供/var/www/html/example目錄中的文件來處理對網站根URL的請求。

• /app的位置塊指定對/appURL的請求應代理到端口3000上的localhost。

• /50x.html的位置塊指定服務器應如何通過提供特定文件來處理服務器錯誤。

在Nginx中，當存在多個location塊時，請求的處理將根據location的匹配規則和優先級被第一個相匹配的location塊捕獲并處理。

語法拼接：

• location [ = | ~ | ~* | ^~ ] uri { ... }

• location @name { ... }

匹配優先級： = > ^~ > ~ > ~* > 不帶任何字符。

參考示例如下：

# 通用的默認匹配，所有未匹配location的都會匹配此種匹配；
location = / {
}
# 前綴匹配
location ^~ /xx/ {
     # 匹配任何以 /xx/ 開頭的請求并且停止搜索。
}
# 不帶正則描述的前綴匹配；
location  /uri {
}

location / {
     # 匹配任何查詢，因為所有請求都已 / 開頭。但是正則表達式規則和長的塊規則將被優先和查詢匹配。
}

# 正則匹配
location ~*.(gif|jpg|jpeg)$ {
     # 匹配任何已 gif、jpg 或 jpeg 結尾的請求。
}

Nginx Ingress會將Host下多個Ingress path按長度降序進行排序。了解更多詳情，請參見Ingress路徑匹配和Nginx的服務器和位置塊選擇算法。

指令繼承和覆蓋

在Nginx配置中，指令遵循從外到內的繼承機制，位于內部的子上下文會從其外層的父上下文中繼承配置指令。例如，在http{}上下文中設置的指令會被所有嵌套于其下的server{}和location{}上下文所繼承，同樣，server{}上下文中的指令會被它所包含的所有location{}上下文繼承。需要注意的是，當同一個指令在父子上下文中均被定義時，子上下文中的配置將覆蓋父上下文中的相應設置，而不是疊加。

參考示例如下：

http {
    add_header X-HTTP-LEVEL-HEADER 1;
    add_header X-ANOTHER-HTTP-LEVEL-HEADER 1;

    server {
        listen 8080;
        location / {
            return 200 "OK";
        } 
    }

    server {
        listen 8081;
        add_header X-SERVER-LEVEL-HEADER 1;

        location / {
            return 200 "OK";
        }

        location /test {
            add_header X-LOCATION-LEVEL-HEADER 1;
            return 200 "OK";
        }

        location /correct {
            add_header X-HTTP-LEVEL-HEADER 1;
            add_header X-ANOTHER-HTTP-LEVEL-HEADER 1;

            add_header X-SERVER-LEVEL-HEADER 1;
            add_header X-LOCATION-LEVEL-HEADER 1;
            return 200 "OK";
        } 
    }
}

Nginx的反向代理配置

proxy_pass指令

Nginx反向代理配置使得Nginx作為代理服務器運行，它監聽客戶端請求并將其轉發至一個或多個后端服務器。這使得Nginx能夠接收請求并將其路由至合適的后端服務進行處理。配置Nginx反向代理，可以在Nginx配置中的位置塊中使用proxy_pass指令。

以下是配置Nginx反向代理的示例：

server {
    listen 80;
    server_name www.example.com;

    location / {
        proxy_pass http://localhost:3000;
    }
}

在此示例中，/的位置塊指定對www.example.com域的所有請求都應代理到端口3000上的本地主機。這意味著Nginx將接收的請求都將其轉發到在localhost上運行的服務器3000端口。

proxy_set_header指令

還可以使用proxy_set_header指令指定要添加到代理請求中的其他標頭。

請參考，示例如下：

server {
    listen 80;
    server_name www.example.com;

    location / {
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_pass http://localhost:3000;
    }
}

在此示例中，proxy_set_header指令指定應將Host和X-Real-IP標頭添加到代理請求中，并將傳入請求的主機名和發出請求的客戶端的IP地址分別設置為對應的值。這對于將傳入請求的信息傳遞到上游服務器非常有用。

Nginx常用指令

Nginx常用命令