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

Nginx 配置文件詳解

user nginx ;

#用戶

worker_processes 8;

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

error_log logs/nginx_error.log crit; #錯誤日志

pid logs/nginx.pid;

#pid放置的位置

worker_rlimit_nofile 204800;

#指定進程可以打開的最大描述符

這個指令是指當一個nginx 進程打開的最多文件描述符數(shù)目，理論值應該是最多打開文

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

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

events

{

use epoll;

#使用epoll 的I/O 模型

補充說明:

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

A ）標準事件模型

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

B ）高效事件模型

Kqueue ：使用于FreeBSD 4.1 , OpenBSD 2.9 , NetBSD 2.0 和 MacOS X.使用雙處理器的Mac OS X系統(tǒng)使用kqueue 可能會造成內(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)核崩潰的問題， 有必要安裝安全補丁

worker_connections 204800;

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

每個進程允許的最多連接數(shù)， 理論上每臺nginx 服務器的最大連接數(shù)為worker_processes*worker_connections

keepalive_timeout 60;

keepalive 超時時間。

client_header_buffer_size 4k;

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

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

[root@web001 ~]# getconf PAGESIZE

4096

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

open_file_cache max=65535 inactive=60s;

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

open_file_cache_valid 80s;

這個是指多長時間檢查一次緩存的有效信息。

open_file_cache_min_uses 1;

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

}

#設定http 服務器，利用它的反向代理功能提供負載均衡支持

{

include mime.types;

#設定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： 用來記錄訪問時間與時區(qū)；

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

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

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

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

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

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

access_log /dev/null;

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

server_names_hash_bucket_size 128;

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

client_header_buffer_size 4k;

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

large_client_header_buffers 8 128k;

客戶請求頭緩沖大小

nginx 默認會用client_header_buffer_size這個buffer 來讀取header 值，如果

header 過大，它會使用large_client_header_buffers來讀取

如果設置過小HTTP 頭/Cookie過大 會報400 錯誤nginx 400 bad request

求行如果超過buffer ，就會報HTTP 414錯誤(URI Too Long)

nginx 接受最長的HTTP 頭部大小必須比其中一個buffer 大，否則就會報400的

HTTP 錯誤(Bad Request)。

open_file_cache max 102400

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

·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 默認值:open_file_cache_errors off 使用字段:http, server, location 這個指令指定是否在搜索一個文件是記錄cache 錯誤.

open_file_cache_min_uses

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

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

open_file_cache_valid

語法:open_file_cache_valid time 默認值:open_file_cache_valid 60 使用字段:http, server, location 這個指令指定了何時需要檢查open_file_cache中緩存項目的有效信息.

client_max_body_size 300m;

設定通過nginx 上傳文件的大小

sendfile on;

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

對于普通應用，必須設為on 。

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

tcp_nopush on;

此選項允許或禁止使用socke 的TCP_CORK的選項，此選項僅在使用sendfile 的時候使用

proxy_connect_timeout 90;

#后端服務器連接的超時時間_發(fā)起握手等候響應超時時間

proxy_read_timeout 180;

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

proxy_send_timeout 180;

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

proxy_buffer_size 256k;

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

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

proxy_busy_buffers_size 256k;

proxy_temp_file_write_size 256k;

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

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;

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

keepalive_timeout 120;

keepalive 超時時間。

tcp_nodelay on;

client_body_buffer_size 512k;

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

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

proxy_intercept_errors on;

表示使nginx 阻止HTTP 應答代碼為400或者更高的應答。

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、輪詢（默認）

每個請求按時間順序逐一分配到不同的后端服務器，如果后端服務器down 掉，能自動剔除。

2、weight

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

例如：

upstream bakend {

server 192.168.0.14 weight=10;