Nginx 配置文件說明

時間 2020-03-10

原文原文鏈接

#定義Nginx運行的用戶和用戶組
user www www; 

#nginx進程數，一般設置成和cpu的數量相等
worker_processes 4; 

#全局錯誤日誌定義類型，[debug | info | notice | warn | error | crit]
#error_log  logs/error.log;
#error_log  logs/error.log  notice;
#error_log  logs/error.log  info;


#進程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_rlimit_nofile進行更改
    worker_connections  1024;
    
    #keepalive 超時時間
    keepalive_timeout 60;
    
    #客戶端請求頭部的緩衝區大小。這個能夠根據你的系統分頁大小來設置，通常一個請求頭的大小不會超過1k，
    #不過因爲通常系統分頁都要大於1k，因此這裏設置爲分頁大小。
    #分頁大小能夠用命令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;
	
	#設定日誌格式
	access_log    /var/log/nginx/access.log;
    
    #開啓高效文件傳輸模式，sendfile指令指定nginx是否調用sendfile函數來輸出文件，對於普通應用設爲on，
    #若是用來進行下載等應用磁盤IO重負載應用，可設置爲off，以平衡磁盤與網絡I/O處理速度，下降系統的負載。注意：若是圖片顯示不正常把這個改爲off。
    #sendfile指令指定 nginx 是否調用sendfile 函數（zero copy 方式）來輸出文件，對於普通應用，必須設爲on。
    #若是用來進行下載等應用磁盤IO重負載應用，可設置爲off，以平衡磁盤與網絡IO處理速度，下降系統uptime。
    sendfile on;
	
    #服務器名字的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;
    
    #開啓目錄列表訪問，合適下載服務器，默認關閉。
    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;     #壓縮等級

　　#壓縮類型，默認就已經包含textml，因此下面就不用再寫了，寫上去也不會有問題，可是會有一個warn。
    gzip_types text/plain application/x-javascript text/css application/xml; 
    gzip_vary on;

    #開啓限制IP鏈接數的時候須要使用
    #limit_zone crawler $binary_remote_addr 10m;
	
	#包含其它配置文件，如自定義的虛擬主機
	include /etc/nginx/conf.d/*.conf;
	include /etc/nginx/sites-enabled/*;
    
    
    #負載均衡配置
    upstream www.abc.com {
     
        #upstream的負載均衡，weight是權重，能夠根據機器配置定義權重。weigth參數表示權值，權值越高被分配到的概率越大。
        server 192.168.1.1:80 weight=3;
        server 192.168.1.2:80 weight=2;
        server 192.168.1.3:80 weight=3;

        #nginx的upstream目前支持4種方式的分配
        #一、輪詢（默認）
        #每一個請求按時間順序逐一分配到不一樣的後端服務器，若是後端服務器down掉，能自動剔除。
        #二、weight
        #指定輪詢概率，weight和訪問比率成正比，用於後端服務器性能不均的狀況。
        #例如：
        #upstream bakend {
        #    server 192.168.2.1 weight=10;
        #    server 192.168.2.2 weight=10;
        #}
        #二、ip_hash
        #每一個請求按訪問ip的hash結果分配，這樣每一個訪客固定訪問一個後端服務器，能夠解決session的問題。
        #例如：
        #upstream bakend {
        #    ip_hash;
        #    server 192.168.3.1:88;
        #    server 192.168.3.2: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.abc.com abc.com;

         
        #日誌格式設定
        #$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。
		#= 進行普通字符精確匹配。也就是徹底匹配。
		
		#location = / {
			# 徹底匹配  =
			# 大小寫敏感 ~
			# 忽略大小寫 ~*
		#}
		#location ^~ /images/ {
			# 前半部分匹配 ^~
			# 可使用正則，如：
			# location ~* \.(gif|jpg|png)$ { }
		#}
		#location / {
			# 若是以上都未匹配，會進入這裏
		#}
		
		#別名
		location /blog {
			alias /data/www/blog/;
		}
		location ~ ^/blog/(\d+)/([\w-]+)$ {
			# /blog/20141202/article-name  
			# -> /blog/20141202-article-name.md
			alias /data/www/blog/$1-$2.md;
		}


		
		#默認請求
		location / {
			root   /root;      #定義服務器的默認網站根目錄位置
			index index.php index.html index.htm;   #定義首頁索引文件的名稱
			fastcgi_pass  www.abc.com;
			fastcgi_param  SCRIPT_FILENAME  $document_root/$fastcgi_script_name; 
			include /etc/nginx/fastcgi_params;
		}
	
		# 定義錯誤提示頁面
		error_page   500 502 503 504 /50x.html;  
        location = /50x.html {
        root   /root;
		}

		#靜態文件，nginx本身處理
		location ~ ^/(images|javascript|js|css|flash|media|static)/ {
			root /var/www/virtual/htdocs;
			#過時30天，靜態文件不怎麼更新，過時能夠設大一點，若是頻繁更新，則能夠設置得小一點。
			expires 30d;
		}
		
		#PHP 腳本請求所有轉發到 FastCGI處理. 使用FastCGI默認配置.
		location ~ \.php$ {
			root /root;
			fastcgi_pass 127.0.0.1:9000;
			fastcgi_index index.php;
			fastcgi_param SCRIPT_FILENAME /home/www/www$fastcgi_script_name;
			include fastcgi_params;
		}
		
		#設定查看Nginx狀態的地址
		location /NginxStatus {
			stub_status            on;
			access_log              on;
			auth_basic              "NginxStatus";
			auth_basic_user_file  conf/htpasswd;
		}
		
		#禁止訪問 .htxxx 文件
		location ~ /\.ht {
			deny all;
		}
         
        #對 "/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;
        }
		
		#按指定順序檢查文件是否存在，並使用找到的第一個文件進行請求處理；該處理在當前上下文中執行。                #文件的路徑是根據根和別名指令從file參數構造的。能夠經過在名稱末尾指定斜槓來檢查目錄是否存在，                #例如「 $uri /」。若是未找到任何文件，則會進行內部重定向到最後一個參數中指定的uri。
		try_files $uri $uri.html $uri/index.html @other;
		location @other {
			# 嘗試尋找匹配 uri 的文件，失敗了就會轉到上游處理
			proxy_pass  http://localhost:9000;
		}
		location / {
			# 嘗試尋找匹配 uri 的文件，沒找到直接返回 502
			try_files $uri $uri.html =502;
		}
		location / {
			try_files /system/maintenance.html
					  $uri $uri/index.html $uri.html
					  @mongrel;
		}
		location @mongrel {
			proxy_pass http://mongrel;
		}

		#強制HTTP轉到HTTPS
		server {  
			listen  192.168.4.1:80;  
			server_name abc.com;  
			rewrite ^(.*)$  https://$host$1 permanent;  
		}

		#last和break的區別
		#由於301和302不能簡單的只返回狀態碼，還必須有重定向的URL，這就是return指令沒法返回301,302的緣由了。這裏 last 和 break 區別有點難以理解：

		#last通常寫在server和if中，而break通常使用在location中
		#last不終止重寫後的url匹配，即新的url會再從server走一遍匹配流程，而break終止重寫後的匹配
		#break和last都能組織繼續執行後面的rewrite指令
		server {
			# 訪問 /last.html 的時候，頁面內容重寫到 /index.html 中
			rewrite /last.html /index.html last;
			# 訪問 /break.html 的時候，頁面內容重寫到 /index.html 中，並中止後續的匹配
			rewrite /break.html /index.html break;
			# 訪問 /redirect.html 的時候，頁面直接302定向到 /index.html中
			rewrite /redirect.html /index.html redirect;
			# 訪問 /permanent.html 的時候，頁面直接301定向到 /index.html中
			rewrite /permanent.html /index.html permanent;
			# 把 /html/*.html => /post/*.html ，301定向
			rewrite ^/html/(.+?).html$ /post/$1.html permanent;
			# 把 /search/key => /search.html?keyword=key
			rewrite ^/search\/([^\/]+?)(\/|$) /search.html?keyword=$1 permanent;
		}


    }
}

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。