閱讀(33.4k) 書簽贊(3) 我要糾錯(cuò)

Nginx 的配置系統(tǒng)

2022-03-23 15:37 更新

Nginx 的配置系統(tǒng)由一個(gè)主配置文件和其他一些輔助的配置文件構(gòu)成。這些配置文件均是純文本文件，全部位于Nginx 安裝目錄下的 conf 目錄下。

配置文件中以#開始的行，或者是前面有若干空格或者 TAB，然后再跟#的行，都被認(rèn)為是注釋，也就是只對(duì)編輯查看文件的用戶有意義，程序在讀取這些注釋行的時(shí)候，其實(shí)際的內(nèi)容是被忽略的。

由于除主配置文件 nginx.conf 以外的文件都是在某些情況下才使用的，而只有主配置文件是在任何情況下都被使用的。所以在這里我們就以主配置文件為例，來(lái)解釋 Nginx 的配置系統(tǒng)。

在 nginx.conf 中，包含若干配置項(xiàng)。每個(gè)配置項(xiàng)由配置指令和指令參數(shù) 2 個(gè)部分構(gòu)成。指令參數(shù)也就是配置指令對(duì)應(yīng)的配置值。

指令概述

配置指令是一個(gè)字符串，可以用單引號(hào)或者雙引號(hào)括起來(lái)，也可以不括。但是如果配置指令包含空格，一定要引起來(lái)。

指令參數(shù)

指令的參數(shù)使用一個(gè)或者多個(gè)空格或者 TAB 字符與指令分開。指令的參數(shù)有一個(gè)或者多個(gè) TOKEN 串組成。TOKEN 串之間由空格或者 TAB 鍵分隔。

TOKEN 串分為簡(jiǎn)單字符串或者是復(fù)合配置塊。復(fù)合配置塊即是由大括號(hào)括起來(lái)的一堆內(nèi)容。一個(gè)復(fù)合配置塊中可能包含若干其他的配置指令。

如果一個(gè)配置指令的參數(shù)全部由簡(jiǎn)單字符串構(gòu)成，也就是不包含復(fù)合配置塊，那么我們就說(shuō)這個(gè)配置指令是一個(gè)簡(jiǎn)單配置項(xiàng)，否則稱之為復(fù)雜配置項(xiàng)。例如下面這個(gè)是一個(gè)簡(jiǎn)單配置項(xiàng)：

    error_page   500 502 503 504  /50x.html;

對(duì)于簡(jiǎn)單配置，配置項(xiàng)的結(jié)尾使用分號(hào)結(jié)束。對(duì)于復(fù)雜配置項(xiàng)，包含多個(gè) TOKEN 串的，一般都是簡(jiǎn)單 TOKEN 串放在前面，復(fù)合配置塊一般位于最后，而且其結(jié)尾，并不需要再添加分號(hào)。例如下面這個(gè)復(fù)雜配置項(xiàng)：

        location / {
            root   /home/jizhao/nginx-book/build/html;
            index  index.html index.htm;
        }

指令上下文

nginx.conf 中的配置信息，根據(jù)其邏輯上的意義，對(duì)它們進(jìn)行了分類，也就是分成了多個(gè)作用域，或者稱之為配置指令上下文。不同的作用域含有一個(gè)或者多個(gè)配置項(xiàng)。

當(dāng)前 Nginx 支持的幾個(gè)指令上下文：

main: Nginx 在運(yùn)行時(shí)與具體業(yè)務(wù)功能（比如http服務(wù)或者email服務(wù)代理）無(wú)關(guān)的一些參數(shù)，比如工作進(jìn)程數(shù)，運(yùn)行的身份等。
http: 與提供 http 服務(wù)相關(guān)的一些配置參數(shù)。例如：是否使用 keepalive 啊，是否使用gzip進(jìn)行壓縮等。
server: http 服務(wù)上支持若干虛擬主機(jī)。每個(gè)虛擬主機(jī)一個(gè)對(duì)應(yīng)的 server 配置項(xiàng)，配置項(xiàng)里面包含該虛擬主機(jī)相關(guān)的配置。在提供 mail 服務(wù)的代理時(shí)，也可以建立若干 server，每個(gè) server 通過(guò)監(jiān)聽(tīng)的地址來(lái)區(qū)分。
location: http 服務(wù)中，某些特定的URL對(duì)應(yīng)的一系列配置項(xiàng)。
mail: 實(shí)現(xiàn) email 相關(guān)的 SMTP/IMAP/POP3 代理時(shí)，共享的一些配置項(xiàng)（因?yàn)榭赡軐?shí)現(xiàn)多個(gè)代理，工作在多個(gè)監(jiān)聽(tīng)地址上）。

指令上下文，可能有包含的情況出現(xiàn)。例如：通常 http 上下文和 mail 上下文一定是出現(xiàn)在 main 上下文里的。在一個(gè)上下文里，可能包含另外一種類型的上下文多次。例如：如果 http 服務(wù)，支持了多個(gè)虛擬主機(jī)，那么在 http 上下文里，就會(huì)出現(xiàn)多個(gè) server 上下文。

我們來(lái)看一個(gè)示例配置：

    user  nobody;
    worker_processes  1;
    error_log  logs/error.log  info;

    events {
        worker_connections  1024;
    }

    http {  
        server {  
            listen          80;  
            server_name     www.linuxidc.com;  
            access_log      logs/linuxidc.access.log main;  
            location / {  
                index index.html;  
                root  /var/www/linuxidc.com/htdocs;  
            }  
        }  

        server {  
            listen          80;  
            server_name     www.Androidj.com;  
            access_log      logs/androidj.access.log main;  
            location / {  
                index index.html;  
                root  /var/www/androidj.com/htdocs;  
            }  
        }  
    }

    mail {
        auth_http  127.0.0.1:80/auth.php;
        pop3_capabilities  "TOP"  "USER";
        imap_capabilities  "IMAP4rev1"  "UIDPLUS";

        server {
            listen     110;
            protocol   pop3;
            proxy      on;
        }
        server {
            listen      25;
            protocol    smtp;
            proxy       on;
            smtp_auth   login plain;
            xclient     off;
        }
    }

在這個(gè)配置中，上面提到個(gè)五種配置指令上下文都存在。

存在于 main 上下文中的配置指令如下: