nginx.conf 設定檔詳解- 技術宅

Nginx 設定檔主要分成四部分：main（全域設定）、server（主機設定）、upstream（上游伺服器設置，主要為反向代理、負載平衡相關設定）和location（URL匹配特定位置後的設定）。 main 部分設定的指令影響其他所有部分的設定；server 部分的指令主要用於制定虛擬主機網域名稱、IP 和連接埠號碼；upstream 的指令用於設定一系列的後端伺服器，設定反向代理及後端伺服器的負載平衡；location 部分用於匹配網頁位置（例如，根目錄“/”，“/images”，等等）。他們之間的關係：server 繼承main，location 繼承server；upstream 既不會繼承指令也不會被繼承。
nginx.conf 設定檔
以下是nginx.conf 詳細的設定檔介紹（以下設定參數很多時候不一定用的到，只是作為設定參數說明參考，可以看下面的通用版介紹）

#定義Nginx運行的使用者和使用者群組 user www www;

#nginx進程數，通常設定成和cpu的數量相等
worker_processes 4;

#進程pid文件
#pid logs/nginx.pid;

#指定進程可以開啟的最大描述符：數目
#工作模式與連線數上限
##這個指令是指當一個nginx程序打開的最多文件描述符數目，理論值應該是最多打開文件數（ulimit -n）與nginx進程數相除，但是nginx分配請求並不是那麼均勻，所以最好與ulimit -n 的值保持一致。
#這是因為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)，IRIX 6.5.15+ 和Tru64 UNIX 5.1A+。
#Eventport：使用於Solaris 10。為了防止核心崩潰的問題，有必要安裝安全性修補程式。
use epoll

#單一進程最大連線數（最大連線數=連線數+進程數）
#依硬體調整，和前面工作進程配合起來用，盡量大，但是別把cup跑到100%就行。
worker_connections 1024;

#keepalive 超時時間
keepalive_timeout 60;

#客戶端請求頭部的緩衝區大小。這個可以根據你的系統分頁大小來設置，一般一個請求頭的大小不會超過1k，但由於一般系統分頁都要大於1k，所以這裡設置為分頁大小。
#分頁大小可以用指令getconf PAGESIZE 取得。
#[root@web001 ~]# getconf PAGESIZE
#但也有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 80s;

#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 on; #開啟高效文件傳輸模式，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的時候使用
tcp_nopush on;

tcp_nodelay on;

#長連線逾時時間，單位是秒
keepalive_timeout 120;

#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種方式的分配
#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.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;

#對"/connect-controller" 啟用反向代理
location /connect-controller {
proxy_pass http://127.0.0.1:88; #請注意此處連接埠號碼不能與虛擬主機監聽的連接埠號碼一樣（也就是server監聽的連接埠）
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;
}

#本地動靜分離反向代理配置
#所有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通用設定檔（這裡是windows 系統系nginx1.14.2 下nginx.conf 設定）
下面的nginx.conf簡單的實作nginx在前端做反向代理伺服器的例子，處理js、png等靜態文件，jsp等動態請求轉送到其它伺服器（相關設定參數詳解參考上面的解釋）：
worker_processes 1;

#error_log logs/error.log;
#error_log logs/error.log notice;
#error_log logs/error.log info;

#pid logs/nginx.pid;

events {
worker_connections 1024;
}

http {
include mime.types;
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"';

access_log logs/access.log main;
error_log logs/ssl.error.log crit;

sendfile on;
#tcp_nopush on;

#keepalive_timeout 0;
keepalive_timeout 65;

#gzip on;

server {
listen 8088;
server_name localhost;

charset utf-8;

#access_log logs/host.access.log main;

#入口文件的設置
location / {
root D:/vueWork/dentalFactory/dist; #入口檔案的所在目錄
index index.html index.htm; #預設入口檔名稱
}

# tomcat 反向代理配置
location /location名稱/ {
proxy_pass http://192.168.1.10:8080; # http://127.0.0.1:8080/服務名稱（項目名稱）/
#proxy_set_header Host $host;
proxy_set_header Host $host:$server_port;//注意：目前端項目連接埠號碼不是8080 需要這樣配置，否則後端拿不到正確連接埠號
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

#靜態資源的代理程式配置（一般不用配置，這裡舉例配置圖片資源的配置）
#location /images/ {
# root D:/A-studySpace/nginxDemo;
#}

#這裡是配置404頁面的地方
#error_page 404 /404.html;

#對應的這是對應請求狀態的頁面配置地方
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root html;
}

# php 反向代理配置
#將所有php頁面的請求轉給php-fpm處理
#location ~ \.php$ {
# root html;
# fastcgi_pass 127.0.0.1:9000;
# fastcgi_index index.php;
# fastcgi_param SCRIPT_FILENAME /scripts$fastcgi_script_name; #fastcgi_param設定參數較多，視情況依需求調整
# include fastcgi_params;
#}

}

# another virtual host using mix of IP-, name-, and port-based configuration
#
#server {
# listen 8000;
# listen somename:8080;
# server_name somename alias another.alias;

# location / {
# root html;
# index index.html index.htm;
# }
#}

# HTTPS server
#
#server {
# listen 443 ssl;
# server_name localhost;

# ssl_certificate cert.pem;
# ssl_certificate_key cert.key;

# ssl_session_cache shared:SSL:1m;
# ssl_session_timeout 5m;

# ssl_ciphers HIGH:!aNULL:!MD5;
# ssl_prefer_server_ciphers on;

# location / {
# root html;
# index index.html index.htm;
# }
#}

}

評分