Nginx 配置文件詳解user nginx ;#用戶worker_processes 8;#工作進(jìn)程，根據(jù)硬件調(diào)整，大于等于cpu 核數(shù)error_log logs/nginx_error.log

Nginx 配置文件詳解

user nginx ;

#用戶

worker_processes 8;

#工作進(jìn)程，根據(jù)硬件調(diào)整，大于等于cpu 核數(shù)

error_log logs/nginx_error.log crit; #錯(cuò)誤日志

pid logs/nginx.pid;

#pid放置的位置

worker_rlimit_nofile 204800;

#指定進(jìn)程可以打開的最大描述符

這個(gè)指令是指當(dāng)一個(gè)nginx 進(jìn)程打開的最多文件描述符數(shù)目，理論值應(yīng)該是最多打開文

件數(shù)（ulimit -n）與nginx 進(jìn)程數(shù)相除，但是nginx 分配請(qǐng)求并不是那么均勻，所以最好與ulimit -n 的值保持一致。

現(xiàn)在在linux 2.6內(nèi)核下開啟文件打開數(shù)為65535，worker_rlimit_nofile就相應(yīng)應(yīng)該填寫65535。 這是因?yàn)閚ginx 調(diào)度時(shí)分配請(qǐng)求到進(jìn)程并不是那么的均衡，所以假如填寫10240，總并發(fā)量達(dá)到3-4萬時(shí)就有進(jìn)程可能超過10240了，這時(shí)會(huì)返回502錯(cuò)誤。

events

{

use epoll;

#使用epoll 的I/O 模型

補(bǔ)充說明:

與apache 相類，nginx 針對(duì)不同的操作系統(tǒng)，有不同的事件模型

A ）標(biāo)準(zhǔn)事件模型

Select 、poll 屬于標(biāo)準(zhǔn)事件模型，如果當(dāng)前系統(tǒng)不存在更有效的方法，nginx 會(huì)選擇select 或poll

B ）高效事件模型

Kqueue ：使用于FreeBSD 4.1 , OpenBSD 2.9 , NetBSD 2.0 和 MacOS X.使用雙處理器的Mac OS X系統(tǒng)使用kqueue 可能會(huì)造成內(nèi)核崩潰。

Epoll:使用于Linux 內(nèi)核2.6版本及以后的系統(tǒng)。

/dev/poll：使用于Solaris 7 11/99 , HP/UX 11.22 (eventport), IRIX 6.5.15 和 Tru64 UNIX 5.1A 。

Eventport ：使用于Solaris 10. 為了防止出現(xiàn)內(nèi)核崩潰的問題， 有必要安裝安全補(bǔ)丁

worker_connections 204800;

#工作進(jìn)程的最大連接數(shù)量，根據(jù)硬件調(diào)整，和前面工作進(jìn)程配合起來用，盡量大，但是別把cpu 跑到100就行

每個(gè)進(jìn)程允許的最多連接數(shù)， 理論上每臺(tái)nginx 服務(wù)器的最大連接數(shù)為worker_processes*worker_connections

keepalive_timeout 60;

keepalive 超時(shí)時(shí)間。

client_header_buffer_size 4k;

客戶端請(qǐng)求頭部的緩沖區(qū)大小，這個(gè)可以根據(jù)你的系統(tǒng)分頁大小來設(shè)置，一般一個(gè)請(qǐng)求頭的大小不會(huì)超過1k ，不過由于一般系統(tǒng)分頁都要大于1k ，所以這里設(shè)置為分頁大小。

分頁大小可以用命令getconf PAGESIZE 取得。

[root@web001 ~]# getconf PAGESIZE

4096

但也有client_header_buffer_size超過4k 的情況，但是client_header_buffer_size該值必須設(shè)置為“系統(tǒng)分頁大小”的整倍數(shù)。

open_file_cache max=65535 inactive=60s;

這個(gè)將為打開文件指定緩存，默認(rèn)是沒有啟用的，max 指定緩存數(shù)量，建議和打開文件數(shù)一致，inactiv e 是指經(jīng)過多長時(shí)間文件沒被請(qǐng)求后刪除緩存。

open_file_cache_valid 80s;

這個(gè)是指多長時(shí)間檢查一次緩存的有效信息。

open_file_cache_min_uses 1;

open_file_cache指令中的inactive 參數(shù)時(shí)間內(nèi)文件的最少使用次數(shù)，如果超過這個(gè)數(shù)字，文件描述符一直是在緩存中打開的，如上例，如果有一個(gè)文件在inactive 時(shí)間內(nèi)一次沒被使用，它將被移除。

}

#設(shè)定http 服務(wù)器，利用它的反向代理功能提供負(fù)載均衡支持

{

include mime.types;

#設(shè)定mime 類型, 類型由mime.type 文件定義

default_type application/octet-stream;

log_format main '$host $status [$time_local] $remote_addr [$time_local] $request_uri ' '"$http_referer" "$http_user_agent" "$http_x_forwarded_for" '

'$bytes_sent $request_time $sent_http_x_cache_hit';

log_format log404 '$status [$time_local] $remote_addr $host$request_uri $sent_http_location';

$remote_addr與$http_x_forwarded_for用以記錄客戶端的ip 地址；

$remote_user：用來記錄客戶端用戶名稱；

$time_local： 用來記錄訪問時(shí)間與時(shí)區(qū)；

$request： 用來記錄請(qǐng)求的url 與http 協(xié)議；

$status： 用來記錄請(qǐng)求狀態(tài)；成功是200，

$body_bytes_s ent ：記錄發(fā)送給客戶端文件主體內(nèi)容大??；

$http_referer：用來記錄從那個(gè)頁面鏈接訪問過來的；

$http_user_agent：記錄客戶毒啊瀏覽器的相關(guān)信息；

通常web 服務(wù)器放在反向代理的后面，這樣就不能獲取到客戶的IP 地址了，通過$remote_add拿到的IP 地址是反向代理服務(wù)器的iP 地址。反向代理服務(wù)器在轉(zhuǎn)發(fā)請(qǐng)求的http 頭信息中，可以增加x_forwarded_for信息，用以記錄原有客戶端的IP 地址和原來客戶端的請(qǐng)求的服務(wù)器地址；

access_log /dev/null;

#用了log_format指令設(shè)置了日志格式之后，需要用access_log指令指定日志文件的存放路徑； # access_log /usr/local/nginx/logs/access_log main;

server_names_hash_bucket_size 128;

#保存服務(wù)器名字的hash 表是由指令server_names_hash_max_size 和server_names_hash_bucket_size所控制的。參數(shù)hash bucket size總是等于hash 表的大小，并且是一路處理器緩存大小的倍數(shù)。在減少了在內(nèi)存中的存取次數(shù)后，使在處理器中加速查找hash 表鍵值成為可能。如果hash bucket size等于一路處理器緩存的大小，那么在查找鍵的時(shí)候，最壞的情況下在內(nèi)存中查找的次數(shù)為2。第一次是確定存儲(chǔ)單元的地址，第二次是在存儲(chǔ)單元中查找鍵 值。因此，如果Nginx 給出需要增大hash max size 或 hash bucket size的提示，那么首要的是增大前一個(gè)參數(shù)的大小.

client_header_buffer_size 4k;

客戶端請(qǐng)求頭部的緩沖區(qū)大小，這個(gè)可以根據(jù)你的系統(tǒng)分頁大小來設(shè)置，一般一個(gè)請(qǐng)求的頭部大小不會(huì)超過1k ，不過由于一般系統(tǒng)分頁都要大于1k ，所以這里設(shè)置為分頁大小。分頁大小可以用命令getconf PAGESIZE 取得。

large_client_header_buffers 8 128k;

客戶請(qǐng)求頭緩沖大小

nginx 默認(rèn)會(huì)用client_header_buffer_size這個(gè)buffer 來讀取header 值，如果

header 過大，它會(huì)使用large_client_header_buffers來讀取

如果設(shè)置過小HTTP 頭/Cookie過大 會(huì)報(bào)400 錯(cuò)誤nginx 400 bad request

求行如果超過buffer ，就會(huì)報(bào)HTTP 414錯(cuò)誤(URI Too Long)

nginx 接受最長的HTTP 頭部大小必須比其中一個(gè)buffer 大，否則就會(huì)報(bào)400的

HTTP 錯(cuò)誤(Bad Request)。

open_file_cache max 102400

使用字段:http, server, location 這個(gè)指令指定緩存是否啟用, 如果啟用, 將記錄文件以下信息: ·打開的文件描述符, 大小信息和修改時(shí)間. ·存在的目錄信息. ·在搜索文件過程中的錯(cuò)誤信息 --沒有這個(gè)文件, 無法正確讀取, 參考o(jì)pen_file_cache_errors指令選項(xiàng):

·max -指定緩存的最大數(shù)目, 如果緩存溢出, 最長使用過的文件(LRU)將被移除

例: open_file_cache max=1000 inactive=20s; open_file_cache_valid 30s; open_file_cache_min_uses 2; open_file_cache_errors on;

open_file_cache_errors

語法:open_file_cache_errors on | off 默認(rèn)值:open_file_cache_errors off 使用字段:http, server, location 這個(gè)指令指定是否在搜索一個(gè)文件是記錄cache 錯(cuò)誤.

open_file_cache_min_uses

語法:open_file_cache_min_uses number 默認(rèn)值:open_file_cache_min_uses 1 使用字段:http, server, location 這個(gè)指令指定了在open_file_cache指令無效的參數(shù)中一定的時(shí)間范圍內(nèi)可以使用的

最小文件數(shù), 如 果使用更大的值, 文件描述符在cache 中總是打開狀態(tài).

open_file_cache_valid

語法:open_file_cache_valid time 默認(rèn)值:open_file_cache_valid 60 使用字段:http, server, location 這個(gè)指令指定了何時(shí)需要檢查open_file_cache中緩存項(xiàng)目的有效信息.

client_max_body_size 300m;

設(shè)定通過nginx 上傳文件的大小

sendfile on;

#sendfile指令指定 nginx 是否調(diào)用sendfile 函數(shù)（zero copy 方式）來輸出文件，

對(duì)于普通應(yīng)用，必須設(shè)為on 。

如果用來進(jìn)行下載等應(yīng)用磁盤IO 重負(fù)載應(yīng)用，可設(shè)置為off ，以平衡磁盤與網(wǎng)絡(luò)IO 處理速度，降低系統(tǒng)uptime 。

tcp_nopush on;

此選項(xiàng)允許或禁止使用socke 的TCP_CORK的選項(xiàng)，此選項(xiàng)僅在使用sendfile 的時(shí)候使用

proxy_connect_timeout 90;

#后端服務(wù)器連接的超時(shí)時(shí)間_發(fā)起握手等候響應(yīng)超時(shí)時(shí)間

proxy_read_timeout 180;

#連接成功后_等候后端服務(wù)器響應(yīng)時(shí)間_其實(shí)已經(jīng)進(jìn)入后端的排隊(duì)之中等候處理（也可以說是后端服務(wù)器處理請(qǐng)求的時(shí)間）

proxy_send_timeout 180;

#后端服務(wù)器數(shù)據(jù)回傳時(shí)間_就是在規(guī)定時(shí)間之內(nèi)后端服務(wù)器必須傳完所有的數(shù)據(jù)

proxy_buffer_size 256k;

#設(shè)置從被代理服務(wù)器讀取的第一部分應(yīng)答的緩沖區(qū)大小，通常情況下這部分應(yīng)答中包含一個(gè)小的應(yīng)答頭，默認(rèn)情況下這個(gè)值的大小為指令proxy_buffers中指定的一個(gè)緩沖區(qū)的大小，不過可以將其設(shè)置為更小 proxy_buffers 4 256k;

#設(shè)置用于讀取應(yīng)答（來自被代理服務(wù)器）的緩沖區(qū)數(shù)目和大小，默認(rèn)情況也為分頁大小，根據(jù)操作系統(tǒng)的不同可能是4k 或者8k

proxy_busy_buffers_size 256k;

proxy_temp_file_write_size 256k;

#設(shè)置在寫入proxy_temp_path時(shí)數(shù)據(jù)的大小，預(yù)防一個(gè)工作進(jìn)程在傳遞文件時(shí)阻塞太長

proxy_temp_path /data0/proxy_temp_dir;

#proxy_temp_path和proxy_cache_path指定的路徑必須在同一分區(qū)

proxy_cache_path /data0/proxy_cache_dir levels=1:2 keys_zone=cache_one:200m inactive=1d max_size=30g;

#設(shè)置內(nèi)存緩存空間大小為200MB ，1天沒有被訪問的內(nèi)容自動(dòng)清除，硬盤緩存空間大小為30GB 。

keepalive_timeout 120;

keepalive 超時(shí)時(shí)間。

tcp_nodelay on;

client_body_buffer_size 512k;

如果把它設(shè)置為比較大的數(shù)值，例如256k ，那么，無論使用firefox 還是IE 瀏覽器，來提交任意小于256k 的圖片，都很正常。如果注釋該指令，使用默認(rèn)的client_body_buffer_size設(shè)置，也就是操作系統(tǒng)頁面大小的兩倍，8k 或者16k ，問題就出現(xiàn)了。

無論使用firefox4.0還是IE8.0，提交一個(gè)比較大，200k 左右的圖片，都返回500 Internal Server Error 錯(cuò)誤

proxy_intercept_errors on;

表示使nginx 阻止HTTP 應(yīng)答代碼為400或者更高的應(yīng)答。

upstream img_relay {

server 127.0.0.1:8027;

server 127.0.0.1:8028;

server 127.0.0.1:8029;

hash $request_uri;

}

nginx 的upstream 目前支持4種方式的分配

1、輪詢（默認(rèn)）

每個(gè)請(qǐng)求按時(shí)間順序逐一分配到不同的后端服務(wù)器，如果后端服務(wù)器down 掉，能自動(dòng)剔除。

2、weight

指定輪詢幾率，weight 和訪問比率成正比，用于后端服務(wù)器性能不均的情況。

例如：

upstream bakend {

server 192.168.0.14 weight=10;