Nginx配置文件 nginx.conf詳解

# 定義Nginx運行的用戶和用戶組
# user nobady nobady;
# nginx進程數，建議設置爲等於CPU總核心數,默認爲1。
worker_processes 8;
#全局錯誤日誌定義類型，[ debug | info | notice | warn | error | crit ]
error_log /usr/local/nginx/logs/error.log info;
#進程pid文件,指定nginx進程運行文件存放地址
pid /usr/local/nginx/logs/nginx.pid;
# 指定進程可以打開的最大描述符：數目
# 工作模式與連接數上限
# 這個指令是指當一個nginx進程打開的最多文件描述符數目，理論值應該是最多打開文件數（ulimit -n）與nginx進程數相除，但是nginx分配請求並不是那麼均勻，所以最好與ulimit -n 的值保持一致。
# 現在在linux 2.6內核下開啓文件打開數爲65535，worker_rlimit_nofile就相應應該填寫65535。
#這是因爲nginx調度時分配請求到進程並不是那麼的均衡，所以假如填寫10240，總併發量達到3-4 萬時就有進程可能超過10240了，這時會返回502錯誤。
worker_rlimit_nofile 65535;

events
{
 #參考事件模型，use [ kqueue | rtsig | epoll | /dev/poll | select | poll]; epoll模型
 #是Linux 2.6以上版本內核中的高性能網絡I/O模型，linux建議epoll，如果跑在FreeBSD上面，就用kqueue模型。
 #補充說明：
 #與apache相類，nginx針對不同的操作系統，有不同的事件模型
 #A）標準事件模型
 #Select、poll屬於標準事件模型，如果當前系統不存在更有效的方法，nginx會選擇select或poll
 #B）高效事件模型
 #Kqueue：使用於FreeBSD 4.1+, OpenBSD 2.9+, NetBSD 2.0 和 MacOS X.使用雙處理器的MacOS X系統使用kqueue可能會造成內核崩潰。
 #Epoll：使用於Linux內核2.6版本及以後的系統。
 #/dev/poll：使用於Solaris 7 11/99+，HP/UX 11.22+ (eventport)，IRIX6.5.15+ 和 Tru64 UNIX 5.1A+。
 #Eventport：使用於Solaris 10。 爲了防止出現內核崩潰的問題， 有必要安裝安全補丁。
 use epoll;
 #單個進程最大連接數（最大連接數=連接數*進程數）
 #根據硬件調整，和前面工作進程配合起來用，儘量大，但是別把cpu跑到100%就行。每個進程允許的最多連接數，理論上每臺nginx服務器的最大連接數爲。
 worker_connections 65535;
 #keepalive超時時間，默認是60s，切記這個參數也不能設置過大！否則會導致許多無效的http連接佔據着nginx的連接數，終nginx崩潰！
 keepalive_timeout 60;
 #客戶端請求頭部的緩衝區大小。這個可以根據你的系統分頁大小來設置，一般一個請求頭的大小不會超過1k，不過由於一般系統分頁都要大於1k，所以這裏設置爲分頁大小。
 #分頁大小可以用命令getconf PAGESIZE 取得。
 #[root@web001 ~]# getconf PAGESIZE
 #4096
 #但也有client_header_buffer_size超過4k的情況，但是client_header_buffer_size該值必須設置爲“系統分頁大小”的整倍數。
 client_header_buffer_size 4k;
 #這個將爲打開文件指定緩存，默認是沒有啓用的，max指定緩存數量，建議和打開文件數一致，inactive是指經過多長時間文件沒被請求後刪除緩存。
 open_file_cache max=65535 inactive=60s;
 #這個是指多長時間檢查一次緩存的有效信息。
 #語法:open_file_cache_valid time 默認值:open_file_cache_valid 60 使用字段:http, server, location 這個指令指定了何時需要檢查open_file_cache中緩存項目的有效信息.
 open_file_cache_valid 60s;
 #open_file_cache指令中的inactive參數時間內文件的最少使用次數，如果超過這個數字，文件描述符一直是在緩存中打開的，如上例，如果有一個文件在inactive時間內一次沒被使用，它將被移除。
 #語法:open_file_cache_min_uses number 默認值:open_file_cache_min_uses 1使用字段:http, server, location 這個指令指定了在open_file_cache指令無效的參數中一定的時間範圍內可以使用的最小文件數,如果使用更大的值,文件描述符在cache中總是打開狀態.
 open_file_cache_min_uses 1;
#語法:open_file_cache_errors on | off 默認值:open_file_cache_errors off使用字段:http, server, location 這個指令指定是否在搜索一個文件是記錄cache錯誤.
 open_file_cache_errors on;
}

#設定http服務器，利用它的反向代理功能提供負載均衡支持
http
{
 #文件擴展名與文件類型映射表
 include mime.types;
 #默認文件類型
 default_type application/octet-stream;
 #默認編碼
 #charset utf-8;
 #服務器名字的hash表大小
 #保存服務器名字的hash表是由指令server_names_hash_max_size 和server_names_hash_bucket_size所控制的。參數hash bucket size總是等於hash表的大小，並且是一路處理器緩存大小的倍數。在減少了在內存中的存取次數後，使在處理器中加速查找hash表鍵值成爲可能。如果hash bucket size等於一路處理器緩存的大小，那麼在查找鍵的時候，最壞的情況下在內存中查找的次數爲2。第一次是確定存儲單元的地址，第二次是在存儲單元中查找鍵 值。因此，如果Nginx給出需要增大hash max size 或 hash bucket size的提示，那麼首要的是增大前一個參數的大小.
 server_names_hash_bucket_size 128;
 #客戶端請求頭部的緩衝區大小。這個可以根據你的系統分頁大小來設置，一般一個請求的頭部大小不會超過1k，不過由於一般系統分頁都要大於1k，所以這裏設置爲分頁大小。分頁大小可以用命令getconf PAGESIZE取得。
 client_header_buffer_size 32k;
 #客戶請求頭緩衝大小。nginx默認會用client_header_buffer_size這個buffer來讀取header值，如果header過大，它會使用large_client_header_buffers來讀取。
 large_client_header_buffers 4 64k;
 #設定通過nginx上傳文件的大小
 client_max_body_size 8m;
 #開啓高效文件傳輸模式，sendfile指令指定nginx是否調用sendfile函數來輸出文件，對於普通應用設爲 on，如果用來進行下載等應用磁盤IO重負載應用，可設置爲off，以平衡磁盤與網絡I/O處理速度，降低系統的負載。注意：如果圖片顯示不正常把這個改成off。
 #sendfile指令指定 nginx 是否調用sendfile 函數（zero copy 方式）來輸出文件，對於普通應用，必須設爲on。如果用來進行下載等應用磁盤IO重負載應用，可設置爲off，以平衡磁盤與網絡IO處理速度，降低系統uptime。
 sendfile on;
 #開啓目錄列表訪問，合適下載服務器，默認關閉。
 autoindex on;
 #此選項允許或禁止使用socke的TCP_CORK的選項，此選項僅在使用sendfile的時候使用,告訴nginx在一個數據包裏發送所有頭文件，而不一個接一個的發送。就是說數據包不會馬上傳送出去，等到數據包最大時，一次性的傳輸出去，這樣有助於解決網絡堵塞
 tcp_nopush on;
#告訴nginx不要緩存數據，而是一段一段的發送--當需要及時發送數據時，就應該給應用設置這個屬性，這樣發送一小塊數據信息時就不能立即得到返回值
 tcp_nodelay on;
 #長連接超時時間，單位是秒
 keepalive_timeout 120;
 #FastCGI相關參數是爲了改善網站的性能：減少資源佔用，提高訪問速度。下面參數看字面意思都能理解。
 #這個指令爲FastCGI緩存指定一個路徑，目錄結構等級，關鍵字區域存儲時間和非活動刪除時間
 fastcgi_cache_path /usr/local/nginx/fastcgi_cache levels=1:2
 keys_zone=TEST:10m inactive=5m;
 #指定連接到後端FastCGI的超時時間
 fastcgi_connect_timeout 300;
 #向FastCGI傳送請求的超時時間，這個值是指已經完成兩次握手後向FastCGI傳送請求的超時時間
 fastcgi_send_timeout 300;
 #接收FastCGI應答的超時時間，這個值是指已經完成兩次握手後接收FastCGI應答的超時時間
 fastcgi_read_timeout 300;
 #指定讀取FastCGI應答第一部分 需要用多大的緩衝區,這裏可以設置爲fastcgi_buffers指令指定的緩衝區大小，上面的指令指定它將使用1個 16k的緩衝區去讀取應答的第一部分，即應答頭，其實這個應答頭一般情況下都很小（不會超過1k），但是你如果在fastcgi_buffers指令中指定了緩衝區的大小，那麼它也會分配一個fastcgi_buffers指定的緩衝區大小去緩存
 fastcgi_buffer_size 64k;
 #指定本地需要用多少和多大的緩衝區來 緩衝FastCGI的應答，如上所示，如果一個php腳本所產生的頁面大小爲256k，則會爲其分配16個16k的緩衝區來緩存，如果大於256k，增大 於256k的部分會緩存到fastcgi_temp指定的路徑中， 當然這對服務器負載來說是不明智的方案，因爲內存中處理數據速度要快於硬盤，通常這個值 的設置應該選擇一個你的站點中的php腳本所產生的頁面大小的中間值，比如你的站點大部分腳本所產生的頁面大小爲 256k就可以把這個值設置爲16 16k，或者464k 或者64 4k，但很顯然，後兩種並不是好的設置方法，因爲如果產生的頁面只有32k，如果用464k它會分配1個64k的緩衝區去緩存，而如果使用64 4k它會分配8個4k的緩衝區去緩存，而如果使用16 16k則它會分配2個16k去緩存頁面，這樣看起來似乎更加合理•
 fastcgi_buffers 4 64k;
 #這個指令我也不知道是做什麼用，只知道默認值是fastcgi_buffers的兩倍
 fastcgi_busy_buffers_size 128k;
 #在寫入fastcgi_temp_path時將用多大的數據塊，默認值是fastcgi_buffers的兩倍
 fastcgi_temp_file_write_size 128k;
 #開啓FastCGI緩存並且爲其制定一個名稱。個人感覺開啓緩存非常有用，可以有效降低CPU負載，並且防止502錯誤。但是這個緩存會引起很多問題，因爲它緩存的是動態頁面。具體使用還需根據自己的需求
 fastcgi_cache TEST
 #爲指定的應答代碼指定緩存時間，如上例中將200，302應答緩存一小時，301應答緩存1天，其他爲1分鐘
 fastcgi_cache_valid 200 302 1h;
 fastcgi_cache_valid 301 1d;
 fastcgi_cache_valid any 1m;
 #緩存在fastcgi_cache_path指令inactive參數值時間內的最少使用次數，如上例，如果在5分鐘內某文件1次也沒有被使用，那麼這個文件將被移除
 fastcgi_cache_min_uses 1;
 #gzip模塊設置
 #開啓壓縮 
gzip  on;  
 # 設置允許壓縮的頁面最小字節數，頁面字節數從header頭得content-length中進行獲取。默認值是0，不管頁面多大都壓縮。建議設置成大於2k的字節數，小於2k可能會越壓越大。
gzip_min_length 2k; 
 # 設置系統獲取幾個單位的緩存用於存儲gzip的壓縮結果數據流。 例如 4 4k 代表以4k爲單位，按照原始數據大小以4k爲單位的4倍申請內存。 4 8k 代表以8k爲單位，按照原始數據大小以8k爲單位的4倍申請內存。 
 # 如果沒有設置，默認值是申請跟原始數據相同大小的內存空間去存儲gzip壓縮結果。 
 gzip_buffers 4 16k; 
 #壓縮級別，1-10，數字越大壓縮的越好，也越佔用CPU時間 
 gzip_comp_level 5; 
 # 默認值: gzip_types text/html (默認不對js/css文件進行壓縮) 
 # 壓縮類型，匹配MIME類型進行壓縮 
 # 不能用通配符 text/* 
 # (無論是否指定)text/html默認已經壓縮  
 # 設置哪壓縮種文本文件可參考 conf/mime.types 
 gzip_types text/plain application/x-
 javascript text/css application/xml;
 # 值爲1.0和1.1 代表是否壓縮http協議1.0，選擇1.0則1.0和1.1都可以壓縮 
 gzip_http_version 1.0  
 # IE6及以下禁止壓縮 
 gzip_disable "MSIE [1-6]\.";  
 # 默認值：off 
 # Nginx作爲反向代理的時候啓用，開啓或者關閉後端服務器返回的結果，匹配的前提是後端服務器必須要返回包含"Via"的 header頭。 
 # off - 關閉所有的代理結果數據的壓縮 
 # expired - 啓用壓縮，如果header頭中包含 "Expires" 頭信息 
 # no-cache - 啓用壓縮，如果header頭中包含 "Cache-Control:no-cache" 頭信息 
 # no-store - 啓用壓縮，如果header頭中包含 "Cache-Control:no-store" 頭信息 
 # private - 啓用壓縮，如果header頭中包含 "Cache-Control:private" 頭信息 
 # no_last_modified - 啓用壓縮,如果header頭中不包含 "Last-Modified" 頭信息 
 # no_etag - 啓用壓縮 ,如果header頭中不包含 "ETag" 頭信息 
 # auth - 啓用壓縮 , 如果header頭中包含 "Authorization" 頭信息 
 # any - 無條件啓用壓縮 
 gzip_proxied expired no-cache no-store private auth; 
 # 給CDN和代理服務器使用，針對相同url，可以根據頭信息返回壓縮和非壓縮副本 
 gzip_vary on; 
 #開啓限制IP連接數的時候需要使用
 #limit_zone crawler $binary_remote_addr 10m;
 #負載均衡配置
 upstream www.xx.com {
 
   #upstream的負載均衡，weight是權重，可以根據機器配置定義權重。weigth參數表示權值，權值越高被分配到的機率越大。
   server 192.168.80.121:80 weight=3;
   server 192.168.80.122:80 weight=2;
   server 192.168.80.123:80 weight=3;
   #nginx的upstream目前支持4種方式的分配
   #1、輪詢（默認）
   #每個請求按時間順序逐一分配到不同的後端服務器，如果後端服務器down掉，能自動剔除。
   #2、weight
   #指定輪詢機率，weight和訪問比率成正比，用於後端服務器性能不均的情況。
   #例如：
#upstream bakend {
   #  server 192.168.0.14 weight=10;
   #  server 192.168.0.15 weight=10;
   #}
   #2、ip_hash
   #每個請求按訪問ip的hash結果分配，這樣每個訪客固定訪問一個後端服務器，可以解決session的問題。
   #例如：
   #upstream bakend {
   #  ip_hash;
   #  server 192.168.0.14:88;
   #  server 192.168.0.15:80;
   #}
   #3、fair（第三方）
   #按後端服務器的響應時間來分配請求，響應時間短的優先分配。
   #upstream backend {
   #  server server1;
   #  server server2;
   #  fair;
   #}
   #4、url_hash（第三方）
   #按訪問url的hash結果來分配請求，使每個url定向到同一個後端服務器，後端服務器爲緩存時比較有效。
   #例：在upstream中加入hash語句，server語句中不能寫入weight等其他的參數，hash_method是使用的hash算法
   #upstream backend {
   #  server squid1:3128;
   #  server squid2:3128;
   #  hash $request_uri;
   #  hash_method crc32;
   #}
   #tips:
   #upstream bakend{#定義負載均衡設備的Ip及設備狀態}{
   #  ip_hash;
   #  server 127.0.0.1:9090 down;
   #  server 127.0.0.1:8080 weight=2;
   #  server 127.0.0.1:6060;
   #  server 127.0.0.1:7070 backup;
   #}
   #在需要使用負載均衡的server中增加 proxy_pass http://bakend/;
   #每個設備的狀態設置爲:
   #1.down表示單前的server暫時不參與負載
   #2.weight爲weight越大，負載的權重就越大。
   #3.max_fails：允許請求失敗的次數默認爲1.當超過最大次數時，返回proxy_next_upstream模塊定義的錯誤
   #4.fail_timeout:max_fails次失敗後，暫停的時間。
   #5.backup： 其它所有的非backup機器down或者忙的時候，請求backup機器。所以這臺機器壓力會最輕。
   #nginx支持同時設置多組的負載均衡，用來給不用的server來使用。
   #client_body_in_file_only設置爲On 可以講client post過來的數據記錄到文件中用來做debug
   #client_body_temp_path設置記錄文件的目錄 可以設置最多3層目錄
   #location對URL進行匹配.可以進行重定向或者進行新的代理 負載均衡
 }
#虛擬主機的配置
 server
 {
   #監聽端口
   listen 80;
   #域名可以有多個，用空格隔開
   server_name www.xx.com xx.com;
   index index.html index.htm index.php;
   root /data/www/xx;
   #對******進行負載均衡
   location ~ .*.(php|php5)?$
   {
     fastcgi_pass 127.0.0.1:9000;
     fastcgi_index index.php;
     include fastcgi.conf;
   }
   
   #圖片緩存時間設置
   location ~ .*.(gif|jpg|jpeg|png|bmp|swf)$
   {
     expires 10d;
   }
   
   #JS和CSS緩存時間設置
   location ~ .*.(js|css)?$
   {
     expires 1h;
   }
   
   #日誌格式設定
   #$remote_addr與$http_x_forwarded_for用以記錄客戶端的ip地址；
   #$remote_user：用來記錄客戶端用戶名稱；
   #$time_local： 用來記錄訪問時間與時區；
   #$request： 用來記錄請求的url與http協議；
   #$status： 用來記錄請求狀態；成功是200，
   #$body_bytes_sent ：記錄發送給客戶端文件主體內容大小；
   #$http_referer：用來記錄從那個頁面鏈接訪問過來的；
   #$http_user_agent：記錄客戶瀏覽器的相關信息；
   #通常web服務器放在反向代理的後面，這樣就不能獲取到客戶的IP地址了，通過$remote_add拿到的IP地址是反向代理服務器的iP地址。
   #反向代理服務器在轉發請求的http頭信息中，可以增加x_forwarded_for信息，用以記錄原有客戶端的IP地址和原來客戶端的請求的服務器地址。
   log_format access '$remote_addr - $remote_user [$time_local]
   "$request" '
   '$status $body_bytes_sent "$http_referer" '
   '"$http_user_agent" $http_x_forwarded_for';
   
   #定義本虛擬主機的訪問日誌
   access_log /usr/local/nginx/logs/host.access.log main;
   access_log /usr/local/nginx/logs/host.access.404.log log404;
   
   #對 "/" 啓用反向代理
   location / {
     proxy_pass http://127.0.0.1:88;
     proxy_redirect off;
     proxy_set_header X-Real-IP $remote_addr;
     
     #後端的Web服務器可以通過X-Forwarded-For獲取用戶真實IP
     proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
     
     #以下是一些反向代理的配置，可選。
     proxy_set_header Host $host;
     #允許客戶端請求的最大單文件字節數
     client_max_body_size 10m;
     #緩衝區代理緩衝用戶端請求的最大字節數，
     #如果把它設置爲比較大的數值，例如256k，那麼，無論使用firefox還是IE瀏覽器，來提交任意小於256k的圖片，都很正常。如果註釋該指令，使用默認的client_body_buffer_size設置，也就是操作系統頁面大小的兩倍，8k或者16k，問題就出現了。
     #無論使用firefox4.0還是IE8.0，提交一個比較大，200k左右的圖片，都返回
     500 Internal Server Error錯誤
     client_body_buffer_size 128k;
     #表示使nginx阻止HTTP應答代碼爲400或者更高的應答。
     proxy_intercept_errors on;
     #後端服務器連接的超時時間_發起握手等候響應超時時間
     #nginx跟後端服務器連接超時時間(代理連接超時)
     proxy_connect_timeout 90;
     #後端服務器數據回傳時間(代理髮送超時)
     #後端服務器數據回傳時間_就是在規定時間之內後端服務器必須傳完所有的數據
     proxy_send_timeout 90;
     #連接成功後，後端服務器響應時間(代理接收超時)
     #連接成功後_等候後端服務器響應時間_其實已經進入後端的排隊之中等候處理（也可以說是後端服務器處理請求的時間）
     proxy_read_timeout 90;
     #設置代理服務器（nginx）保存用戶頭信息的緩衝區大小
     #設置從被代理服務器讀取的第一部分應答的緩衝區大小，通常情況下這部分應答中包含一個小的應答頭，默認情況下這個值的大小爲指令proxy_buffers中指定的一個緩衝區的大小，不過可以將其設置爲更小
     proxy_buffer_size 4k;
     #proxy_buffers緩衝區，網頁平均在32k以下的設置
     #設置用於讀取應答（來自被代理服務器）的緩衝區數目和大小，默認情況也爲分頁大小，根據操作系統的不同可能是4k或者8k
     proxy_buffers 4 32k;
     #高負荷下緩衝大小（proxy_buffers*2）
     proxy_busy_buffers_size 64k;
     #設置在寫入proxy_temp_path時數據的大小，預防一個工作進程在傳遞文件時阻塞太長
     #設定緩存文件夾大小，大於這個值，將從upstream服務器傳
     proxy_temp_file_write_size 64k;
   }
   
   
   #設定查看Nginx狀態的地址
    location /NginxStatus {
     stub_status on;
     access_log on;
     auth_basic "NginxStatus";
     auth_basic_user_file confpasswd;
     #htpasswd文件的內容可以用apache提供的htpasswd工具來產生。
   }
   
   #本地動靜分離反向代理配置
   #所有jsp的頁面均交由tomcat或resin處理
   location ~ .(jsp|jspx|do)?$ {
     proxy_set_header Host $host;
     proxy_set_header X-Real-IP $remote_addr;
     proxy_set_header X-Forwarded-For 
    $proxy_add_x_forwarded_for;
     proxy_pass http://127.0.0.1:8080;
   }
   
   #所有靜態文件由nginx直接讀取不經過tomcat或resin
   location ~ .*.
  (htm|html|gif|jpg|jpeg|png|bmp|swf|ioc|rar|zip|txt|flv|mid|doc|ppt|
   pdf|xls|mp3|wma)$
   {
     expires 15d;
   }
   
   location ~ .*.(js|css)?$
   {
     expires 1h;
   }
 }
}