天天看點

nginx配置檔案詳解access_log /usr/local/nginx/logs/access_log main;access_log /usr/local/nginx/logs/access_log main;access_log /usr/local/nginx/logs/access_log main;

user nginx nginx ;

Nginx使用者及組:使用者 組。window下不指定

worker_processes 8;

工作程序:數目。根據硬體調整,通常等于CPU數量或者2倍于CPU。

error_log logs/error.log; 

error_log logs/error.log notice; 

error_log logs/error.log info; 

錯誤日志:存放路徑。

pid logs/nginx.pid;

pid(程序辨別符):存放路徑。

worker_rlimit_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,FreeBSD建議采用kqueue,window下不指定。

補充說明:

與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。 為了防止出現核心崩潰的問題, 有必要安裝安全更新檔。

worker_connections 204800;

沒個工作程序的最大連接配接數量。根據硬體調整,和前面工作程序配合起來用,盡量大,但是别把cpu跑到100%就行。每個程序允許的最多連接配接數,理論上每台nginx伺服器的最大連接配接數為。worker_processes*worker_connections

keepalive_timeout 60;

keepalive逾時時間。

client_header_buffer_size 4k;

用戶端請求頭部的緩沖區大小。這個可以根據你的系統分頁大小來設定,一般一個請求頭的大小不會超過1k,不過由于一般系統分頁都要大于1k,是以這裡設定為分頁大小。

分頁大小可以用指令getconf PAGESIZE 取得。

[root@web001 ~]# getconf PAGESIZE

4096

但也有client_header_buffer_size超過4k的情況,但是client_header_buffer_size該值必須設定為“系統分頁大小”的整倍數。

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伺服器,利用它的反向代理功能提供負載均衡支援

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 logs/host.access.404.log log404;

用了log_format指令設定了日志格式之後,需要用access_log指令指定日志檔案的存放路徑;

server_names_hash_bucket_size 128;

#儲存伺服器名字的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的提示,那麼首要的是增大前一個參數的大小.

用戶端請求頭部的緩沖區大小。這個可以根據你的系統分頁大小來設定,一般一個請求的頭部大小不會超過1k,不過由于一般系統分頁都要大于1k,是以這裡設定為分頁大小。分頁大小可以用指令getconf PAGESIZE取得。

large_client_header_buffers 8 128k;

客戶請求頭緩沖大小。nginx預設會用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; 

open_file_cache_min_uses 2; 

open_file_cache_errors on;

open_file_cache_errors

文法:open_file_cache_errors on | off 預設值:open_file_cache_errors off 使用字段:http, server, location 這個指令指定是否在搜尋一個檔案是記錄cache錯誤.

open_file_cache_min_uses

文法:open_file_cache_min_uses number 預設值:open_file_cache_min_uses 1 使用字段:http, server, location 這個指令指定了在open_file_cache指令無效的參數中一定的時間範圍内可以使用的最小檔案數,如果使用更大的值,檔案描述符在cache中總是打開狀态.

open_file_cache_valid

文法:open_file_cache_valid time 預設值:open_file_cache_valid 60 使用字段:http, server, location 這個指令指定了何時需要檢查open_file_cache中緩存項目的有效資訊.

client_max_body_size 300m;

設定通過nginx上傳檔案的大小

sendfile on;

sendfile指令指定 nginx 是否調用sendfile 函數(zero copy 方式)來輸出檔案,對于普通應用,必須設為on。如果用來進行下載下傳等應用磁盤IO重負載應用,可設定為off,以平衡磁盤與網絡IO處理速度,降低系統uptime。

tcp_nopush on;

此選項允許或禁止使用socke的TCP_CORK的選項,此選項僅在使用sendfile的時候使用

proxy_connect_timeout 90; 

後端伺服器連接配接的逾時時間_發起握手等候響應逾時時間

proxy_read_timeout 180;

連接配接成功後_等候後端伺服器響應時間_其實已經進入後端的排隊之中等候處理(也可以說是後端伺服器處理請求的時間)

proxy_send_timeout 180;

後端伺服器資料回傳時間_就是在規定時間之内後端伺服器必須傳完所有的資料

proxy_buffer_size 256k;

設定從被代理伺服器讀取的第一部分應答的緩沖區大小,通常情況下這部分應答中包含一個小的應答頭,預設情況下這個值的大小為指令proxy_buffers中指定的一個緩沖區的大小,不過可以将其設定為更小

proxy_buffers 4 256k;

設定用于讀取應答(來自被代理伺服器)的緩沖區數目和大小,預設情況也為分頁大小,根據作業系統的不同可能是4k或者8k

proxy_busy_buffers_size 256k;

proxy_temp_file_write_size 256k;

設定在寫入proxy_temp_path時資料的大小,預防一個工作程序在傳遞檔案時阻塞太長

proxy_temp_path /data0/proxy_temp_dir;

proxy_temp_path和proxy_cache_path指定的路徑必須在同一分區

proxy_cache_path /data0/proxy_cache_dir levels=1:2 keys_zone=cache_one:200m inactive=1d max_size=30g;

#設定記憶體緩存空間大小為200MB,1天沒有被通路的内容自動清除,硬碟緩存空間大小為30GB。

keepalive_timeout 120;

tcp_nodelay on;

client_body_buffer_size 512k;

如果把它設定為比較大的數值,例如256k,那麼,無論使用firefox還是IE浏覽器,來送出任意小于256k的圖檔,都很正常。如果注釋該指令,使用預設的client_body_buffer_size設定,也就是作業系統頁面大小的兩倍,8k或者16k,問題就出現了。

無論使用firefox4.0還是IE8.0,送出一個比較大,200k左右的圖檔,都傳回500 Internal Server Error錯誤

proxy_intercept_errors on;

表示使nginx阻止HTTP應答代碼為400或者更高的應答。

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、輪詢(預設)

每個請求按時間順序逐一配置設定到不同的後端伺服器,如果後端伺服器down掉,能自動剔除。

2、weight

指定輪詢幾率,weight和通路比率成正比,用于後端伺服器性能不均的情況。

例如:

server 192.168.0.14 weight=10;

server 192.168.0.15 weight=10;

2、ip_hash

每個請求按通路ip的hash結果配置設定,這樣每個訪客固定通路一個後端伺服器,可以解決session的問題。

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算法

server squid1:3128;

server squid2:3128;

hash_method crc32;

tips:

upstream bakend{#定義負載均衡裝置的Ip及裝置狀态}{

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中增加

每個裝置的狀态設定為:

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 image.***.com;

配置通路域名

location ~* .(mp3|exe)$ {

對以“mp3或exe”結尾的位址進行負載均衡

設定被代理伺服器的端口或套接字,以及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;

以上三行,目的是将代理伺服器收到的使用者的資訊傳到真實伺服器上

location /face {

if ($http_user_agent ~ "xnp") {

error_page 404 502 = @fetch;

location @fetch {

access_log /data/logs/face.log log404;

location /image {

access_log /data/logs/image.log log404;

##其他舉例

server_name *..com .*.cn;

location ~ .(mp3|exe)$ {

location / {

access_log /data/logs/baijiaqi.log log404;

server_name *.***img.com;

error_page 404 = @fetch;

#access_log off;

listen 8080;

server_name ngx-ha.img.com;

stub_status on;

access_log off;

server {

server_name imgsrc1..net;

root html;

server_name .com w..com;

server_name **.com;

location /NginxStatus {

access_log on;

auth_basic "NginxStatus";

auth_basic_user_file conf/htpasswd;

#設定檢視Nginx狀态的位址

location ~ /.ht {

deny all;

#禁止通路.htxxx檔案

注釋:變量

Ngx_http_core_module子產品支援内置變量,他們的名字和apache的内置變量是一緻的。

首先是說明客戶請求title中的行,例如$http_user_agent,$http_cookie等等。

此外還有其它的一些變量

$args此變量與請求行中的參數相等

$content_length等于請求行的“Content_Length”的值。

$content_type等同與請求頭部的”Content_Type”的值

$document_root等同于目前請求的root指令指定的值

$document_uri與$uri一樣

$host與請求頭部中“Host”行指定的值或是request到達的server的名字(沒有Host行)一樣

$limit_rate允許限制的連接配接速率

$request_method等同于request的method,通常是“GET”或“POST”

$remote_addr用戶端ip

$remote_port用戶端port

$remote_user等同于使用者名,由ngx_http_auth_basic_module認證

$request_filename目前請求的檔案的路徑名,由root或alias和URI request組合而成

$request_body_file

$request_uri含有參數的完整的初始URI

$query_string與$args一樣

$sheeme http模式(http,https)盡在要求是評估例如

Rewrite ^(.+)$ $sheme://example.com$; Redirect;

$server_protocol等同于request的協定,使用“HTTP/或“HTTP/

$server_addr request到達的server的ip,一般獲得此變量的值的目的是進行系統調用。為了避免系統調用,有必要在listen指令中指明ip,并使用bind參數。

$server_name請求到達的伺服器名

$server_port請求到達的伺服器的端口号

$uri等同于目前request中的URI,可不同于初始值,例如内部重定向時或使用index

我們來一條條的看

proxy_set_header X-real-ip $remote_addr;

這句話之前已經解釋過,有了這句就可以在web伺服器端獲得使用者的真實ip

但是,實際上要獲得使用者的真實ip,不是隻有這一個方法,下面我們繼續看。

我們先看看這裡有個X-Forwarded-For變量,這是一個squid開發的,用于識别通過HTTP代理或負載平衡器原始IP一個連接配接到Web伺服器的客戶機位址的非rfc标準,如果有做X-Forwarded-For設定的話,每次經過proxy轉發都會有記錄,格式就是client1, proxy1, proxy2,以逗号隔開各個位址,由于他是非rfc标準,是以預設是沒有的,需要強制添加,在預設情況下經過proxy轉發的請求,在後端看來遠端位址都是proxy端的ip 。也就是說在預設情況下我們使用request.getHeader("X-real-ip")擷取不到使用者的ip,如果我們想要通過這個變量獲得使用者的ip,我們需要自己在nginx添加如下配置:

意思是增加一個$proxy_add_x_forwarded_for到X-Forwarded-For裡去,注意是增加,而不是覆寫,當然由于預設的X-Forwarded-For值是空的,是以我們總感覺X-Forwarded-For的值就等于$proxy_add_x_forwarded_for的值,實際上當你搭建兩台nginx在不同的ip上,并且都使用了這段配置,那你會發現在web伺服器端通過request.getHeader("X-real-ip")獲得的将會是用戶端ip和第一台nginx的ip。

那麼$proxy_add_x_forwarded_for又是什麼?

$proxy_add_x_forwarded_for變量包含用戶端請求頭中的"X-Forwarded-For",與$remote_addr兩部分,他們之間用逗号分開。

舉個例子,有一個web應用,在它之前通過了兩個nginx轉發,即使用者通路該web通過兩台nginx。

在第一台nginx中,使用

現在的$proxy_add_x_forwarded_for變量的"X-Forwarded-For"部分是空的,是以隻有$remote_addr,而$remote_addr的值是使用者的ip,于是指派以後,X-Forwarded-For變量的值就是使用者的真實的ip位址了。

到了第二台nginx,使用

現在的$proxy_add_x_forwarded_for變量,X-Forwarded-For部分包含的是使用者的真實ip,$remote_addr部分的值是上一台nginx的ip位址,于是通過這個指派以後現在的X-Forwarded-For的值就變成了“使用者的真實ip,第一台nginx的ip”,這樣就清楚了吧。

最後我們看到還有一個$http_x_forwarded_for變量,這個變量就是X-Forwarded-For,由于之前我們說了,預設的這個X-Forwarded-For是為空的,是以當我們直接使用proxy_set_header X-Forwarded-For $http_x_forwarded_for時會發現,web伺服器端使用request.getHeader("X-real-ip")獲得的值是null。如果想要通過request.getHeader("X-real-ip")獲得使用者ip,就必須先使用proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;這樣就可以獲得使用者真實ip

本文轉自   Taxing祥   51CTO部落格,原文連結:http://blog.51cto.com/12118369/2061600

繼續閱讀