. Nginx服務(wù)的基本配置

1.1 用于調(diào)試進(jìn)程和定位問題的配置項

• 是否以守護(hù)進(jìn)程的方式運(yùn)行nginx

# 默認(rèn)ondaemon on|off;

• 是否以master/worker方式工作

# 默認(rèn)on，指定了是否以master-worker進(jìn)程的方式運(yùn)行，如果設(shè)置為off，那么所有的請求將只會由master進(jìn)程處理master_process on|off;

• error日志的設(shè)置

# 指定了error日志的目錄和日志級別，第二個參數(shù)用于指定目錄，第三個參數(shù)用于指定日志級別，總共有：debug、info、notice、warn、error、crit、alert、emerg，這些日志級別中，從左往右優(yōu)先級依次增大，默認(rèn)為infoerror_log logs/error.log error;

• 是否處理幾個特殊的調(diào)試點

# 指定了調(diào)試點debug_points stop|abort

• 僅對指定的客戶端輸出debug級別的日志

debug_connection IP|CIDR

• 該參數(shù)主要用于events模塊中，針對指定的ip或者網(wǎng)段記錄debug日志：

events { debug_connection 10.224.66.14; debug_connection 10.224.57.0/24;}

• 需要注意的是，在使用該參數(shù)時，必須要確保在進(jìn)行configure時已經(jīng)加入了--with-debug參數(shù)，否則不會生效；
• 限制coredump核心轉(zhuǎn)儲文件的大小

worker_rlimit_core size;

• 在Linux操作系統(tǒng)中，如果一個進(jìn)程由于錯誤或者收到信號而終止時，會將進(jìn)程執(zhí)行時的內(nèi)存內(nèi)容寫入一個文件(core文件)，以作為調(diào)試之用，這就是所謂的核心轉(zhuǎn)儲。在nginx進(jìn)程宕機(jī)時，其就會產(chǎn)生核心轉(zhuǎn)儲文件，而且該文件一般都有幾個G，因而如果不限制該文件的大小，那么很有可能會把服務(wù)器磁盤占滿。該參數(shù)的作用就是限制核心轉(zhuǎn)儲文件的大小的。
• 指定coredump文件生成目錄

working_directory path;

• 該參數(shù)指定了在生成核心轉(zhuǎn)儲文件時，將該文件存放的目錄。

1.2 正常運(yùn)行的配置項

• 定義環(huán)境變量

env TESTPATH=/tmp/

• 這個配置項可以讓用戶直接設(shè)置操作系統(tǒng)上的環(huán)境變量。
• 嵌入其他配置文件

include /path/file

• 用于將其他的配置文件引入進(jìn)來，該路徑可以是絕對路徑，也可以是相對路徑，如果是相對路徑，則是基于nginx的配置目錄而指定的。
• pid文件的路徑

pid path/file

• 用于指定存儲nginx的master進(jìn)程運(yùn)行所使用的進(jìn)程id的文件的路徑。
• Nginx的worker進(jìn)程運(yùn)行的用戶及用戶組

user username [groupName]

• 用于指定worker進(jìn)程運(yùn)行時所基于的用戶和用戶組，默認(rèn)都為nobody，這里如果不指定groupName，那么組名就與用戶名一致。
• 指定nginx的worker進(jìn)程可以打開的最大句柄描述符個數(shù)

worker_rlimit_nofile limit;

• 設(shè)置一個worker進(jìn)程能夠打開的最大句柄描述符個數(shù)。
• 限制信號隊列

worker_rlimit_sigpending limit;

• 設(shè)置了每個用戶能夠發(fā)往nginx的信號隊列的大小，如果信號隊列已滿，那么新發(fā)送的信號將會被丟棄。

1.3 優(yōu)化性能的配置項

• nginx的worker進(jìn)程的個數(shù)

worker_processes 1;

• 用于指定nginx運(yùn)行時worker進(jìn)程的個數(shù)，在nginx運(yùn)行時，每個worker進(jìn)程都是單線程運(yùn)行的，這里需要判斷worker進(jìn)程是否進(jìn)行了阻塞性操作，如果有這樣的操作，那么稍微多配置一些worker進(jìn)程比較好，如果沒有，那么將worker進(jìn)程數(shù)量設(shè)置得與CPU數(shù)量一樣能夠得到更好的性能。
• 綁定nginx的worker進(jìn)程到指定的CPU內(nèi)核

worker_cpu_affinity cpumask [cpumask...]

• 將worker進(jìn)程與指定的CPU進(jìn)行綁定，這樣能夠防止多個worker進(jìn)程搶占同一個CPU，從而避免出現(xiàn)同步問題。如下是一個4核CPU的配置方式：

worker_processes 4;worker_cpu_affinity 1000 0100 0010 0001;

• 需要注意的是，worker_cpu_affinity僅對于Linux系統(tǒng)有效。
• SSL硬件加速

ssl_engine device;

• 如果服務(wù)器上有SSL硬件加速設(shè)備，那么就可以進(jìn)行配置以加快SSL協(xié)議的處理速度。用戶可以使用OpenSSL提供的命令來查看是否有SSL硬件加速設(shè)備：

openssl engine -t

• 系統(tǒng)調(diào)用gettimeofday的執(zhí)行頻率

timer_resolution -t

• 默認(rèn)情況下，每次內(nèi)核的事件調(diào)用返回時，都會執(zhí)行一次gettimeofday，在早期的Linux版本中，獲取系統(tǒng)時間都會有一次從內(nèi)核態(tài)到用戶態(tài)的數(shù)據(jù)復(fù)制，其代價比較高，但是在最新的x86-64體系架構(gòu)中，gettimeofday僅僅只是一次vsyscall，其僅僅只是對共享內(nèi)存頁中的數(shù)據(jù)的訪問，代價不大。
• nginx的worker進(jìn)程優(yōu)先級

worker_priority nice;

• 用于設(shè)置nginx的worker進(jìn)程的優(yōu)先級，其中，nice的默認(rèn)值為0。在Linux操作系統(tǒng)中，當(dāng)有多個進(jìn)程在競爭CPU執(zhí)行資源時，其就會根據(jù)每個進(jìn)程設(shè)置的優(yōu)先級來優(yōu)先分配執(zhí)行權(quán)限，并且所分配的時間片也要高一些。優(yōu)先級的值在-20~+19之間，數(shù)值越低優(yōu)先級越高，一般建議將nginx的優(yōu)先級設(shè)置得更低一些，這樣才能保證其執(zhí)行的權(quán)限，但是建議不要設(shè)置得比內(nèi)核的進(jìn)程優(yōu)先級(其值為-5)還要低。

1.4 事件類配置項

• 是否打開accept鎖

accept_mutex [on|off]

• accept_mutex參數(shù)用于控制是否啟用負(fù)載均衡鎖，其默認(rèn)值為on，該鎖會保證各個worker輪流的、序列化的與新客戶端建立連接，并且當(dāng)某個worker的連接數(shù)達(dá)到了worker_connections配置的最大連接數(shù)的7/8時，該鎖會降低該worker將要新建立的連接數(shù)，從而保證各個worker的負(fù)載均衡。
• lock文件的路徑

lock_file path/file;

• 該參數(shù)指定了lock文件的路徑。nginx會使用操作系統(tǒng)提供的鎖功能，但如果操作系統(tǒng)不支持原子鎖，此時才會使用文件鎖來實現(xiàn)lock。如果accept_mutex參數(shù)設(shè)置為off，那么該參數(shù)將不會生效。
• 使用accept鎖后到真正建立連接之間的延遲時間

accept_mutex_delay Nms;

• 如果一個worker進(jìn)程嘗試獲取鎖失敗了，那么其就會等待該參數(shù)指定的時間段之后再次嘗試獲取鎖，該值默認(rèn)為500ms。
• 批量建立新連接

multi_accept [on|off];

• 當(dāng)事件模型通知此次有新的連接建立請求時，盡可能的對本次調(diào)度中客戶端發(fā)起的的所有TCP請求都建立連接，該值默認(rèn)為off。
• 選擇事件模型

use [kqueue|rtsig|epoll|/dev/poll|select|poll|eventport];

• nginx所選用的事件模型，其會自動使用最適合的模型。在Linux操作系統(tǒng)下支持poll、select和epoll三種，其中epoll的性能是最高的。
• 每個worker的最大連接數(shù)

worker_connections number;

• 指定了每個worker進(jìn)程能夠建立的最大連接數(shù)。

2. http核心模塊配置

2.1 監(jiān)聽端口

listen address:port[default(deprecated)|default_server|[backlog=num|rcvbuf=size|sndbuf=size|accept_filter=filter|deferred|bind|ipv6only=[on|off]|ssl]]

• 這里的IP地址和端口號的配置非常靈活，如果不配置端口號，則默認(rèn)為80端口，而ip地址則可以使用通配符進(jìn)行匹配，如：

listen 127.0.0.1:8080;listen *:8080;

• listen的各個參數(shù)含義如下：
• default和default_server：將當(dāng)前server塊作為整個web服務(wù)器的默認(rèn)server塊，如果沒有server設(shè)置了該參數(shù)，則將nginx.conf中的第一個server塊作為默認(rèn)server塊。設(shè)置該參數(shù)的原因在于，如果當(dāng)前請求沒有匹配到任意一個server，那么就使用第一個server處理請求；
• backlog=num：指定了TCP中的backlog隊列的大小，默認(rèn)值為-1。在TCP的三次握手過程中，進(jìn)程此時還沒有開始處理監(jiān)聽句柄，而這些請求都會放在backlog隊列中，當(dāng)backlog隊列滿時，客戶端新的握手請求就會被拒絕；
• rcvbuf=size：設(shè)置監(jiān)聽句柄的SO_RCVBUF參數(shù)；
• sndbuf=size：設(shè)置監(jiān)聽句柄的SO_SNDBUF參數(shù)；
• accept_filter：設(shè)置accept過濾器，只對FreeBSD操作系統(tǒng)有用；
• deferred：如果設(shè)置了該參數(shù)，如果用戶發(fā)起了TCP連接請求，那么在三次握手成功之后內(nèi)核也不會調(diào)度相應(yīng)的進(jìn)程處理請求，而是在用戶真正的發(fā)送了數(shù)據(jù)包之后才會將請求發(fā)送給具體的進(jìn)程進(jìn)行處理；
• bind：綁定當(dāng)前端口/地址對，如127.0.0.1:8000，只有同時對一個端口監(jiān)聽多個地址時才會生效；
• ssl：在當(dāng)前監(jiān)聽的端口上建立的連接必須基于SSL協(xié)議；

2.2 主機(jī)名稱

語法：server_name name [...];默認(rèn)：server_name "";配置塊：server

• server_name后可以跟多個主機(jī)名稱，在處理HTTP請求時，其會將請求中的Host頭部的主機(jī)名與server塊中的主機(jī)名進(jìn)行匹配，如果遇到多個server塊中的主機(jī)名匹配，那么將會按照如下規(guī)則與其進(jìn)行匹配：
• 首先匹配主機(jī)名完全匹配的server塊；
• 然后匹配前綴使用通配符的server塊；
• 接著匹配后綴使用通配符的server塊；
• 最后匹配使用正則表達(dá)式的server塊；、
• 如果沒有找到能夠匹配的主機(jī)名，那么就會按照如下規(guī)則尋找server塊：
• 優(yōu)先選擇在listen項中加入了[default|default_server]的server塊；
• 找到匹配的listen端口的第一個server塊；

2.3 server_names_hash_bucket_size

語法：server_names_hash_bucket_size size;默認(rèn)：server_names_hash_bucket_size 32|64|128;配置塊：http、server、location

• server_names_hash_bucket_size的作用主要是進(jìn)行server name的hash匹配的，在進(jìn)行hash匹配時，該參數(shù)指定了hash表的每個bucket占用的內(nèi)存大小。

2.4 server_names_hash_max_size

語法：server_names_hash_max_size size;默認(rèn)：server_names_hash_max_size 512;配置塊：http、server、location

• server_names_hash_max_size指定了進(jìn)行server name查找時使用的hash表的大小，該值越大，那么占用的內(nèi)存越多，但是查詢的效率也越高。

2.5 重定向主機(jī)名稱的處理

語法：server_name_in_redirect on|off;默認(rèn)：server_name_in_redirect on;配置塊：http、server或者location

• 該配置需要配合server_name使用，在使用on打開時，表示在重定向請求時，會使用server_name里配置的第一個主機(jī)名代替原來請求中的Host頭部，而使用off關(guān)閉時，表示在重定向請求時使用請求本身的Host頭部。

2.6 location

語法：location [=|~|~*|^~|@] /uri/{...}配置塊：server

• location的主要作用是與請求中的URI進(jìn)行匹配，如果匹配了，就使用location塊中的配置來處理用戶請求。如下是location的匹配規(guī)則：
• =表示把URI作為字符串，以便于參數(shù)中的uri做完全匹配。例如：

location = / { # 只有當(dāng)用戶請求是/時，才會使用該location下的配置}

• ~表示匹配URI時是字母大小寫敏感的；
• ~*表示匹配URI時是字母大小寫不敏感的；
• ^~表示匹配URI時只需要其前半部分與uri參數(shù)匹配即可。例如：

location ^~ /images/ { # 以/images/開始的請求都會匹配上}

• @表示僅用于nginx服務(wù)內(nèi)部請求之間的重定向，帶有@的location不直接處理用戶請求；
• 可以在uir參數(shù)里使用正則表達(dá)式。如：

location ~* .(gif|jpg|jpeg)$ { # 匹配以.gif、.jpg、.jpeg結(jié)尾的請求}

• 關(guān)于location的匹配需要說明的一點是，location的匹配是有順序的，當(dāng)一個請求匹配了多個location時，實際上這個請求會被第一個location處理。

3. 文件路徑的定義

3.1 以root方式設(shè)置資源路徑

語法：root path;默認(rèn)：root html;配置塊：http、server、locationo、if

• 示例如下：

location /download/ { root /opt/web/html/;}

• 這種配置方式會將/download/開始的請求映射到/opt/web/html/目錄下，比如某個請求為/download/test/index.html，那么nginx就會到服務(wù)器上查找/opt/web/html/download/test/index.html文件。

3.2 以alias方式設(shè)置資源文件

語法：alias path;配置塊：location;

• 與root一樣，alias也是配置資源文件路徑的，但是alias是location后的路徑以別名的方式替換目標(biāo)路徑的指定部分，比如如下配置：

location /conf { alias /usr/local/nginx/conf;}

• 此時如果一個請求為/conf/index.html，那么其前綴/conf將會與當(dāng)前l(fā)ocation匹配，并且會將alias參數(shù)替換請求uri中匹配的部分，也就是轉(zhuǎn)換后的uri為/usr/local/nginx/conf/index.html。

3.3 訪問首頁

語法：index file...;默認(rèn)：index index.html;配置塊：http、server、location

• 該配置塊的主要作用是將用戶訪問的某個地址映射到首頁，在進(jìn)行首頁查找時，會按照順序查詢index參數(shù)后的文件，如果存在，則將其返回，如果不存在，則繼續(xù)查找下一個。比如如下示例：

location / { root path; index /index.html /html/index.php /index.php}

• 當(dāng)接收到用戶的/請求后，其首先會查詢/path/index.html文件是否存在，如果不存在，則查詢下一個/path/html/index.php是否存在，如果存在，則直接返回，依此類推。

3.4 根據(jù)http返回碼重定向頁面

語法：error_page code[code...][=|=answer-code]uri|@named_location配置塊：http、server、location、if

• 該配置的主要作用是，如果當(dāng)前請求返回了指定的狀態(tài)碼，那么就將其重定向到后面的錯誤頁面。如：

error_page 404 /404.htmlerror_page 502 503 504 /50x.htmlerror_page 403 http://example.com/forbidden.htmlerror_page 404 = @fetch;

• 需要注意的是，即使重定向了URI，返回的HTTP狀態(tài)碼還是原來的狀態(tài)碼，如果需要修改狀態(tài)碼，可以使用=來修改原來的狀態(tài)碼，如：

error_page 404 =200 /empty.gif;error_page 404 =403 /forbidden.gif;

• 也可以不指定修改后的狀態(tài)碼，而是由重定向后的請求決定其返回的狀態(tài)碼：

error_page 404 = /empty.gif;

• 在重定向后，也可以不修改URI，而是將這個請求重定向到另一個location中進(jìn)行處理，比如：

location / { error_page 404 @fallback;}location @fallback { proxy_pass http://backend;}

3.5 是否支持遞歸的使用error_page

語法：recursive_error_pages [on|off];默認(rèn)：recursive_error_pages off;配置塊：http、server、location;

• 該配置主要用于控制是否支持遞歸的定義error_page。

3.6 try_files

語法：try_files path1[path2]uri;配置塊：server、location

• 該參數(shù)的主要作用是在用戶請求到達(dá)之后，會依次嘗試其后指定的各個path路徑，如果匹配上了，那么就將該路徑的值直接返回。如果都沒有匹配上，那么就會使用最后的uri作為默認(rèn)處理路徑。示例如：

try_files /system/maintenance.html $uri $uri/index.html $uri.html @otherlocation @other { proxy_pass http://backend;}

4. 內(nèi)存及磁盤資源的分配

4.1 http包體只存儲到磁盤文件中

語法：client_body_in_file_only on|clean|off;默認(rèn)：client_body_in_file_only off;配置塊：http、server、location

• 當(dāng)值配置為非off時，用戶請求的http包體一律存儲到磁盤文件中，即使只有0字節(jié)也會存儲為文件。當(dāng)請求結(jié)束時，如果配置為on，則這個文件不會被刪除，如果配置為clean，則會刪除該文件。

4.2 http包體盡量寫入到一個內(nèi)存buffer中

語法：client_body_in_single_buffer on|off;默認(rèn)：client_body_in_single_buffer off;配置塊：http、server、location

• 用戶請求的http包體一律存儲到內(nèi)存buffer中，如果存儲的包體大小超過了client_body_buffer_size指定的大小，那么該請求還是會存儲到磁盤文件中。

4.3 存儲http頭部的內(nèi)存buffer大小

語法：client_header_buffer_size size;默認(rèn)：client_header_buffer_size 1k;配置塊：http、server

• 該參數(shù)指定了用戶請求的http頭部的size大小，如果請求頭部大小超過了該數(shù)值，那么就會將請求就會交由large_client_header_buffers參數(shù)定義的buffer處理。

4.4 存儲超大http頭部的內(nèi)存buffer大小

語法：large_client_header_buffers number size;默認(rèn)：large_client_header_buffers 48k;配置塊：http、server

• 該參數(shù)主要是在用戶的請求頭部信息超過了client_header_buffer_size所能存儲的大小時使用，該參數(shù)定義了每個header所能傳輸?shù)臄?shù)據(jù)的大小，以及最多能夠傳輸多少個header。如果單個header大小超限，則會返回414(Request URI too large)狀態(tài)碼，如果是header個數(shù)超限，則會返回400(Bad Request)狀態(tài)碼。

4.5 存儲http包體的內(nèi)存buffer的大小

語法：client_body_buffer_size size;默認(rèn)：client_body_buffer_size 8k/16k;配置塊：http、server、location

• 該參數(shù)指定了nginx接收用戶http請求的包體buffer的大小，如果超過了該大小，那個請求包體將會存儲到磁盤文件中。
• 需要注意的是，如果用戶請求的header中包含Content-Length，并且其標(biāo)識的長度小于上述參數(shù)指定的長度，那么就會自動降低此次請求所使用的buffer大小。

4.6 http包體的臨時存放目錄

語法：client_body_temp_path dir-path[level1[level2[level3]]]默認(rèn)：client_body_temp_path client_body_temp;配置塊：http、server、location

• 該參數(shù)的主要作用是指定了存儲http包體的磁盤目錄，后面的level表示可以有幾級子目錄，這是因為如果請求比較多，那么生成的文件就會比較多，頻繁的訪問同一個目錄可能會降低性能，因而可以設(shè)置多級子目錄用于文件的存放；
• 需要注意的是，上述level參數(shù)表示的是所生成的目錄名占有目標(biāo)文件名字符的個數(shù)，比如生成的目標(biāo)文件名為00000123456，而上述參數(shù)按如下配置：

client_body_temp_path /opt/nginx/client_temp 1 2;

• 那么nginx就會截取目標(biāo)文件名的最后1個字符作為一級目錄，倒數(shù)第二個和第三個總共兩個字符作為二級目錄，最終文件將會存儲在如下目錄：

/opt/nginx/client_temp/6/45/00000123456

• nginx在生成目標(biāo)文件時，其文件名是以順序遞增的整數(shù)進(jìn)行命名的。

4.7 connection_pool_size

語法：connection_pool_size size;默認(rèn)：connection_pool_size 256;配置塊：http、server

• 該參數(shù)指定了nginx為每個建立成功的TCP連接預(yù)先分配的內(nèi)存池大小，size指定的是預(yù)先分配的內(nèi)存池大小。
• 該參數(shù)需要謹(jǐn)慎配置，因為更大的配置將會消耗服務(wù)器更多的內(nèi)存，而更小的配置將會導(dǎo)致服務(wù)器為了擴(kuò)容而進(jìn)行更多次的內(nèi)存分配。

4.8 request_pool_size

語法：request_pool_size size;默認(rèn)：request_pool_size 4k;配置塊：http、server

• nginx在接收到每個http請求時，都會為其申請一個內(nèi)存池，該參數(shù)指定了該內(nèi)存池的大小，需要注意的是，該內(nèi)存池本質(zhì)上就是從上面介紹的connection_pool_size內(nèi)存池中進(jìn)行申請；
• 在每次http請求結(jié)束時，其就會銷毀該請求申請的內(nèi)存池，而將其返還給connection_pool_size內(nèi)存池，而只有在此次TCP連接關(guān)閉時才會銷毀整個連接的內(nèi)存池。

5. 網(wǎng)絡(luò)連接的設(shè)置

5.1 讀取http頭部的超時時間

語法：client_header_timeout time(默認(rèn)單位：秒);默認(rèn)：client_header_timeout 60;配置塊：http、server、location

• 在客戶端與服務(wù)器建立連接之后，nginx會讀取客戶端發(fā)來的http頭部，如果超過該參數(shù)指定的時間還未讀取到客戶端發(fā)來的字節(jié)，就會認(rèn)為其超時了，此時就會向客戶端返回408(Request timed out)狀態(tài)碼。

5.2 讀取http包體的超時時間

語法：client_body_timeout time(默認(rèn)單位：秒);默認(rèn)：client_body_timeout 60;配置塊：http、server、location

• 該參數(shù)主要作用是指定nginx讀取請求包體的超時時間。

5.3 發(fā)送響應(yīng)的超時時間

語法：send_timeout time;默認(rèn)：send_timeout 60;配置塊：http、server、location

• 這個參數(shù)主要指定了nginx向客戶端發(fā)送響應(yīng)的超時時間，如果客戶端一直沒有嘗試接收數(shù)據(jù)，那么nginx就會關(guān)閉這個連接。

5.4 reset_timeout_connection

語法：reset_timeout_connection on|off;默認(rèn)：reset_timeout_connection off;配置塊：http、server、location

• 如果開啟了該參數(shù)，在連接超時后，nginx會向客戶端發(fā)送RST包來直接重置連接，并且會釋放服務(wù)器上關(guān)于該連接的所有緩存數(shù)據(jù)(如TCP滑動窗口等)。相比于正常關(guān)閉的方式，它使得服務(wù)器能夠避免產(chǎn)生許多處于FIN_WAIT_1、FIN_WAIT_2、TIME_WAIT狀態(tài)的TCP連接。
• 需要注意的是，使用RST重置包關(guān)閉連接會帶來一些問題，默認(rèn)情況下不會開啟。

5.5 lingering_close

語法：lingering_close off|on|always;默認(rèn)：lingering_close on;配置塊：http、server、location

• 該配置塊控制nginx關(guān)閉用戶連接的方式。always表示關(guān)閉用戶連接前必須無條件的處理連接上所有用戶發(fā)送的數(shù)據(jù)。off表示關(guān)閉連接時完全不管連接上是否有用戶準(zhǔn)備就緒的數(shù)據(jù)。on是中間值，一般情況下在關(guān)閉連接前都會處理連接上的用戶發(fā)送的數(shù)據(jù)，除非某些時候業(yè)務(wù)上認(rèn)定這些數(shù)據(jù)是不需要的，此時就會拋棄這些數(shù)據(jù)。

5.6 lingering_time

語法：lingering_time time;默認(rèn)：lingering_time 30s;配置塊：http、server、location

• 在lingering_close啟用后，這個配置項主要是針對大文件的傳輸用的，比如當(dāng)某個請求傳輸?shù)臄?shù)據(jù)超過了max_client_body_size時，nginx就會向該客戶端發(fā)送413(Request entity too large)狀態(tài)碼，但是某些客戶端可能不會理會該狀態(tài)碼而還是繼續(xù)向服務(wù)器發(fā)送數(shù)據(jù)，此時nginx就會在該參數(shù)的超時時間之后直接關(guān)閉該連接。

5.7 lingering_timeout

語法：lingering_timeout time;默認(rèn)：lingering_timeout 5s;配置塊：http、server、location

• 在lingering_close啟用后，nginx在關(guān)閉連接前，會檢測用戶連接上是否還有未處理的數(shù)據(jù)，如果在該參數(shù)指定的時間之后還沒有相應(yīng)的數(shù)據(jù)到達(dá)，那么就會關(guān)閉該鏈接。

5.8 對某些瀏覽器禁用keepalive功能

語法：keepalive_disable [msie6|safari|none]...默認(rèn)：keepalive_disablemsie6 safari配置塊：http、server、location

• 該參數(shù)主要是指定對哪些瀏覽器禁用keepalive功能，keepalive會在客戶端與服務(wù)器之間建立一個長連接，這對于發(fā)送多個http請求是非常有用的，但是對于IE6和以前版本，還有Safari瀏覽器在處理POST請求時會有功能性問題，因而對于這些瀏覽器默認(rèn)是禁用的。

5.9 keepalive超時時間

語法：keepalive_timeout time(默認(rèn)單位：秒);默認(rèn)：keepalive_timeout 75;配置塊：http、server、location

• 該參數(shù)主要是在一個keepalive連接在指定時長內(nèi)沒有接收到新的請求時，將會關(guān)閉該連接。

5.10 keepalive長連接上能夠承載的最大請求數(shù)

語法：keepalive_requests n;默認(rèn)：keepalive_requests 100;配置塊：http、server、location

• 該參數(shù)指定了一個keepalive長連接上能夠承載的最大連接數(shù)，默認(rèn)為100。

5.11 tcp_nodelay

語法：tcp_nodelay on|off;默認(rèn)：tcp_nodelay on;配置塊：http、server、location

• 確定對keepalive連接是否使用TCP_NODELAY選項

5.12 tcp_nopush

語法：tcp_nopush on|off;默認(rèn)：tcp_nopush off;配置塊：http、server、location

• 在打開sendfile選項時，確定是否開啟FreeBSD系統(tǒng)上的TCP_NOPUSH或者Linux系統(tǒng)上的TCP_CORK功能。打開tcp_nopush后，將會在發(fā)送響應(yīng)時把整個響應(yīng)包頭放到一個TCP包中發(fā)送。

6. MIME類型的設(shè)置

6.1 MIME type與文件擴(kuò)展的映射

語法：type {...};配置塊：http、server、location

• 該配置項定義了MIME type到文件擴(kuò)展名的映射。多個擴(kuò)展名可以映射到同一個MIME type。例如：

types { text/html html; text/html conf; image/gif gif; image/jpeg jpg;}

6.2 默認(rèn)MIME type

語法：default_type MIME-type;默認(rèn)：default_type text/plain;配置塊：http、server、location

• 當(dāng)找不到相應(yīng)的MIME type與文件擴(kuò)展名之間的映射時，使用默認(rèn)的MIME type作為http header的Content-Type。

6.3 types_hash_bucket_size

語法：types_hash_max_size size;默認(rèn)：types_hash_max_size 1024;配置塊：http、server、location

• nginx使用了一個散列表來保存MIME type與文件擴(kuò)展名之間的映射，該參數(shù)就是指定該散列表桶的大小的。

6.4 types_hash_max_size

語法：types_hash_max_size size;默認(rèn)：types_hash_max_size 1024;配置塊：http、server、location

• 該參數(shù)指定了存儲MIME type與文件擴(kuò)展名的散列的最大大小，該值越大，散列的key就越稀疏，檢索速度越快，但是會占用更多的內(nèi)存；該值越小，占用的內(nèi)存越小，但是沖突率就會上升，檢索越慢。

7. 對客戶端請求的限制

7.1 按http方法名限制用戶請求

語法：limit_except method...{...}配置塊：location

• 該配置項的主要作用是限制某些方法的請求的訪問，后面的參數(shù)可取GET、HEAD、POST、DELETE、MKCOL、COPY、MOVE、OPTIONS、PROPFIND、PROPPATCH、LOCK、UNLOCK或者PATCH。示例如：

limit_except GET { allow 192.168.1.0/32; deny all;}

• 上述配置將會限制所有的GET請求的訪問，而允許其他方法的請求。

7.2 http請求包體的最大值

語法：client_max_body_size size;默認(rèn)：client_max_body_size 1m;配置塊：http、server、location

• 該參數(shù)指定了http請求的最大包體的大小，nginx會根據(jù)請求header中的Content-Length所表示的長度來判斷其與當(dāng)前參數(shù)是否符合，如果不符合，則直接返回給客戶端413(Request too large)狀態(tài)碼。

7.3 對請求的限速

語法：limit_rate speed;默認(rèn)：limit_rate 0;配置塊：http、server、location、if

• 該配置主要是對客戶端的請求進(jìn)行每秒傳輸?shù)淖止?jié)大小進(jìn)行限速，默認(rèn)為0，表示不限速；
• 針對不同的客戶端，可以使用$limit_rate參數(shù)執(zhí)行不同的限速策略。如：

server { if ($slow) { set $limit_rate 4k; }}

7.4 limit_rate_after

語法：limit_rate_after time;默認(rèn)：limit_rate_after 1m;配置塊：http、server、location、if

• 該參數(shù)表示nginx向客戶端發(fā)送的響應(yīng)大小超過limit_rate_after指定的值之后才開始限速。

8. 文件操作的優(yōu)化

8.1 sendfile系統(tǒng)調(diào)用

語法：sendfile on|off;默認(rèn)：sendfile off;配置塊：http、server、location

• 該參數(shù)用于打開Linux上的sendfile系統(tǒng)調(diào)用，在發(fā)送數(shù)據(jù)到網(wǎng)卡上時，它減少了兩次在用戶態(tài)與內(nèi)核態(tài)之間的數(shù)據(jù)拷貝過程，而直接在磁盤讀取數(shù)據(jù)之后發(fā)送到網(wǎng)卡上，從而提升數(shù)據(jù)發(fā)送效率。

8.2 AIO系統(tǒng)調(diào)用

語法：aio on|off;默認(rèn)：aio off;配置塊：http、server、location

• 該參數(shù)指定了是否在FreeBSD或Linux系統(tǒng)上啟動內(nèi)核級別的異步文件I/O功能，需要注意的是，其與sendfile功能是互斥的。

8.3 directio

語法：directio size|off;默認(rèn)：directio off;配置塊：http、server、location

• 該配置項在FreeBSD和Linux系統(tǒng)上使用O_DIRECT選項去讀取文件，緩沖區(qū)大小為size，通常對大文件的讀取速度有優(yōu)化作用。注意，它與sendfile指令是互斥的。

8.4 directio_alignment

語法：directio_alignment size;默認(rèn)：directio_alignment 512;配置塊：http、server、location

• 它與directio配合使用，指定以directio方式讀取文件時的對其方式。一般情況下，512B已經(jīng)足夠了，但對于一些高性能文件系統(tǒng)，如Linux下的XFS文件系統(tǒng)，可能需要設(shè)置4KB作為對齊方式。

8.5 打開文件緩存

語法：open_file_cache max=N[inactive=time]|off;默認(rèn)：open_file_cache off;配置塊：http、server、location

• 文件緩存會在內(nèi)存中存儲以下三種信息：
• 文件句柄、文件大小和上次修改時間；
• 已經(jīng)打開過的目錄結(jié)構(gòu)；
• 沒有找到的或者沒有權(quán)限操作的文件信息；
• 上面的配置項的三個參數(shù)的含義如下：
• max：表示內(nèi)存中存儲元素的最大個數(shù)。當(dāng)達(dá)到最大限制數(shù)量后，將采用LRU算法從緩存中淘汰最近最少使用的元素；
• inactive：表示在inactive指定的時間段內(nèi)沒有被訪問過的元素將會被淘汰。默認(rèn)時間為60秒；
• off：關(guān)閉緩存功能。
• 示例如下：

open_file_cache max=1000 inactive=20s;

8.6 是否緩存打開文件錯誤的信息

語法：open_file_cache_errors on|off;默認(rèn)：open_file_cache_errors off;配置塊：http、server、location

• 該配置項表示是否對打開文件時找不到文件或者權(quán)限錯誤等信息進(jìn)行緩存。

8.7 不被淘汰的最小訪問次數(shù)

語法：open_file_cache_min_uses number;默認(rèn)：open_file_cache_min_uses 1;配置塊：http、server、location

• 該參數(shù)與open_file_cache配合使用，如果在指定時間內(nèi)訪問該文件的次數(shù)小于該參數(shù)指定的次數(shù)，那么該文件還是會被淘汰。

8.8 檢驗緩存中元素有效性的頻率

語法：open_file_cache_valid time;默認(rèn)：open_file_cahce_valid 60s;配置塊：http、server、location

• 該參數(shù)指定了每間隔多長時間檢查一下緩存中數(shù)據(jù)的有效性，默認(rèn)為60秒。

9. 對客戶端請求的特殊處理

9.1 忽略不合法的http頭部

語法：ignore_invalid_headers on|off;默認(rèn)：ignore_invalid_headers on;配置塊：http、server

• 如果將其設(shè)置為off，那么當(dāng)客戶端請求中有不合法的header時，就會直接響應(yīng)400(Bad Request)；如果將其設(shè)置為on，那么就會忽略此header。

9.2 http頭部是否允許下劃線

語法：underscores_in_headers on|off;默認(rèn)：underscores_in_headers off;配置塊：http、server

• 該參數(shù)指定了http頭部中是否能夠帶有下劃線，默認(rèn)是不允許。

9.3 對If-Modified-Since頭部的處理策略

語法：if_modified_since [off|exact|before];默認(rèn)：if_modified_since exact;配置塊：http、server、location

• If-Modified-Since頭部主要是瀏覽器處于性能考慮而作的一個緩存策略，瀏覽器在請求過一份文件之后，會將該文件在本地緩存，并記錄緩存時間，在下次請求時會在If-Modified-Since頭部中帶上上次緩存的時間，服務(wù)器在接收到該請求時，會將服務(wù)器文件的修改時間與請求中的時間進(jìn)行比較，如果文件在這之后有過修改，那么服務(wù)器就會正常的返回文件內(nèi)容以及200狀態(tài)碼，如果文件沒有修改過，那么說明瀏覽器中緩存的文件是最新的，此時就會返回304(Not Modified)狀態(tài)碼。
• 該配置參數(shù)有三個選項，其含義分別如下：
• off：表示忽略用戶請求中的If-Modified-Since頭部，在每次請求時都將文件內(nèi)容返回，此時響應(yīng)狀態(tài)碼為200；
• exact：將If-Modified-Since頭部包含的時間與將要返回的文件的上次修改時間做精確比較，如果沒有匹配上，則返回200和文件的實際內(nèi)容，如果匹配上了，則表示文件內(nèi)容已經(jīng)是最新的，此時就會返回304(Not Modified)狀態(tài)碼，瀏覽器收到后會直接讀取本地緩存；
• before：這個是比exact更寬松的策略，只要文件的上次修改時間在用戶請求的If-Modified-Since頭部指定的時間之前，那么就會向客戶端返回304(Not Modified)狀態(tài)碼。

9.4 文件未找到時是否返回error日志

語法：log_not_found on|off;默認(rèn)：log_not_found on;配置塊：http、server、location

• 該配置的主要作用在于，當(dāng)用戶請求某個文件時，如果該文件不存在，是否將這條信息記錄在error日志中，主要用于定位問題。

9.5 merge_slashes

語法：merge_slashes on|off;默認(rèn)：merge_slashes on;配置塊：http、server、location

• 該配置項表示是否合并相鄰的/，例如//test///a.txt，在配置為on時，會將其匹配為location/test/a.txt；如果配置為off，則不會匹配，URI將仍然是//test///a.txt。

9.6 DNS解析地址

語法：resolver address...;配置塊：http、server、location

• 設(shè)置DNS名字解析服務(wù)器的地址，如：

resolver 127.0.0.1 192.0.2.1;

9.7 DNS解析的超時時間

語法：resolver_timeout time;默認(rèn)：resolver_timeout 30s;配置塊：http、server、location

• 次配置項表示DNS解析的超時時間

9.8 返回錯誤頁面時是否在server中注明nginx版本

語法：server_tokens on|off;默認(rèn)：server_tokens on;配置塊：http、server、location

• 表示在返回錯誤頁面時是否在Server頭部中返回具體的nginx版本，這主要是為了定位問題方便。

服務(wù)器后臺開發(fā)的技術(shù)點還有很多，

理論的技術(shù)語法一是方面，還有的是在項目中實際應(yīng)用上所學(xué)。 除了nginx之外還有：

如果你也對Linux后臺服務(wù)器開發(fā)感興趣，想學(xué)習(xí)這方面的技術(shù)，可以加入我們一起交流討論學(xué)習(xí)

完整學(xué)習(xí)路線圖，進(jìn)群群文件自行拿走。

https://www.bilibili.com/read/cv3855670

出處： bilibili

總結(jié)

以上是生活随笔為你收集整理的nginx配置多个server_Nginx基本属性配置详解的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。