# 3.3 Nginx配置系統
Nginx的配置系統由一個主配置文件和一些輔助配置文件構成,這些配置文件默認在`/usr/local/nginx/`目錄下。
nginx的配置系統由一個主配置文件和其他一些輔助的配置文件構成。這些配置文件均是純文本文件,全部位于nginx安裝目錄下的conf目錄下。
配置文件中以#開始的行,或者是前面有若干空格或者TAB,然后再跟#的行,都被認為是注釋,也就是只對編輯查看文件的用戶有意義,程序在讀取這些注釋行的時候,其實際的內容是被忽略的。
由于除主配置文件nginx.conf以外的文件都是在某些情況下才使用的,而只有主配置文件是在任何情況下都被使用的。所以在這里我們就以主配置文件為例,來解釋nginx的配置系統。
在nginx.conf中,包含若干配置項。每個配置項由配置指令和指令參數2個部分構成。指令參數也就是配置指令對應的配置值。
### 指令概述
配置指令是一個字符串,可以用單引號或者雙引號括起來,也可以不括。但是如果配置指令包含空格,一定要引起來。
### 指令參數
指令的參數使用一個或者多個空格或者TAB字符與指令分開。指令的參數有一個或者多個TOKEN串組成。TOKEN串之間由空格或者TAB鍵分隔。
TOKEN串分為簡單字符串或者是復合配置塊。復合配置塊即是由大括號括起來的一堆內容。一個復合配置塊中可能包含若干其他的配置指令。
如果一個配置指令的參數全部由簡單字符串構成,也就是不包含復合配置塊,那么我們就說這個配置指令是一個簡單配置項,否則稱之為復雜配置項。例如下面這個是一個簡單配置項:
```bash
error_page 500 502 503 504 /50x.html;
```
對于簡單配置,配置項的結尾使用分號結束。對于復雜配置項,包含多個TOKEN串的,一般都是簡單TOKEN串放在前面,復合配置塊一般位于最后,而且其結尾,并不需要再添加分號。例如下面這個復雜配置項
```bash
location / {
root /home/jizhao/nginx-book/build/html;
index index.html index.htm;
}
```
### 指令上下文?
nginx.conf中的配置信息,根據其邏輯上的意義對其進行分類,可以分成多個作用域或指令上下文,指令上下文層次關系如下:

* `main`:Nginx在運行時與具體業務功能無關的參數,比如工作進程數、運行身份等。
* `http`:與提供http服務相關的參數,比如keepalive、gzip等。
* `server`:http服務上支持若干虛擬機,每個虛擬機一個對應的server配置項,配置
項里包含該虛擬機相關的配置。
* `location`:http服務中,某些特定的URL對應的一系列配置項。
* `mail`:實現email相關的SMTP/IMAP/POP3代理時,共享的一些配置項。
>更多配置信息可以參看Nginx安裝后的缺省配置文件/usr/local/nginx/nginx.conf.default。
指令上下文,可能有包含的情況出現。例如:通常http上下文和mail上下文一定是出現在main上下文里的。在一個上下文里,可能包含另外一種類型的上下文多次。例如:如果http服務,支持了多個虛擬主機,那么在http上下文里,就會出現多個server上下文。
```bash
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的使用文檔.