Nginx配置文件（nginx.conf）配置詳解（總結(jié)）
現(xiàn)在經(jīng)常碰到有新用戶問一些很基本的問題，最近整理了一下，Nginx的配置文件nginx.conf配置詳解如下：
user nginx nginx ;
Nginx用戶及組：用戶 組。window下不指定
worker_processes 8;
工作進(jìn)程：數(shù)目。根據(jù)硬件調(diào)整，通常等于CPU數(shù)量或者2倍于CPU。
error_log logs/error.log; error_log logs/error.log notice; error_log logs/error.log info;
錯(cuò)誤日志：存放路徑。
pid logs/nginx.pid;
pid（進(jìn)程標(biāo)識符）：存放路徑。
worker_rlimit_nofile 204800;
指定進(jìn)程可以打開的最大描述符：數(shù)目。
這個(gè)指令是指當(dāng)一個(gè)nginx進(jìn)程打開的最多文件描述符數(shù)目，理論值應(yīng)該是最多打開文件數(shù)（ulimit -n）與nginx進(jìn)程數(shù)相除，但是nginx分配請求并不是那么均勻，所以最好與ulimit -n 的值保持一致。
現(xiàn)在在Linux 2.6內(nèi)核下開啟文件打開數(shù)為65535，worker_rlimit_nofile就相應(yīng)應(yīng)該填寫65535。
這是因?yàn)閚ginx調(diào)度時(shí)分配請求到進(jìn)程并不是那么的均衡，所以假如填寫10240，總并發(fā)量達(dá)到3-4萬時(shí)就有進(jìn)程可能超過10240了，這時(shí)會返回502錯(cuò)誤。
events
{
use epoll;
使用epoll的I/O 模型。linux建議epoll，F(xiàn)reeBSD建議采用kqueue，window下不指定。
補(bǔ)充說明:
與apache相類，nginx針對不同的操作系統(tǒng)，有不同的事件模型
A）標(biāo)準(zhǔn)事件模型
Select、poll屬于標(biāo)準(zhǔn)事件模型，如果當(dāng)前系統(tǒng)不存在更有效的方法，nginx會選擇select或poll
B）高效事件模型
Kqueue：使用于FreeBSD 4.1+, OpenBSD 2.9+, NetBSD 2.0 和 MacOS X.使用雙處理器的MacOS 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)核崩潰的問題， 有必要安裝安全補(bǔ)丁。
worker_connections 204800;
沒個(gè)工作進(jìn)程的最大連接數(shù)量。根據(jù)硬件調(diào)整，和前面工作進(jìn)程配合起來用，盡量大，但是別把cpu跑到100%就行。每個(gè)進(jìn)程允許的最多連接數(shù)，理論上每臺nginx服務(wù)器的最大連接數(shù)為。worker_processes*worker_connections
keepalive_timeout 60;
keepalive超時(shí)時(shí)間。
client_header_buffer_size 4k;
客戶端請求頭部的緩沖區(qū)大小。這個(gè)可以根據(jù)你的系統(tǒng)分頁大小來設(shè)置，一般一個(gè)請求頭的大小不會超過1k，不過由于一般系統(tǒng)分頁都要大于1k，所以這里設(shè)置為分頁大小。
分頁大小可以用命令getconf PAGESIZE 取得。
[root@web001 ~]# getconf PAGESIZE
4096
但也有client_header_buffer_size超過4k的情況，但是client_header_buffer_size該值必須設(shè)置為“系統(tǒng)分頁大小”的整倍數(shù)。
這個(gè)將為打開文件指定緩存，默認(rèn)是沒有啟用的，max指定緩存數(shù)量，建議和打開文件數(shù)一致，inactive是指經(jīng)過多長時(shí)間文件沒被請求后刪除緩存。
open_file_cache_valid 80s;
這個(gè)是指多長時(shí)間檢查一次緩存的有效信息。
open_file_cache_min_uses 1;
open_file_cache指令中的inactive參數(shù)時(shí)間內(nèi)文件的最少使用次數(shù)，如果超過這個(gè)數(shù)字，文件描述符一直是在緩存中打開的，如上例，如果有一個(gè)文件在inactive時(shí)間內(nèi)一次沒被使用，它將被移除。
##設(shè)定http服務(wù)器，利用它的反向代理功能提供負(fù)載均衡支持
http
{
include mime.types;
設(shè)定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';
日志格式設(shè)置。
$remote_addr與$http_x_forwarded_for用以記錄客戶端的ip地址；
$remote_user：用來記錄客戶端用戶名稱；
$time_local： 用來記錄訪問時(shí)間與時(shí)區(qū)；
$request： 用來記錄請求的url與http協(xié)議；
$status： 用來記錄請求狀態(tài)；成功是200，
$body_bytes_sent ：記錄發(fā)送給客戶端文件主體內(nèi)容大?。?/span>
$http_referer：用來記錄從那個(gè)頁面鏈接訪問過來的；
$http_user_agent：記錄客戶瀏覽器的相關(guān)信息；
通常web服務(wù)器放在反向代理的后面，這樣就不能獲取到客戶的IP地址了，通過$remote_add拿到的IP地址是反向代理服務(wù)器的iP地址。反向代理服務(wù)器在轉(zhuǎn)發(fā)請求的http頭信息中，可以增加x_forwarded_for信息，用以記錄原有客戶端的IP地址和原來客戶端的請求的服務(wù)器地址。
access_log logs/host.access.log main; access_log logs/host.access.404.log log404;
用了log_format指令設(shè)置了日志格式之后，需要用access_log指令指定日志文件的存放路徑；
server_names_hash_bucket_size 128;
#保存服務(wù)器名字的hash表是由指令server_names_hash_max_size 和server_names_hash_bucket_size所控制的。參數(shù)hash bucket size總是等于hash表的大小，并且是一路處理器緩存大小的倍數(shù)。在減少了在內(nèi)存中的存取次數(shù)后，使在處理器中加速查找hash表鍵值成為可能。如果hash bucket size等于一路處理器緩存的大小，那么在查找鍵的時(shí)候，最壞的情況下在內(nèi)存中查找的次數(shù)為2。第一次是確定存儲單元的地址，第二次是在存儲單元中查找鍵 值。因此，如果Nginx給出需要增大hash max size 或 hash bucket size的提示，那么首要的是增大前一個(gè)參數(shù)的大小.
client_header_buffer_size 4k;
客戶端請求頭部的緩沖區(qū)大小。這個(gè)可以根據(jù)你的系統(tǒng)分頁大小來設(shè)置，一般一個(gè)請求的頭部大小不會超過1k，不過由于一般系統(tǒng)分頁都要大于1k，所以這里設(shè)置為分頁大小。分頁大小可以用命令getconf PAGESIZE取得。
large_client_header_buffers 8 128k;
客戶請求頭緩沖大小。nginx默認(rèn)會用client_header_buffer_size這個(gè)buffer來讀取header值，如果
header過大，它會使用large_client_header_buffers來讀取。
open_file_cache max=102400 inactive=20s;
這個(gè)指令指定緩存是否啟用。
例:
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 默認(rèn)值:open_file_cache_errors off 使用字段:http, server, location 這個(gè)指令指定是否在搜索一個(gè)文件是記錄cache錯(cuò)誤.
open_file_cache_min_uses
語法:open_file_cache_min_uses number 默認(rèn)值:open_file_cache_min_uses 1 使用字段:http, server, location 這個(gè)指令指定了在open_file_cache指令無效的參數(shù)中一定的時(shí)間范圍內(nèi)可以使用的最小文件數(shù),如果使用更大的值,文件描述符在cache中總是打開狀態(tài).
open_file_cache_valid
語法:open_file_cache_valid time 默認(rèn)值:open_file_cache_valid 60 使用字段:http, server, location 這個(gè)指令指定了何時(shí)需要檢查open_file_cache中緩存項(xiàng)目的有效信息.
client_max_body_size 300m;
設(shè)定通過nginx上傳文件的大小
sendfile on;
sendfile指令指定 nginx 是否調(diào)用sendfile 函數(shù)（zero copy 方式）來輸出文件，對于普通應(yīng)用，必須設(shè)為on。如果用來進(jìn)行下載等應(yīng)用磁盤IO重負(fù)載應(yīng)用，可設(shè)置為off，以平衡磁盤與網(wǎng)絡(luò)IO處理速度，降低系統(tǒng)uptime。
tcp_nopush on;
此選項(xiàng)允許或禁止使用socke的TCP_CORK的選項(xiàng)，此選項(xiàng)僅在使用sendfile的時(shí)候使用
proxy_connect_timeout 90;
后端服務(wù)器連接的超時(shí)時(shí)間_發(fā)起握手等候響應(yīng)超時(shí)時(shí)間
proxy_read_timeout 180;
連接成功后_等候后端服務(wù)器響應(yīng)時(shí)間_其實(shí)已經(jīng)進(jìn)入后端的排隊(duì)之中等候處理（也可以說是后端服務(wù)器處理請求的時(shí)間）
proxy_send_timeout 180;
后端服務(wù)器數(shù)據(jù)回傳時(shí)間_就是在規(guī)定時(shí)間之內(nèi)后端服務(wù)器必須傳完所有的數(shù)據(jù)
proxy_buffer_size 256k;
設(shè)置從被代理服務(wù)器讀取的第一部分應(yīng)答的緩沖區(qū)大小，通常情況下這部分應(yīng)答中包含一個(gè)小的應(yīng)答頭，默認(rèn)情況下這個(gè)值的大小為指令proxy_buffers中指定的一個(gè)緩沖區(qū)的大小，不過可以將其設(shè)置為更小
proxy_buffers 4 256k;
設(shè)置用于讀取應(yīng)答（來自被代理服務(wù)器）的緩沖區(qū)數(shù)目和大小，默認(rèn)情況也為分頁大小，根據(jù)操作系統(tǒng)的不同可能是4k或者8k
proxy_busy_buffers_size 256k; proxy_temp_file_write_size 256k;
設(shè)置在寫入proxy_temp_path時(shí)數(shù)據(jù)的大小，預(yù)防一個(gè)工作進(jìn)程在傳遞文件時(shí)阻塞太長
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;
#設(shè)置內(nèi)存緩存空間大小為200MB，1天沒有被訪問的內(nèi)容自動清除，硬盤緩存空間大小為30GB。
keepalive_timeout 120;
keepalive超時(shí)時(shí)間。
tcp_nodelay on; client_body_buffer_size 512k;
如果把它設(shè)置為比較大的數(shù)值，例如256k，那么，無論使用firefox還是IE瀏覽器，來提交任意小于256k的圖片，都很正常。如果注釋該指令，使用默認(rèn)的client_body_buffer_size設(shè)置，也就是操作系統(tǒng)頁面大小的兩倍，8k或者16k，問題就出現(xiàn)了。
無論使用firefox4.0還是IE8.0，提交一個(gè)比較大，200k左右的圖片，都返回500 Internal Server Error錯(cuò)誤
proxy_intercept_errors on;
表示使nginx阻止HTTP應(yīng)答代碼為400或者更高的應(yīng)答
upstream bakend {
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、輪詢（默認(rèn)）
每個(gè)請求按時(shí)間順序逐一分配到不同的后端服務(wù)器，如果后端服務(wù)器down掉，能自動剔除。
2、weight
指定輪詢幾率，weight和訪問比率成正比，用于后端服務(wù)器性能不均的情況。
例如：
upstream bakend {
server 192.168.0.14 weight=10;
server 192.168.0.15 weight=10;
}
2、ip_hash
每個(gè)請求按訪問ip的hash結(jié)果分配，這樣每個(gè)訪客固定訪問一個(gè)后端服務(wù)器，可以解決session的問題。
例如：
upstream bakend {
ip_hash;
server 192.168.0.14:88;
server 192.168.0.15:80;
}
3、fair（第三方）
按后端服務(wù)器的響應(yīng)時(shí)間來分配請求，響應(yīng)時(shí)間短的優(yōu)先分配。
upstream backend {
server server1;
server server2;
fair;
}
4、url_hash（第三方）
按訪問url的hash結(jié)果來分配請求，使每個(gè)url定向到同一個(gè)后端服務(wù)器，后端服務(wù)器為緩存時(shí)比較有效。
例：在upstream中加入hash語句，server語句中不能寫入weight等其他的參數(shù)，hash_method是使用的hash算法
upstream backend {
server squid1:3128;
server squid2:3128;
hash $request_uri;
hash_method crc32;
}
tips:
upstream bakend{#定義負(fù)載均衡設(shè)備的Ip及設(shè)備狀態(tài)}{
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;
}
在需要使用負(fù)載均衡的server中增加
proxy_pass http://bakend/;
每個(gè)設(shè)備的狀態(tài)設(shè)置為:
1.down表示單前的server暫時(shí)不參與負(fù)載
2.weight為weight越大，負(fù)載的權(quán)重就越大。
3.max_fails：允許請求失敗的次數(shù)默認(rèn)為1.當(dāng)超過最大次數(shù)時(shí)，返回proxy_next_upstream模塊定義的錯(cuò)誤
4.fail_timeout:max_fails次失敗后，暫停的時(shí)間。
5.backup： 其它所有的非backup機(jī)器down或者忙的時(shí)候，請求backup機(jī)器。所以這臺機(jī)器壓力會最輕。
nginx支持同時(shí)設(shè)置多組的負(fù)載均衡，用來給不用的server來使用。
client_body_in_file_only設(shè)置為On 可以講client post過來的數(shù)據(jù)記錄到文件中用來做debug
client_body_temp_path設(shè)置記錄文件的目錄 可以設(shè)置最多3層目錄
location對URL進(jìn)行匹配.可以進(jìn)行重定向或者進(jìn)行新的代理 負(fù)載均衡
##配置虛擬機(jī)
server
{
listen 80;
配置監(jiān)聽端口
server_name image.***.com;
配置訪問域名
location ~* \.(mp3|exe)$ {
對以“mp3或exe”結(jié)尾的地址進(jìn)行負(fù)載均衡
proxy_pass http://img_relay$request_uri;
設(shè)置被代理服務(wù)器的端口或套接字，以及URL
proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
以上三行，目的是將代理服務(wù)器收到的用戶的信息傳到真實(shí)服務(wù)器上
location /face {
if ($http_user_agent ~* "xnp") {
rewrite ^(.*)$ http://211.151.188.190:8080/face.jpg redirect;
}
proxy_pass http://img_relay$request_uri;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
error_page 404 502 = @fetch;
}
location @fetch {
access_log /data/logs/face.log log404;
rewrite ^(.*)$ http://211.151.188.190:8080/face.jpg redirect;
}
location /image {
if ($http_user_agent ~* "xnp") {
rewrite ^(.*)$ http://211.151.188.190:8080/face.jpg redirect;
}
proxy_pass http://img_relay$request_uri;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
error_page 404 502 = @fetch;
}
location @fetch {
access_log /data/logs/image.log log404;
rewrite ^(.*)$ http://211.151.188.190:8080/face.jpg redirect;
}
}
##其他舉例
server
{
listen 80;
server_name *.***.com *.***.cn;
location ~* \.(mp3|exe)$ {
proxy_pass http://img_relay$request_uri;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
location / {
if ($http_user_agent ~* "xnp") {
rewrite ^(.*)$ http://i1.***img.com/help/noimg.gif redirect;
}
proxy_pass http://img_relay$request_uri;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
#error_page 404 http://i1.***img.com/help/noimg.gif;
error_page 404 502 = @fetch;
}
location @fetch {
access_log /data/logs/baijiaqi.log log404;
rewrite ^(.*)$ http://i1.***img.com/help/noimg.gif redirect;
}
}
server
{
listen 80;
server_name *.***img.com;
location ~* \.(mp3|exe)$ {
proxy_pass http://img_relay$request_uri;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
location / {
if ($http_user_agent ~* "xnp") {
rewrite ^(.*)$ http://i1.***img.com/help/noimg.gif;
}
proxy_pass http://img_relay$request_uri;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
#error_page 404 http://i1.***img.com/help/noimg.gif;
error_page 404 = @fetch;
}
#access_log off;
location @fetch {
access_log /data/logs/baijiaqi.log log404;
rewrite ^(.*)$ http://i1.***img.com/help/noimg.gif redirect;
}
}
server
{
listen 8080;
server_name ngx-ha.***img.com;
location / {
stub_status on;
access_log off;
}
}
server {
listen 80;
server_name imgsrc1.***.net;
root html;
}
server {
listen 80;
server_name ***.com w.***.com;
# access_log /usr/local/nginx/logs/access_log main;
location / {
rewrite ^(.*)$ http://www.***.com/ ;
}
}
server {
listen 80;
server_name *******.com w.*******.com;
# access_log /usr/local/nginx/logs/access_log main;
location / {
rewrite ^(.*)$ http://www.*******.com/;
}
}
server {
listen 80;
server_name ******.com;
# access_log /usr/local/nginx/logs/access_log main;
location / {
rewrite ^(.*)$ http://www.******.com/;
}
}
location /NginxStatus {
stub_status on;
access_log on;
auth_basic "NginxStatus";
auth_basic_user_file conf/htpasswd;
}
#設(shè)定查看Nginx狀態(tài)的地址
location ~ /\.ht {
deny all;
}
#禁止訪問.htxxx文件
}
注釋：變量
Ngx_http_core_module模塊支持內(nèi)置變量，他們的名字和apache的內(nèi)置變量是一致的。
首先是說明客戶請求title中的行，例如$http_user_agent,$http_cookie等等。
此外還有其它的一些變量
$args此變量與請求行中的參數(shù)相等
$content_length等于請求行的“Content_Length”的值。
$content_type等同與請求頭部的”Content_Type”的值
$document_root等同于當(dāng)前請求的root指令指定的值
$document_uri與$uri一樣
$host與請求頭部中“Host”行指定的值或是request到達(dá)的server的名字（沒有Host行）一樣
$limit_rate允許限制的連接速率
$request_method等同于request的method，通常是“GET”或“POST”
$remote_addr客戶端ip
$remote_port客戶端port
$remote_user等同于用戶名，由ngx_http_auth_basic_module認(rèn)證
$request_filename當(dāng)前請求的文件的路徑名，由root或alias和URI request組合而成
$request_body_file
$request_uri含有參數(shù)的完整的初始URI
$query_string與$args一樣
$sheeme http模式（http,https）盡在要求是評估例如
Rewrite ^(.+)$ $sheme://example.com$; Redirect;
$server_protocol等同于request的協(xié)議，使用“HTTP/或“HTTP/
$server_addr request到達(dá)的server的ip，一般獲得此變量的值的目的是進(jìn)行系統(tǒng)調(diào)用。為了避免系統(tǒng)調(diào)用，有必要在listen指令中指明ip，并使用bind參數(shù)。
$server_name請求到達(dá)的服務(wù)器名
$server_port請求到達(dá)的服務(wù)器的端口號
$uri等同于當(dāng)前request中的URI，可不同于初始值，例如內(nèi)部重定向時(shí)或使用index
以上就是本文的全部內(nèi)容，希望對大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。
相關(guān)文章
本文介紹Nginx負(fù)載均衡與緩存配置,涵蓋upstream模塊基礎(chǔ)用法、輪詢/加權(quán)輪詢/IP哈希/最少連接等策略,以及代理緩存、靜態(tài)資源緩存和SSL緩存的設(shè)置,本文通過實(shí)例代碼給大家講解的非常詳細(xì),感興趣的朋友一起看看吧2025-08-08
windows查看nginx是否啟動及常用命令小結(jié)
這篇文章主要給大家介紹了關(guān)于windows查看nginx是否啟動及常用命令的相關(guān)資料,在Windows系統(tǒng)中,可以使用以下命令來操作和管理Nginx,文中通過代碼介紹的非常詳細(xì),需要的朋友可以參考下2024-06-06
正向代理不僅用于提升訪問速度,還能提高網(wǎng)絡(luò)安全性、管理訪問權(quán)限和優(yōu)化網(wǎng)絡(luò)流量,在本文中,我們將詳細(xì)介紹如何在Nginx中配置正向代理,以及整合ngx_http_proxy_connect_module 插件,需要的朋友可以參考下2024-05-05
Windows的CMD窗口如何查看并殺死nginx進(jìn)程
這篇文章主要介紹了Windows的CMD窗口如何查看并殺死nginx進(jìn)程問題,具有很好的參考價(jià)值,希望對大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2025-06-06
Linux Nginx下SSL證書安裝方法及WordPress CDN配置
這篇文章主要介紹了Linux Nginx下SSL證書安裝方法及WordPress CDN配置,需要的朋友可以參考下2017-08-08
這篇文章主要介紹了詳解nginx使用ssl模塊配置支持HTTPS訪問，小編覺得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過來看看吧2018-08-08
nginx基礎(chǔ)配置說明一則，有需要的朋友可以參考下2013-02-02
Nginx中worker connections問題的解決方法
這篇文章主要介紹了Nginx中worker connections問題的解決方法，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2017-05-05
本文主要介紹了Nginx之QPS限制模塊的具體使用,主要介紹Nginx QPS限制模塊的原理、安裝和使用方法,具有一定的參考價(jià)值,感興趣的可以了解一下2023-09-09
使用nginx部署到服務(wù)器后,本地訪問服務(wù)器地址,上傳文件提示：405 Not Allowed,本文就來解決一下該問題,感興趣的可以了解一下2023-10-10