nginx的配置系統由一個主配置文件和其他一些輔助的配置文件構成。這些配置文件均是純文本文件，全部位於nginx安裝目錄下的conf目錄下。

配置文件中以#開始的行，或者是前面有若幹空格或者TAB，然後再跟#的行，都被認為是註釋，也就是只對編輯查看文件的用戶有意義，程序在讀取這些註釋行的時候，其實際的內容是被忽略的。

由於除主配置文件nginx.conf以外的文件都是在某些情況下才使用的，而只有主配置文件是在任何情況下都被使用的。所以在這裏我們就以主配置文件為例，來解釋nginx的配置系統。

在nginx.conf中，包含若幹配置項。每個配置項由配置指令和指令參數2個部分構成。指令參數也就是配置指令對應的配置值。

指令概述

配置指令是一個字符串，可以用單引號或者雙引號括起來，也可以不括。但是如果配置指令包含空格，一定要引起來。

指令參數

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

TOKEN串分為簡單字符串或者是復合配置塊。復合配置塊即是由大括號括起來的一堆內容。一個復合配置塊中可能包含若幹其他的配置指令。

如果一個配置指令的參數全部由簡單字符串構成，也就是不包含復合配置塊，那麽我們就說這個配置指令是一個簡單配置項，否則稱之為復雜配置項。例如下面這個是一個簡單配置項：

error_page   500 502 503 504  /50x.html;

對於簡單配置，配置項的結尾使用分號結束。對於復雜配置項，包含多個TOKEN串的，一般都是簡單TOKEN串放在前面，復合配置塊一般位於最後，而且其結尾，並不需要再添加分號。例如下面這個復雜配置項：

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

指令上下文

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

當前nginx支持的幾個指令上下文：

指令上下文，可能有包含的情況出現。例如：通常http上下文和mail上下文一定是出現在main上下文裏的。在一個上下文裏，可能包含另外一種類型的上下文多次。例如：如果http服務，支持了多個虛擬主機，那麽在http上下文裏，就會出現多個server上下文。

我們來看一個示例配置：

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;
    }
}

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

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

• user
• worker_processes
• error_log
• events
• http
• mail

存在於http上下文中的指令如下:

• server

存在於mail上下文中的指令如下：

• server
• auth_http
• imap_capabilities

存在於server上下文中的配置指令如下：

• listen
• server_name
• access_log
• location
• protocol
• proxy
• smtp_auth
• xclient

存在於location上下文中的指令如下：

• index
• root

當然，這裏只是一些示例。具體有哪些配置指令，以及這些配置指令可以出現在什麽樣的上下文中，需要參考nginx的使用文檔。

nginx的配置系統