1. 程式人生 > >nginx中conf下的nginx.conf詳解

nginx中conf下的nginx.conf詳解

  1 ######Nginx配置檔案nginx.conf中文詳解#####
  2 
  3 #定義Nginx執行的使用者和使用者組
  4 user www www;
  5 
  6 #nginx程序數,建議設定為等於CPU總核心數。
  7 worker_processes 8;
  8  
  9 #全域性錯誤日誌定義型別,[ debug | info | notice | warn | error | crit ]
 10 error_log /usr/local/nginx/logs/error.log info;
 11 
 12 #程序pid檔案
 13 pid /usr/local/nginx/logs/nginx.pid;
14 15 #指定程序可以開啟的最大描述符:數目 16 #工作模式與連線數上限 17 #這個指令是指當一個nginx程序開啟的最多檔案描述符數目,理論值應該是最多開啟檔案數(ulimit -n)與nginx程序數相除,但是nginx分配請求並不是那麼均勻,所以最好與ulimit -n 的值保持一致。 18 #現在在linux 2.6核心下開啟檔案開啟數為65535,worker_rlimit_nofile就相應應該填寫65535。 19 #這是因為nginx排程時分配請求到程序並不是那麼的均衡,所以假如填寫10240,總併發量達到3-4萬時就有程序可能超過10240了,這時會返回502錯誤。
20 worker_rlimit_nofile 65535; 21 22 23 events 24 { 25 #參考事件模型,use [ kqueue | rtsig | epoll | /dev/poll | select | poll ]; epoll模型 26 #是Linux 2.6以上版本核心中的高效能網路I/O模型,linux建議epoll,如果跑在FreeBSD上面,就用kqueue模型。 27 #補充說明: 28 #與apache相類,nginx針對不同的作業系統,有不同的事件模型 29 #A)標準事件模型
30 #Select、poll屬於標準事件模型,如果當前系統不存在更有效的方法,nginx會選擇select或poll 31 #B)高效事件模型 32 #Kqueue:使用於FreeBSD 4.1+, OpenBSD 2.9+, NetBSD 2.0 和 MacOS X.使用雙處理器的MacOS X系統使用kqueue可能會造成核心崩潰。 33 #Epoll:使用於Linux核心2.6版本及以後的系統。 34 #/dev/poll:使用於Solaris 7 11/99+,HP/UX 11.22+ (eventport),IRIX 6.5.15+ 和 Tru64 UNIX 5.1A+。 35 #Eventport:使用於Solaris 10。 為了防止出現核心崩潰的問題, 有必要安裝安全補丁。 36 use epoll; 37 38 #單個程序最大連線數(最大連線數=連線數*程序數) 39 #根據硬體調整,和前面工作程序配合起來用,儘量大,但是別把cpu跑到100%就行。每個程序允許的最多連線數,理論上每臺nginx伺服器的最大連線數為。 40 worker_connections 65535; 41 42 #keepalive超時時間。 43 keepalive_timeout 60; 44 45 #客戶端請求頭部的緩衝區大小。這個可以根據你的系統分頁大小來設定,一般一個請求頭的大小不會超過1k,不過由於一般系統分頁都要大於1k,所以這裡設定為分頁大小。 46 #分頁大小可以用命令getconf PAGESIZE 取得。 47 #[[email protected] ~]# getconf PAGESIZE 48 #4096 49 #但也有client_header_buffer_size超過4k的情況,但是client_header_buffer_size該值必須設定為“系統分頁大小”的整倍數。 50 client_header_buffer_size 4k; 51 52 #這個將為開啟檔案指定快取,預設是沒有啟用的,max指定快取數量,建議和開啟檔案數一致,inactive是指經過多長時間檔案沒被請求後刪除快取。 53 open_file_cache max=65535 inactive=60s; 54 55 #這個是指多長時間檢查一次快取的有效資訊。 56 #語法:open_file_cache_valid time 預設值:open_file_cache_valid 60 使用欄位:http, server, location 這個指令指定了何時需要檢查open_file_cache中快取專案的有效資訊. 57 open_file_cache_valid 80s; 58 59 #open_file_cache指令中的inactive引數時間內檔案的最少使用次數,如果超過這個數字,檔案描述符一直是在快取中開啟的,如上例,如果有一個檔案在inactive時間內一次沒被使用,它將被移除。 60 #語法:open_file_cache_min_uses number 預設值:open_file_cache_min_uses 1 使用欄位:http, server, location 這個指令指定了在open_file_cache指令無效的引數中一定的時間範圍內可以使用的最小檔案數,如果使用更大的值,檔案描述符在cache中總是開啟狀態. 61 open_file_cache_min_uses 1; 62 63 #語法:open_file_cache_errors on | off 預設值:open_file_cache_errors off 使用欄位:http, server, location 這個指令指定是否在搜尋一個檔案是記錄cache錯誤. 64 open_file_cache_errors on; 65 } 66 67 68 69 #設定http伺服器,利用它的反向代理功能提供負載均衡支援 70 http 71 { 72 #副檔名與檔案型別對映表 73 include mime.types; 74 75 #預設檔案型別 76 default_type application/octet-stream; 77 78 #預設編碼 79 #charset utf-8; 80 81 #伺服器名字的hash表大小 82 #儲存伺服器名字的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的提示,那麼首要的是增大前一個引數的大小. 83 server_names_hash_bucket_size 128; 84 85 #客戶端請求頭部的緩衝區大小。這個可以根據你的系統分頁大小來設定,一般一個請求的頭部大小不會超過1k,不過由於一般系統分頁都要大於1k,所以這裡設定為分頁大小。分頁大小可以用命令getconf PAGESIZE取得。 86 client_header_buffer_size 32k; 87 88 #客戶請求頭緩衝大小。nginx預設會用client_header_buffer_size這個buffer來讀取header值,如果header過大,它會使用large_client_header_buffers來讀取。 89 large_client_header_buffers 4 64k; 90 91 #設定通過nginx上傳檔案的大小 92 client_max_body_size 8m; 93 94 #開啟高效檔案傳輸模式,sendfile指令指定nginx是否呼叫sendfile函式來輸出檔案,對於普通應用設為 on,如果用來進行下載等應用磁碟IO重負載應用,可設定為off,以平衡磁碟與網路I/O處理速度,降低系統的負載。注意:如果圖片顯示不正常把這個改成off。 95 #sendfile指令指定 nginx 是否呼叫sendfile 函式(zero copy 方式)來輸出檔案,對於普通應用,必須設為on。如果用來進行下載等應用磁碟IO重負載應用,可設定為off,以平衡磁碟與網路IO處理速度,降低系統uptime。 96 sendfile on; 97 98 #開啟目錄列表訪問,合適下載伺服器,預設關閉。 99 autoindex on; 100 101 #此選項允許或禁止使用socke的TCP_CORK的選項,此選項僅在使用sendfile的時候使用 102 tcp_nopush on; 103 104 tcp_nodelay on; 105 106 #長連線超時時間,單位是秒 107 keepalive_timeout 120; 108 109 #FastCGI相關引數是為了改善網站的效能:減少資源佔用,提高訪問速度。下面引數看字面意思都能理解。 110 fastcgi_connect_timeout 300; 111 fastcgi_send_timeout 300; 112 fastcgi_read_timeout 300; 113 fastcgi_buffer_size 64k; 114 fastcgi_buffers 4 64k; 115 fastcgi_busy_buffers_size 128k; 116 fastcgi_temp_file_write_size 128k; 117 118 #gzip模組設定 119 gzip on; #開啟gzip壓縮輸出 120 gzip_min_length 1k; #最小壓縮檔案大小 121 gzip_buffers 4 16k; #壓縮緩衝區 122 gzip_http_version 1.0; #壓縮版本(預設1.1,前端如果是squid2.5請使用1.0) 123 gzip_comp_level 2; #壓縮等級 124 gzip_types text/plain application/x-javascript text/css application/xml; #壓縮型別,預設就已經包含textml,所以下面就不用再寫了,寫上去也不會有問題,但是會有一個warn。 125 gzip_vary on; 126 127 #開啟限制IP連線數的時候需要使用 128 #limit_zone crawler $binary_remote_addr 10m; 129 130 131 132 #負載均衡配置 133 upstream jh.w3cschool.cn { 134 135 #upstream的負載均衡,weight是權重,可以根據機器配置定義權重。weigth引數表示權值,權值越高被分配到的機率越大。 136 server 192.168.80.121:80 weight=3; 137 server 192.168.80.122:80 weight=2; 138 server 192.168.80.123:80 weight=3; 139 140 #nginx的upstream目前支援4種方式的分配 141 #1、輪詢(預設) 142 #每個請求按時間順序逐一分配到不同的後端伺服器,如果後端伺服器down掉,能自動剔除。 143 #2、weight 144 #指定輪詢機率,weight和訪問比率成正比,用於後端伺服器效能不均的情況。 145 #例如: 146 #upstream bakend { 147 # server 192.168.0.14 weight=10; 148 # server 192.168.0.15 weight=10; 149 #} 150 #2、ip_hash 151 #每個請求按訪問ip的hash結果分配,這樣每個訪客固定訪問一個後端伺服器,可以解決session的問題。 152 #例如: 153 #upstream bakend { 154 # ip_hash; 155 # server 192.168.0.14:88; 156 # server 192.168.0.15:80; 157 #} 158 #3、fair(第三方) 159 #按後端伺服器的響應時間來分配請求,響應時間短的優先分配。 160 #upstream backend { 161 # server server1; 162 # server server2; 163 # fair; 164 #} 165 #4、url_hash(第三方) 166 #按訪問url的hash結果來分配請求,使每個url定向到同一個後端伺服器,後端伺服器為快取時比較有效。 167 #例:在upstream中加入hash語句,server語句中不能寫入weight等其他的引數,hash_method是使用的hash演算法 168 #upstream backend { 169 # server squid1:3128; 170 # server squid2:3128; 171 # hash $request_uri; 172 # hash_method crc32; 173 #} 174 175 #tips: 176 #upstream bakend{#定義負載均衡裝置的Ip及裝置狀態}{ 177 # ip_hash; 178 # server 127.0.0.1:9090 down; 179 # server 127.0.0.1:8080 weight=2; 180 # server 127.0.0.1:6060; 181 # server 127.0.0.1:7070 backup; 182 #} 183 #在需要使用負載均衡的server中增加 proxy_pass http://bakend/; 184 185 #每個裝置的狀態設定為: 186 #1.down表示單前的server暫時不參與負載 187 #2.weight為weight越大,負載的權重就越大。 188 #3.max_fails:允許請求失敗的次數預設為1.當超過最大次數時,返回proxy_next_upstream模組定義的錯誤 189 #4.fail_timeout:max_fails次失敗後,暫停的時間。 190 #5.backup: 其它所有的非backup機器down或者忙的時候,請求backup機器。所以這臺機器壓力會最輕。 191 192 #nginx支援同時設定多組的負載均衡,用來給不用的server來使用。 193 #client_body_in_file_only設定為On 可以講client post過來的資料記錄到檔案中用來做debug 194 #client_body_temp_path設定記錄檔案的目錄 可以設定最多3層目錄 195 #location對URL進行匹配.可以進行重定向或者進行新的代理 負載均衡 196 } 197 198 199 200 #虛擬主機的配置 201 server 202 { 203 #監聽埠 204 listen 80; 205 206 #域名可以有多個,用空格隔開 207 server_name www.w3cschool.cn w3cschool.cn; 208 index index.html index.htm index.php; 209 root /data/www/w3cschool; 210 211 #對******進行負載均衡 212 location ~ .*.(php|php5)?$ 213 { 214 fastcgi_pass 127.0.0.1:9000; 215 fastcgi_index index.php; 216 include fastcgi.conf; 217 } 218 219 #圖片快取時間設定 220 location ~ .*.(gif|jpg|jpeg|png|bmp|swf)$ 221 { 222 expires 10d; 223 } 224 225 #JS和CSS快取時間設定 226 location ~ .*.(js|css)?$ 227 { 228 expires 1h; 229 } 230 231 #日誌格式設定 232 #$remote_addr與$http_x_forwarded_for用以記錄客戶端的ip地址; 233 #$remote_user:用來記錄客戶端使用者名稱稱; 234 #$time_local: 用來記錄訪問時間與時區; 235 #$request: 用來記錄請求的url與http協議; 236 #$status: 用來記錄請求狀態;成功是200, 237 #$body_bytes_sent :記錄傳送給客戶端檔案主體內容大小; 238 #$http_referer:用來記錄從那個頁面連結訪問過來的; 239 #$http_user_agent:記錄客戶瀏覽器的相關資訊; 240 #通常web伺服器放在反向代理的後面,這樣就不能獲取到客戶的IP地址了,通過$remote_add拿到的IP地址是反向代理伺服器的iP地址。反向代理伺服器在轉發請求的http頭資訊中,可以增加x_forwarded_for資訊,用以記錄原有客戶端的IP地址和原來客戶端的請求的伺服器地址。 241 log_format access '$remote_addr - $remote_user [$time_local] "$request" ' 242 '$status $body_bytes_sent "$http_referer" ' 243 '"$http_user_agent" $http_x_forwarded_for'; 244 245 #定義本虛擬主機的訪問日誌 246 access_log /usr/local/nginx/logs/host.access.log main; 247 access_log /usr/local/nginx/logs/host.access.404.log log404; 248 249 #對 "/" 啟用反向代理 250 location / { 251 proxy_pass http://127.0.0.1:88; 252 proxy_redirect off; 253 proxy_set_header X-Real-IP $remote_addr; 254 255 #後端的Web伺服器可以通過X-Forwarded-For獲取使用者真實IP 256 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; 257 258 #以下是一些反向代理的配置,可選。 259 proxy_set_header Host $host; 260 261 #允許客戶端請求的最大單檔案位元組數 262 client_max_body_size 10m; 263 264 #緩衝區代理緩衝使用者端請求的最大位元組數, 265 #如果把它設定為比較大的數值,例如256k,那麼,無論使用firefox還是IE瀏覽器,來提交任意小於256k的圖片,都很正常。如果註釋該指令,使用預設的client_body_buffer_size設定,也就是作業系統頁面大小的兩倍,8k或者16k,問題就出現了。 266 #無論使用firefox4.0還是IE8.0,提交一個比較大,200k左右的圖片,都返回500 Internal Server Error錯誤 267 client_body_buffer_size 128k; 268 269 #表示使nginx阻止HTTP應答程式碼為400或者更高的應答。 270 proxy_intercept_errors on; 271 272 #後端伺服器連線的超時時間_發起握手等候響應超時時間 273 #nginx跟後端伺服器連線超時時間(代理連線超時) 274 proxy_connect_timeout 90; 275 276 #後端伺服器資料回傳時間(代理髮送超時) 277 #後端伺服器資料回傳時間_就是在規定時間之內後端伺服器必須傳完所有的資料 278 proxy_send_timeout 90; 279 280 #連線成功後,後端伺服器響應時間(代理接收超時) 281 #連線成功後_等候後端伺服器響應時間_其實已經進入後端的排隊之中等候處理(也可以說是後端伺服器處理請求的時間) 282 proxy_read_timeout 90; 283 284 #設定代理伺服器(nginx)儲存使用者頭資訊的緩衝區大小 285 #設定從被代理伺服器讀取的第一部分應答的緩衝區大小,通常情況下這部分應答中包含一個小的應答頭,預設情況下這個值的大小為指令proxy_buffers中指定的一個緩衝區的大小,不過可以將其設定為更小 286 proxy_buffer_size 4k; 287 288 #proxy_buffers緩衝區,網頁平均在32k以下的設定 289 #設定用於讀取應答(來自被代理伺服器)的緩衝區數目和大小,預設情況也為分頁大小,根據作業系統的不同可能是4k或者8k 290 proxy_buffers 4 32k; 291 292 #高負荷下緩衝大小(proxy_buffers*2) 293 proxy_busy_buffers_size 64k; 294 295 #設定在寫入proxy_temp_path時資料的大小,預防一個工作程序在傳遞檔案時阻塞太長 296 #設定快取資料夾大小,大於這個值,將從upstream伺服器傳 297 proxy_temp_file_write_size 64k; 298 } 299 300 301 #設定檢視Nginx狀態的地址 302 location /NginxStatus { 303 stub_status on; 304 access_log on; 305 auth_basic "NginxStatus"; 306 auth_basic_user_file confpasswd; 307 #htpasswd檔案的內容可以用apache提供的htpasswd工具來產生。 308 } 309 310 #本地動靜分離反向代理配置 311 #所有jsp的頁面均交由tomcat或resin處理 312 location ~ .(jsp|jspx|do)?$ { 313 proxy_set_header Host $host; 314 proxy_set_header X-Real-IP $remote_addr; 315 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; 316 proxy_pass http://127.0.0.1:8080; 317 } 318 319 #所有靜態檔案由nginx直接讀取不經過tomcat或resin 320 location ~ .*.(htm|html|gif|jpg|jpeg|png|bmp|swf|ioc|rar|zip|txt|flv|mid|doc|ppt| 321 pdf|xls|mp3|wma)$ 322 { 323 expires 15d; 324 } 325 326 location ~ .*.(js|css)?$ 327 { 328 expires 1h; 329 } 330 } 331 } 332 ######Nginx配置檔案nginx.conf中文詳解##### 333 334 nginx.conf詳解