nginx配置文件詳解

nginx的配置文件結構：

nginx有模塊組成，這寫模塊有配置文件中指定的指令控制。指令分爲簡單指令和塊指令，一個簡單的指令包由空格分隔的名稱和參數，以分號（：）結尾。塊指令與簡單指令具備相同的結構可是他們不是以：號結尾而是以大括號結尾（{}）包圍的 一組附加指令結束若是塊指令能夠在大括號內包含其餘指令，則稱爲上下文（示例： events， http， server和 location）。
放置在任何上下文以外的配置文件中的指令被認爲是在 主上下文中。在events和http指令駐留在main上下文server 中http，並location在 server。

 提供靜態內容：

一個重要的web服務器任務是提供文件（列入圖像或者靜態html文件）。你將實現一個示例，根據需求，將從不一樣的本地目錄/data/www(可能包含html文件)和/data/image(包含圖像)提供文件。這須要編輯配置文件並使用兩個位置塊在http塊內設置服務器塊

首先建立/data/www目錄並將index。html包含如下文本內容的文件放在其中，主要註釋掉了，如今註釋掉全部這些塊並開始一個新server塊：

http{
      服務器{}      
}

一般，配置文件能夠包括由它們監聽的端口和 服務器名稱區分的若干 server塊 。一旦nginx決定對請求進行處理，它就會根據塊內定義的指令 參數測試請求頭中指定的URI 。 serverlocationserver

將如下location塊添加到 server塊中：

地點 / {
    root / data / www;
}

此location塊指定/與請求中的URI進行比較的「 」前綴。對於匹配請求，URI將添加到root 指令中指定的路徑 ，即to /data/www，以造成本地文件系統上所請求文件的路徑。若是存在多個匹配location塊，則nginx選擇具備最長前綴的塊。location上面的塊提供長度爲1的最短前綴，所以只有當全部其餘location 塊都沒法提供匹配時，纔會使用此塊。

接下來，添加第二個location塊：

location / images / {
    根/數據;
}

它將匹配以...開頭的請求/images/ （location /也匹配此類請求，但前綴更短）。

 

server塊 的結果配置應以下所示：

服務器{
    地點 / {
        root / data / www;
    }

    location / images / {
        根/數據;
    }
}

這已是服務器的工做配置，它能夠偵聽標準端口80，而且能夠在本地計算機上訪問 http://localhost/。爲響應以URI開頭的請求/images/，服務器將從/data/images目錄發送文件。例如，響應http://localhost/images/example.png請求nginx將發送/data/images/example.png文件。若是此類文件不存在，nginx將發送指示404錯誤的響應。不以URI開頭的請求/images/將映射到/data/www目錄。例如，響應http://localhost/some/example.html請求nginx將發送/data/www/some/example.html文件。

要應用新配置，請啓動nginx（若是還沒有啓動）或reload經過執行如下命令將信號發送到nginx的主進程

nginx -s reload
在一些狀況下不按預期工做，您能夠嘗試找出緣由和 目錄中的文件或 。access.logerror.log/usr/local/nginx/logs/var/log/nginx

 

user nginx nginxnginx用戶及組:用戶 組worker_process 8;工做進程:數目.根據硬件調整,一般等於cpu數量或者2倍於cpu.error_log log/error.log;error_log logs/error.log notice;error_log logs/error.log info;錯誤日誌存放路徑pid logs/nginx.pidpid(進程標識符):存放路徑.worker_rlomit_nofile 204800;指定進程能夠打開的最大描述符:數目.(這個指令是指當一個nginx進程打開的最多文件描述符數目,理論只應該是最多打開文件數(ulimit -n)與nginx進程數相除可是nginx分配請求行不是那麼均勻,因此最好與ulimit -n的值保持一致如今在linux 2.6內核下開啓文件打開數爲65535，worker_rlimit_nofile就相應應該填寫65535。這是由於nginx調度時分配請求到進程並非那麼的均衡，因此假如填寫10240，總併發量達到3-4萬時就有進程可能超過10240了，這時會返回502錯誤。)events{use epoll;使用epoll的I/O模式.linux建議epoll(補充:與apache相類,nginx針對不一樣的操做系統,有不一樣的事件模型)A標準事件模型select ,poll屬於標準事件模型,若是當前系統不存在更有效的方法,nginx會選擇select活着pollB高效模型kqueue ：使用於FreeBSD 4.1+, OpenBSD 2.9+, NetBSD 2.0 和 MacOS X.使用雙處理器的MacOS X系統使用kqueue可能會形成內核崩潰worker_connections 204800;每一個進程的最大連接數量,根據硬件調整,和前面的工做進程配合起來使用,儘可能大,可是別把cpu跑到100%,每一個進程容許的最大鏈接數,理論上每臺nginx服務器的最大鏈接數爲.worker_processes*worker_connectionskeepalive_timeout 60;http連接超過60秒自動斷開client_header_buffer_size 4k;客戶端請求頭部的緩衝區大小,這個能夠根據你的系統分頁大小設置,通常請求頭的大小不會超過1k,因爲通常系統分頁都大於1k,因此這裏設置爲分頁大小分頁大小:可經過getconf PAGESIZE獲取open_file_cache max=65535 inactive=60s;這個將爲打開文件指定緩存,默認是沒有啓用的,max指定緩存數量,建議和打開文件數一直,inactive是指通過多長時間文件沒被請求後刪除緩存.open_file_cache_valid 80s;這個是指多長時間檢車一次緩存的有效信息.open_file_cache_min_uses 1;open_file_cache指令中的inactive參數時間文件最少的次數,若是超過這個數字,文件描述符一直是在緩存中打開的,如上列,若是有一個文件在inactive時間內一次沒有被使用,他將被移除}http{include mime.types;設定mime類型,類型由mime.type定義default_type application/octet-stream;log_format main '$remote_addr - $remote_user [$time_local] "$request" ''$status $body_bytes_sent "$http_referer" ''"$http_user_agent" "$http_x_forwarded_for"';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： 用來記錄訪問時間與時區；$request： 用來記錄請求的url與http協議；$status： 用來記錄請求狀態；成功是200，$body_bytes_sent ：記錄發送給客戶端文件主體內容大小；$http_referer：用來記錄從那個頁面連接訪問過來的；$http_user_agent：記錄客戶瀏覽 器的相關信息；一般web服務器放在反向代理的後面，這樣就不能獲取到客戶的IP地址了，經過$remote_add拿到的IP地址是反向代理服務器的iP地址。反向代理服務器在轉發請求的http頭信息中，能夠增長x_forwarded_for信息，用以記錄原有客戶端的IP地址和原來客戶端的請求的服務器地址。access_log logs/host.access.log main;access_log log/host.access.404.log log404;用了log_format指令設置了日誌格式以後須要用access_log指令指定日誌文件存放的路徑;sever_names_hash_bucket_size 128;保存服務器名字的hash表示有指令server_names_hash_max_size和seserver_names_hash_bucket_size所控制的,參數hash bucket size老是等於hash表的大小,而且十一路處理器緩存大小的倍數.在減小在內存中的存取次數後,是在處理器中加速查找hash表鍵值成爲可能若是hash bucket size等於一路處理器緩存的大小,name在查找建的時候,最壞的狀況下在內存中查找的次數爲2,第一次是肯定存儲單元的地址,第二次是在存儲單元中查找建值,所以若是nginx給出須要增大hash max size活hash bucket size的提示那麼首要的是增大前一個參數的大小large_client_header_buffers 8 128k;客戶請求頭緩衝大小,nginxmore會用client_header_buffer_size這個buffer來讀取header值,若是header過大,他會使用large_client_header_buffers來獲取open_file_cache max=102400 inactive=20s;這個指令指定緩存是否使用例:open_file_cache max=1000 inactive=20s;open_file_cache_valid 30s;語法:默認值60 使用字段http ,server ,location這個指令主子定合適須要檢查open_file_cache中緩存項目的有效信息open_file_cache_min_uses 2;語法:默認值爲1使用字段 http,server,location這個指令制定了在open_file_cache指令無效的參數中必定的時間範圍內可使用最小的文件數,若是使用更大的值,文件描述符在cache中老是打開狀態open_file_cache_errors on;語法:默認值爲off 是用字段:http,server,location這個指令指定是否在搜索一個文件是記錄cache錯誤client_max_body_size 300m;設定經過nginx上傳文件的大小sendfile on;sendfile指令指定nginx是否調用sendfile函數(zero copy方式)求輸出文件,對於普通應用,必須視爲on,若是用來進行下載等應用磁盤io重負載應用,可設置爲off,以平衡磁盤與網絡IO處理速度,下降UPtime.tcp_nopush on;此選項容許活禁止使用socket的tcp_cork的選項,此選項僅在使用sendfile的時候使用tcp_nodelay on;keepalive_timeout 120長時間連接,超過以後斷開proxy_connect_timeout 90;後端服務器鏈接的超時時間,發起握手等候相應超時時間proxy_read_timeout 180;連接成功後等候後端服務器響應時間其實已經進入後端的排隊之中等候處理(也能夠說是後端服務器處理請求的時間)proxy_send_timeout 180;後端服務器數據往回傳的時間,在規定時間內後端服務器必須傳完全部的數據不然斷開proxy_buffer_size 256k;設置從被代理服務器讀取的第一部分應答的緩衝區大小,一般狀況下這部分應中包含一個小的應答頭,默認狀況下這個值的大小僞指令proxy_buffers種指定的一個緩衝區的大小,不過能夠將其設置爲更小#FastCGI相關參數是爲了改善網站的性能：減小資源佔用，提升訪問速度。下面參數看字面意思都能理解。 fastcgi_connect_timeout 300; fastcgi_send_timeout 300; fastcgi_read_timeout 300; fastcgi_buffer_size 64k; fastcgi_buffers 4 64k; fastcgi_busy_buffers_size 128k; fastcgi_temp_file_write_size 128k; #gzip模塊設置 gzip on; #開啓gzip壓縮輸出 gzip_min_length 1k; #最小壓縮文件大小 gzip_buffers 4 16k; #壓縮緩衝區 gzip_http_version 1.0; #壓縮版本（默認1.1，前端若是是squid2.5請使用1.0） gzip_comp_level 2; #壓縮等級 gzip_types text/plain application/x-javascript text/css application/xml; #壓縮類型，默認就已經包含textml，因此下面就不用再寫了，寫上去也不會有問題，可是會有一個warn。 gzip_vary on; #開啓限制IP鏈接數的時候須要使用 #limit_zone crawler $binary_remote_addr 10m;}負載均衡配置:upstream piao.jd.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種方式的分配 #一、輪詢（默認） #每一個請求按時間順序逐一分配到不一樣的後端服務器，若是後端服務器down掉，能自動剔除。 #二、weight #指定輪詢概率，weight和訪問比率成正比，用於後端服務器性能不均的狀況。 #例如： #upstream bakend { # server 192.168.0.14 weight=10; # server 192.168.0.15 weight=10; #} #二、ip_hash #每一個請求按訪問ip的hash結果分配，這樣每一個訪客固定訪問一個後端服務器，能夠解決session的問題。 #例如： #upstream bakend { # ip_hash; # server 192.168.0.14:88; # server 192.168.0.15:80; #} #三、fair（第三方） #按後端服務器的響應時間來分配請求，響應時間短的優先分配。 #upstream backend { # server server1; # server server2; # fair; #} #四、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.jd.com jd.com; index index.html index.htm index.php; root /data/www/jd; #對******進行負載均衡 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; } }}