nginx 的配置系統由一個主配置文件和其他一些輔助的配置文件構成。這些配置文件均是純文本文件,全部位于Nginx 安裝目錄下的 conf 目錄下。 ? ? ? ?( 推薦學習:nginx教程?)
配置文件中以#開始的行,或者是前面有若干空格或者 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 支持的幾個指令上下文:
main: Nginx 在運行時與具體業務功能(比如http服務或者email服務代理)無關的一些參數,比如工作進程數,運行的身份等。
http: 與提供 http 服務相關的一些配置參數。例如:是否使用 keepalive 啊,是否使用gzip進行壓縮等。
server: http 服務上支持若干虛擬主機。每個虛擬主機一個對應的 server 配置項,配置項里面包含該虛擬主機相關的配置。在提供 mail 服務的代理時,也可以建立若干 server,每個 server 通過監聽的地址來區分。
location: http 服務中,某些特定的URL對應的一系列配置項。
mail: 實現 email 相關的 SMTP/IMAP/POP3 代理時,共享的一些配置項(因為可能實現多個代理,工作在多個監聽地址上)。
指令上下文,可能有包含的情況出現。例如:通常 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 上下文中的配置指令如下:
userworker_processeserror_logeventshttpmail
存在于 http 上下文中的指令如下:
server
存在于 mail 上下文中的指令如下:
serverauth_httpimap_capabilities
存在于 server 上下文中的配置指令如下:
listenserver_nameaccess_loglocationprotocolproxysmtp_authxclient
存在于 location 上下文中的指令如下:
indexroot
當然,這里只是一些示例。具體有哪些配置指令,以及這些配置指令可以出現在什么樣的上下文中,需要參考 Nginx 的使用文檔。