Nginx指令概述

標籤：

指令概述

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

指令參數

指令的參數使用一個或者多個空格或者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上下文中的配置指令如下:

• 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指令概述