1.簡介：

? Nginx：engine X ，2002年，開源，商業(yè)版
? http協(xié)議：web服務(wù)器（類似于httpd）哩罪、http reverse
proxy（類似于httpd）授霸、imap/pop3 reverse proxy,tcp
? NGINX is a free, open-source, high-performance an
HTTP and reverse proxy server, a mail proxy server,
and a generic TCP/UDP proxy server
? C10K（10K Connections）
? 二次開發(fā)版：Tengine, OpenResty
? 官網(wǎng)：http://nginx.org

正向代理和反向代理

Paste_Image.png

(1)特性：

? 模塊化設(shè)計，較好的擴展性
? 高可靠性
? 支持熱部署：不停機更新配置文件际插，升級版本碘耳，更換日志文件
? 低內(nèi)存消耗：10000個keep-alive連接模式下的非活動連接，僅需要2.5M內(nèi)存
? event-driven,aio,mmap框弛，sendfile

(2)基本功能：

? 靜態(tài)資源的web服務(wù)器
? http協(xié)議反向代理服務(wù)器
? pop3/imap4協(xié)議反向代理服務(wù)器
? FastCGI(lnmp),uWSGI(python)等協(xié)議
? 模塊化（非DSO）辛辨，如zip，SSL模塊

2.nginx的程序架構(gòu)

(1) web服務(wù)相關(guān)的功能：

虛擬主機（server）
支持 keep-alive 和管道連接
訪問日志（支持基于日志緩沖提高其性能）
url rewirte
路徑別名
基于IP及用戶的訪問控制
支持速率限制及并發(fā)數(shù)限制
重新配置和在線升級而無須中斷客戶的工作進程
Memcached 的 GET 接口
nginx架構(gòu)

Paste_Image.png

(2) master/worker結(jié)構(gòu)

? 一個master進程：
負載加載和分析配置文件功咒、管理worker進程愉阎、平滑升級
? 一個或多個worker進程
處理并響應(yīng)用戶請求
? 緩存相關(guān)的進程：
cache loader：載入緩存對象
cache manager：管理緩存對象

3.nginx模塊

? nginx高度模塊化，但其模塊早期不支持DSO機制力奋；1.9.11版
本支持動態(tài)裝載和卸載
? 模塊分類：
? 核心模塊：core module
? 標(biāo)準模塊：
? HTTP 模塊： ngx_http_*
HTTP Core modules 默認功能
HTTP Optional modules 需編譯時指定
? Mail 模塊 ngx_mail_*
? Stream 模塊 ngx_stream_*
? 第三方模塊

4.nginx的功用

? 靜態(tài)的web資源服務(wù)器
html，圖片幽七，js景殷，css，txt等靜態(tài)資源
? 結(jié)合FastCGI/uWSGI/SCGI等協(xié)議反向代理動態(tài)資源請求
? http/https協(xié)議的反向代理
? imap4/pop3協(xié)議的反向代理
? tcp/udp協(xié)議的請求轉(zhuǎn)發(fā)（反向代理）

5.nginx的安裝

? 官方：
http://nginx.org/packages/centos/7/x86_64/RPMS
? Fedora-EPEL:
https://mirrors.aliyun.com/epel/7/x86_64/
? 編譯安裝：
? yum install pcre-devel openssl-devel zlib-devel
? useradd -r nginx
? ./configure --prefix=/usr/local/nginx --confpath=/etc/nginx/nginx.conf
--error-logpath=/var/log/nginx/error.log
--http-logpath=/var/log/nginx/access.log
--pid-path=/var/run/nginx.pid --
lock-path=/var/run/nginx.lock --user=nginx --group=nginx --
with-http_ssl_module --with-http_v2_module --withhttp_dav_module
--with-http_stub_status_module --withthreads
--with-file-aio
? make && make install
編譯安裝nginx選項
? 編譯安裝nginx選項：
? --prefix=/etc/nginx 安裝路徑
? --sbin-path=/usr/sbin/nginx 指明nginx程序文件安裝路徑
? --conf-path=/etc/nginx/nginx.conf 主配置文件安裝位置
? --error-log-path=/var/log/nginx/error.log 錯誤日志文件安裝位置
? --http-log-path=/var/log/nginx/access.log 訪問日志文件安裝位置
? --pid-path=/var/run/nginx.pid 指明pid文件安裝位置
? --lock-path=/var/run/nginx.lock 鎖文件安裝位置
? --http-client-body-temppath=/var/cache/nginx/client_temp 客戶端body部分的臨時文件存放路徑澡屡，如果服務(wù)器允許客戶端使用put方法提交大數(shù)據(jù)時猿挚，臨時存放的磁盤路徑
? --http-proxy-temp-path=/var/cache/nginx/proxy_temp
作為代理服務(wù)器，服務(wù)器響應(yīng)報文的臨時文件存放路徑
? --http-fastcgi-temppath=/var/cache/nginx/fastcgi_temp
作為fastcgi代理服務(wù)器驶鹉，服務(wù)器響應(yīng)報文的臨時文件存放路徑
? --http-uwsgi-temp-path=/var/cache/nginx/uwsgi_temp
作為uwsgi代理服務(wù)器绩蜻，服務(wù)器響應(yīng)報文的臨時文件存放路徑
? --http-scgi-temp-path=/var/cache/nginx/scgi_temp 作為
scgi反代服務(wù)器，服務(wù)器響應(yīng)報文的臨時文件存放路徑
? --user=nginx 指明以那個身份運行worker進程室埋，主控master進程一般由root運行
? --group=nginx
? --with-http_ssl_module 表示把指定模塊編譯進來

6.nginx目錄結(jié)構(gòu)和命令

? ls /usr/local/nginx/
html是測試頁办绝，sbin是主程序
? ls /usr/local/nginx/sbin/
nginx 只有一個程序文件
? ls /usr/local/nginx/html/
50x.html index.html 測試網(wǎng)頁
? Nginx：默認為啟動nginx
-h 查看幫助選項
-t 測試nginx語法錯誤
-c filename 指定配置文件(default: /etc/nginx/nginx.conf)
-s signal 發(fā)送信號給master進程，signal可為：stop, quit,
reopen, reload
示例：-s stop 停止nginx -s reload 加載配置文件
-g directives 在命令行中指明全局指令

7.nginx配置

? 配置文件的組成部分：
? 主配置文件：nginx.conf
子配置文件 include conf.d/*.conf
? fastcgi姚淆， uwsgi孕蝉，scgi等協(xié)議相關(guān)的配置文件
? mime.types：支持的mime類型
? 主配置文件的配置指令：
? directive value [value2 ...];
? 注意：
(1) 指令必須以分號結(jié)尾
(2) 支持使用配置變量
內(nèi)建變量：由Nginx模塊引入，可直接引用
自定義變量：由用戶使用set命令定義
set variable_name value;
引用變量：$variable_name

? main block：主配置段腌逢，即全局配置段降淮，對http,mail都有效
event {
...
} 事件驅(qū)動相關(guān)的配置
? http {
...
} http/https 協(xié)議相關(guān)配置段
? mail {
...
} mail 協(xié)議相關(guān)配置段
? stream {
...
} stream 服務(wù)器相關(guān)配置段

http協(xié)議相關(guān)的配置結(jié)構(gòu)
http {
...
... 各server的公共配置
server { 每個server用于定義一個虛擬主機
...
}
server {
...
server_name 虛擬主機名
root 主目錄
alias 路徑別名
location [OPERATOR] URL { 指定URL的特性
...
if CONDITION {
...
}
}
}
}

? Main 全局配置段常見的配置指令分類
? 正常運行必備的配置
? 優(yōu)化性能相關(guān)的配置
? 用于調(diào)試及定位問題相關(guān)的配置
? 事件驅(qū)動相關(guān)的配置
? 幫助文檔
http://nginx.org/en/docs/

8.正常運行必備的配置：

? 幫助文檔：http://nginx.org/en/docs/ngx_core_module.html

1、user

Syntax: user user [group];
Default: user nobody nobody;
Context: main
指定worker進程的運行身份搏讶，如組不指定佳鳖，默認和用戶名同名

2、pid /PATH/TO/PID_FILE

指定存儲nginx主進程PID的文件路徑

3媒惕、include file | mask

指明包含進來的其它配置文件片斷

4系吩、load_module file

模塊加載配置文件：/usr/share/nginx/modules/*.conf
指明要裝載的動態(tài)模塊路徑: /usr/lib64/nginx/modules

9. 性能優(yōu)化相關(guān)的配置：

1、worker_processes number | auto

worker進程的數(shù)量吓笙；通常應(yīng)該為當(dāng)前主機的cpu的物理核心數(shù)

2淑玫、worker_cpu_affinity cpumask ...

worker_cpu_affinity auto [cpumask] 提高緩存命中率
CPU MASK： 00000001：0號CPU
00000010：1號CPU
10000000：8號CPU
worker_cpu_affinity 0001 0010 0100 1000;
worker_cpu_affinity 0101 1010;

3、worker_priority number

指定worker進程的nice值，設(shè)定worker進程優(yōu)先級：[-20,20]

4絮蒿、worker_rlimit_nofile number

worker進程所能夠打開的文件數(shù)量上限,如65535

10.事件驅(qū)動相關(guān)的配置:

? events {
...
}

1尊搬、worker_connections number

每個worker進程所能夠打開的最大并發(fā)連接數(shù)數(shù)量，如10240
總最大并發(fā)數(shù)：worker_processes * worker_connections

2土涝、use method

指明并發(fā)連接請求的處理方法,默認自動選擇最優(yōu)方法
use epoll;

3佛寿、accept_mutex on | off 互斥

處理新的連接請求的方法；on指由各個worker輪流處理新請求但壮，Off指每個新請求的到達都會通知(喚醒)所有的worker進程冀泻，但只有一個進程可獲得連接，造成“驚群”蜡饵，影響性能弹渔，默認on

11.調(diào)試和定位問題：

1、daemon on|off

是否以守護進程方式運行nignx溯祸，默認是守護進程方式

2肢专、master_process on|off

是否以master/worker模型運行nginx；默認為on
off 將不啟動worker

3焦辅、error_log file [level]

錯誤日志文件及其級別博杖；出于調(diào)試需要，可設(shè)定為debug筷登；但debug僅在編譯時使用了“--with-debug”選項時才有效
方式：file /path/logfile;
stderr:發(fā)送到標(biāo)準錯誤
syslog:server-address[,parameter=values]:發(fā)送到syslog
memory:size 內(nèi)存
level:debug|info|notice|warn|error|crit|alter|emerg

12. http協(xié)議的相關(guān)配置：

http {
... ...
server {
...
server_name
root
location [OPERATOR] /uri/ {
...
}
}
server {
...
}
}
ngx_http_core_module
? ngx_http_core_module

13.ngx_http_core_module模塊

與套接字相關(guān)的配置：

1剃根、server { ... }

配置一個虛擬主機
server {
listen address[:PORT]|PORT;
server_name SERVER_NAME;
root /PATH/TO/DOCUMENT_ROOT;
}

ngx_http_core_module

2、listen PORT|address[:port]|unix:/PATH/TO/SOCKET_FILE

listen address[:port] [default_server] [ssl] [http2 | spdy]
[backlog=number] [rcvbuf=size] [sndbuf=size]
default_server 設(shè)定為默認虛擬主機
ssl 限制僅能夠通過ssl連接提供服務(wù)
backlog=number 超過并發(fā)連接數(shù)后前方，新請求進入后援隊列的長度
rcvbuf=size 接收緩沖區(qū)大小
sndbuf=size 發(fā)送緩沖區(qū)大小
? 注意：
(1) 基于port狈醉；
listen PORT; 指令監(jiān)聽在不同的端口
(2) 基于ip的虛擬主機
listen IP:PORT; IP 地址不同
(3) 基于hostname
server_name fqdn; 指令指向不同的主機名
ngx_http_core_module

3、server_name name ...;

? 虛擬主機的主機名稱后可跟多個由空白字符分隔的字符串
? 支持通配任意長度的任意字符
server_name .magedu.com www.magedu.
? 支持~起始的字符做正則表達式模式匹配镣丑，性能原因慎用
server_name ~^www\d+.magedu.com$
\d 表示 [0-9]
? 匹配優(yōu)先級機制從高到低：
(1) 首先是字符串精確匹配 如：www.magedu.com
(2) 左側(cè)通配符 如：.magedu.com
(3) 右側(cè)通配符 如：www.magedu.*
(4) 正則表達式 如： ~^.*.magedu.com$
(5) default_server
ngx_http_core_module

4舔糖、tcp_nodelay on | off;

在keepalived模式下的連接是否啟用TCP_NODELAY選項
當(dāng)為off時，延遲發(fā)送莺匠，合并多個請求后再發(fā)送
默認On時金吗，不延遲發(fā)送
可用于：http, server, location

5、sendfile on | off;

是否啟用sendfile功能趣竣，在內(nèi)核中封裝報文直接發(fā)送
默認Off

6摇庙、server_tokens on | off | build | string

是否在響應(yīng)報文的Server首部顯示nginx版本
ngx_http_core_module
? 定義路徑相關(guān)的配置

7、root

? 設(shè)置web資源的路徑映射遥缕；用于指明請求的URL所對應(yīng)的文檔的目錄路徑卫袒，可用于http, server, location, if in location
server {
...
root /data/www/vhost1;
}
? 示例
http://www.magedu.com/images/logo.jpg
--> /data/www/vhosts/images/logo.jpg
ngx_http_core_module

8、location [ = | ~ | ~* | ^~ ] uri { ... } location @name { ... }

在一個server中l(wèi)ocation配置段可存在多個单匣，用于實現(xiàn)從uri到
文件系統(tǒng)的路徑映射夕凝；ngnix會根據(jù)用戶請求的URI來檢查定義的所有
location宝穗，并找出一個最佳匹配，而后應(yīng)用其配置
? 示例：
server {...
server_name www.magedu.com;
location /images/ {
root /data/imgs/;
}
}
http://www.magedu.com/images/logo.jpg
--> /data/imgs/images/logo.jpg
ngx_http_core_module
? =：對URI做精確匹配码秉；
location = / {
...
}
http://www.magedu.com/ 匹配
http://www.magedu.com/index.html 不匹配

? ^~：對URI的最左邊部分做匹配檢查逮矛，不區(qū)分字符大小寫
? ~：對URI做正則表達式模式匹配，區(qū)分字符大小寫
? ~：對URI做正則表達式模式匹配转砖，不區(qū)分字符大小寫
? 不帶符號：匹配起始于此uri的所有的uri
? 匹配優(yōu)先級從高到低：
=, ^~, ～/～, 不帶符號

?示例：
? root /vhosts/www/htdocs/
http://www.magedu.com/index.html
--> /vhosts/www/htdocs/index.html
? server {
root /vhosts/www/htdocs/
location /admin/ {
root /webapps/app1/data/
}
}
http://www.magedu.com/admin/index.html
--> /webapps/app1/data/admin/index.html

location示例
location = / {
[ configuration A ]
}
location / {
[ configuration B ]
}
location /documents/ {
[ configuration C ]
}
location ^~ /images/ {
[ configuration D ]
}
location ~* \.(gif|jpg|jpeg)$ {
[ configuration E ]
}
http://www.mgadu.com
http://www.magedu.com/index.html
http://www.magedu.com/documents/log.jpg
http://www.magedu.com/documents/linux.txt
lhttp://www.magedu.com/images/log.jpeg

9须鼎、alias path;

路徑別名，文檔映射的另一種機制府蔗；僅能用于location上下文

? 示例：
http://www.magedu.com/bbs/index.php
location /bbs/ {
alias /web/forum/;
} --> /web/forum/index.html
location /bbs/ {
root /web/forum/;
} --> /web/forum/bbs/index.html

? 注意：location中使用root指令和alias指令的意義不同
(a) root晋控，給定的路徑對應(yīng)于location中的/uri/左側(cè)的/
(b) alias，給定的路徑對應(yīng)于location中的/uri/右側(cè)的/

10姓赤、index file ...;

指定默認網(wǎng)頁資源赡译，注意：ngx_http_index_module模塊

11、error_page code ... [=[response]] uri;

模塊：ngx_http_core_module
定義錯誤頁不铆，以指定的響應(yīng)狀態(tài)碼進行響應(yīng)
可用位置：http, server, location, if in location
error_page 404 /404.html
error_page 404 =200 /404.html

12捶朵、try_files file ... uri; try_files file ... =code;

按順序檢查文件是否存在，返回第一個找到的文件或文件夾（結(jié)尾加斜線表示為文件夾）狂男，如果所有的文件或文件夾都找不到，會進行一個內(nèi)部重定向到最后一個參數(shù)品腹。只有最后一個參數(shù)可以引起一個內(nèi)部重定向岖食，之前的參數(shù)只設(shè)置內(nèi)部URI的指向。最后一個參數(shù)是回退URI且必須存在舞吭，否則會出現(xiàn)內(nèi)部500錯誤
location /images/ { try_files $uri /images/default.gif; }
location / { try_files $uri $uri/index.html $uri.html =404; }
? 定義客戶端請求的相關(guān)配置

13泡垃、keepalive_timeout timeout [header_timeout];

設(shè)定保持連接超時時長，0表示禁止長連接羡鸥，默認為75s

14蔑穴、keepalive_requests number;

在一次長連接上所允許請求的資源的最大數(shù)量
默認為100

15、keepalive_disable none | browser ...

對哪種瀏覽器禁用長連接

16惧浴、send_timeout time;

向客戶端發(fā)送響應(yīng)報文的超時時長存和，此處是指兩次寫操作之間的間隔時長，而非整個響應(yīng)過程的傳輸時長

17衷旅、client_body_buffer_size size;

用于接收每個客戶端請求報文的body部分的緩沖區(qū)大芯柰取；默認為16k柿顶；超出此大小時茄袖，其將被暫存到磁盤上的由
client_body_temp_path指令所定義的位置

18、client_body_temp_path path [level1 [level2 [level3]]];

設(shè)定用于存儲客戶端請求報文的body部分的臨時存儲路徑及子目錄結(jié)構(gòu)和數(shù)量
目錄名為16進制的數(shù)字嘁锯；
client_body_temp_path /var/tmp/client_body 1 2 2
1 1級目錄占1位16進制宪祥，即2^4=16個目錄 0-f
2 2級目錄占2位16進制聂薪，即2^8=256個目錄 00-ff
2 3級目錄占2位16進制，即2^8=256個目錄 00-ff
? 對客戶端進行限制的相關(guān)配置

19蝗羊、limit_rate rate;

限制響應(yīng)給客戶端的傳輸速率藏澳，單位是bytes/second
默認值0表示無限制

20、limit_except method ... { ... }肘交，僅用于location

限制客戶端使用除了指定的請求方法之外的其它方法
method:GET, HEAD, POST, PUT, DELETE
MKCOL, COPY, MOVE, OPTIONS, PROPFIND,
PROPPATCH, LOCK, UNLOCK, PATCH
limit_except GET {
allow 192.168.1.0/24;
deny all;
} 除了GET和HEAD 之外其它方法僅允許192.168.1.0/24網(wǎng)
段主機使用

文件操作優(yōu)化的配置

21笆载、aio on | off | threads[=pool];

是否啟用aio功能

22、directio size | off;

是否同步（直接）寫磁盤涯呻，而非寫緩存凉驻，在Linux主機啟用
O_DIRECT標(biāo)記，則文件大于等于給定大小時使用复罐，例如directio 4m

23涝登、open_file_cache off;

open_file_cache max=N [inactive=time];
nginx可以緩存以下三種信息：
(1) 文件元數(shù)據(jù)：文件的描述符、文件大小和最近一次的修改時間
(2) 打開的目錄結(jié)構(gòu)
(3) 沒有找到的或者沒有權(quán)限訪問的文件的相關(guān)信息
max=N：可緩存的緩存項上限效诅；達到上限后會使用LRU算法實現(xiàn)管理
inactive=time：緩存項的非活動時長胀滚，在此處指定的時長內(nèi)未被命中的或命中的次數(shù)少于open_file_cache_min_uses指令所指定的次數(shù)的緩存項
即為非活動項，將被刪除

24乱投、open_file_cache_errors on | off;

是否緩存查找時發(fā)生錯誤的文件一類的信息
默認值為off

25咽笼、open_file_cache_min_uses number;

open_file_cache指令的inactive參數(shù)指定的時長內(nèi)，至少被命中此處指定的次數(shù)方可被歸類為活動項
默認值為1

26戚炫、open_file_cache_valid time;

緩存項有效性的檢查頻率
默認值為60s
ngx_http_access_module
? ngx_http_access_module模塊
實現(xiàn)基于ip的訪問控制功能
? 1剑刑、allow address | CIDR | unix: | all;
? 2、deny address | CIDR | unix: | all;
http, server, location, limit_except
自上而下檢查双肤，一旦匹配施掏，將生效，條件嚴格的置前
? 示例：
location / {
deny 192.168.1.1;
allow 192.168.1.0/24;
allow 10.1.1.0/16;
allow 2001:0db8::/32;
deny all;
}

14.ngx_http_auth_basic_module模塊

實現(xiàn)基于用戶的訪問控制茅糜，使用basic機制進行用戶認證

1七芭、auth_basic string | off;

2、auth_basic_user_file file;

location /admin/ {
auth_basic "Admin Area";
auth_basic_user_file /etc/nginx/.ngxpasswd;
}
? 用戶口令：
1蔑赘、明文文本：格式name:password:comment
2狸驳、加密文本：由htpasswd命令實現(xiàn)
httpd-tools所提供

15.ngx_http_stub_status_module模塊

用于輸出nginx的基本狀態(tài)信息
輸出信息示例：
Active connections: 291
server accepts handled requests
16630948 16630948 31070465
對應(yīng)上面accepts,handled,requests三個值
Reading: 6 Writing: 179 Waiting: 106
Active connections:當(dāng)前狀態(tài)，活動狀態(tài)的連接數(shù)
accepts：統(tǒng)計總值米死，已經(jīng)接受的客戶端請求的總數(shù)
handled：統(tǒng)計總值锌历，已經(jīng)處理完成的客戶端請求的總數(shù)
requests：統(tǒng)計總值，客戶端發(fā)來的總的請求數(shù)
Reading：當(dāng)前狀態(tài)峦筒，正在讀取客戶端請求報文首部的連接的連接數(shù)
Writing：當(dāng)前狀態(tài)究西，正在向客戶端發(fā)送響應(yīng)報文過程中的連接數(shù)
Waiting：當(dāng)前狀態(tài)，正在等待客戶端發(fā)出請求的空閑連接數(shù)

1物喷、stub_status;

示例：
location /status {
stub_status;
allow 172.16.0.0/16;
deny all;
}

16. ngx_http_log_module模塊: 指定日志格式記錄請求

1卤材、log_format name string ...;

string可以使用nginx核心模塊及其它模塊內(nèi)嵌的變量

2遮斥、access_log path [format [buffer=size] [gzip[=level]]

[flush=time] [if=condition]];
access_log off;
訪問日志文件路徑，格式及相關(guān)的緩沖的配置
buffer=size
flush=time

? 示例
log_format compression '$remote_addr-$remote_user [$time_local] '
'"$request" $status $bytes_sent '
'"$http_referer" "$http_user_agent" "$gzip_ratio"';
access_log /spool/logs/nginx-access.log compression buffer=32k;

3扇丛、open_log_file_cache max=N [inactive=time] [min_uses=N] [valid=time];

open_log_file_cache off;
緩存各日志文件相關(guān)的元數(shù)據(jù)信息
max：緩存的最大文件描述符數(shù)量
min_uses：在inactive指定的時長內(nèi)訪問大于等于此值方
可被當(dāng)作活動項
inactive：非活動時長
valid：驗正緩存中各緩存項是否為活動項的時間間隔

17. ngx_http_gzip_module模塊：用gzip方法壓縮響應(yīng)數(shù)據(jù)术吗，節(jié)約帶寬

1、gzip on | off;

啟用或禁用gzip壓縮

2帆精、gzip_comp_level level;

壓縮比由低到高：1 到 9
默認：1

3较屿、gzip_disable regex ...;

匹配到客戶端瀏覽器不執(zhí)行壓縮

4、gzip_min_length length;

啟用壓縮功能的響應(yīng)報文大小閾值

5卓练、gzip_http_version 1.0 | 1.1;

設(shè)定啟用壓縮功能時隘蝎，協(xié)議的最小版本
默認：1.1

6、gzip_buffers number size;

支持實現(xiàn)壓縮功能時緩沖區(qū)數(shù)量及每個緩存區(qū)的大小
默認：32 4k 或 16 8k

7襟企、gzip_types mime-type ...;

指明僅對哪些類型的資源執(zhí)行壓縮操作嘱么；即壓縮過濾器
默認包含有text/html，不用顯示指定顽悼，否則出錯

8曼振、gzip_vary on | off;

如果啟用壓縮，是否在響應(yīng)報文首部插入“Vary: AcceptEncoding”

9蔚龙、gzip_proxied off | expired | no-cache | no-store | private | no_last_modified | no_etag | auth | any ...;

nginx對于代理服務(wù)器請求的響應(yīng)報文冰评，在何種條件下啟用壓縮功能
off：對被代理的請求不啟用壓縮
expired,no-cache, no-store，private：對代理服務(wù)器
請求的響應(yīng)報文首部Cache-Control值任何一個木羹，啟用壓縮功能

? 示例：
gzip on;
gzip_comp_level 6;
gzip_min_length 64;
gzip_proxied any;
gzip_types text/xml text/css application/javascript;

18. ngx_http_ssl_module模塊：

1集索、ssl on | off;

為指定虛擬機啟用HTTPS protocol， 建議用listen指令代替

2汇跨、ssl_certificate file;

當(dāng)前虛擬主機使用PEM格式的證書文件

3、ssl_certificate_key file;

當(dāng)前虛擬主機上與其證書匹配的私鑰文件

4妆距、ssl_protocols [SSLv2] [SSLv3] [TLSv1] [TLSv1.1] [TLSv1.2];

支持ssl協(xié)議版本穷遂，默認為后三個

5、ssl_session_cache off | none | [builtin[:size]] [shared:name:size];

builtin[:size]：使用OpenSSL內(nèi)建緩存娱据，為每worker進程私有
[shared:name:size]：在各worker之間使用一個共享的緩存

6蚪黑、ssl_session_timeout time;

客戶端連接可以復(fù)用ssl session cache中緩存的ssl參數(shù)的有效時長，默認5m

? 示例：
server {
listen 443 ssl;
server_name www.magedu.com;
root /vhosts/ssl/htdocs;
ssl on;
ssl_certificate /etc/nginx/ssl/nginx.crt;
ssl_certificate_key /etc/nginx/ssl/nginx.key;
ssl_session_cache shared:sslcache:20m;
ssl_session_timeout 10m;
}

19.ngx_http_rewrite_module模塊：

The ngx_http_rewrite_module module is used to change request URI using PCRE regular expressions, return redirects, and conditionally select configurations.
將用戶請求的URI基于PCRE regex所描述的模式進行檢查中剩，而后完成重定向替換

? 示例：
http://www.magedu.com/hn
--> http://www.magedu.com/henan
http://www.magedu.com
--> https://www.magedu.com/

1忌穿、rewrite regex replacement [flag]

將用戶請求的URI基于regex所描述的模式進行檢查，匹配到時將其替換為replacement指定的新的URI
注意：如果在同一級配置塊中存在多個rewrite規(guī)則结啼，那么會自下而下逐個檢查掠剑；被某條件規(guī)則替換完成后，會重新一輪的替換檢查
隱含有循環(huán)機制,但不超過10次郊愧；如果超過朴译，提示500響應(yīng)碼井佑，[flag]所表示的標(biāo)志位用于控制此循環(huán)機制如果replacement是以http://或https://開頭，則替換結(jié)果會直接以重向返回給客戶端
301：永久重定向
? [flag]：
last：重寫完成后停止對當(dāng)前URI在當(dāng)前l(fā)ocation中后續(xù)的其它重寫操作眠寿，而后對新的 URI啟動新一輪重寫檢查躬翁；提前重啟新一輪循環(huán)
break：重寫完成后停止對當(dāng)前URI在當(dāng)前l(fā)ocation中后續(xù)的其它重寫操作，而后直接跳轉(zhuǎn)至重寫規(guī)則配置塊之后的其它配置盯拱；結(jié)束循環(huán)盒发，建議在location中使用
redirect：臨時重定向，重寫完成后以臨時重定向方式直接返回重寫后生成的新URI給客戶端狡逢，由客戶端重新發(fā)起請求宁舰；不能以http://或https://開頭，使用相對路徑甚侣，狀態(tài)碼：302
permanent:重寫完成后以永久重定向方式直接返回重寫后生成的新URI給客戶端明吩，由客戶端重新發(fā)起請求，狀態(tài)碼：301

2殷费、return

return code [text];
return code URL;
return URL;
停止處理印荔，并返回給客戶端指定的響應(yīng)碼

3、rewrite_log on | off;

是否開啟重寫日志, 發(fā)送至error_log（notice level）

4详羡、set $variable value;

用戶自定義變量
注意：變量定義和調(diào)用都要以$開頭

5仍律、if (condition) { ... }

引入新的上下文,條件滿足時，執(zhí)行配置塊中的配置指令实柠；server, location condition：
比較操作符：
== 相同
!= 不同
~：模式匹配水泉，區(qū)分字符大小寫
~*：模式匹配，不區(qū)分字符大小寫
!~：模式不匹配窒盐，區(qū)分字符大小寫
!~*：模式不匹配草则，不區(qū)分字符大小寫
文件及目錄存在性判斷：
-e, !-e 存在（包括文件，目錄蟹漓，軟鏈接）
-f, !-f 文件
-d, !-d 目錄
-x, !-x 執(zhí)行

20.ngx_http_referer_module模塊：

The ngx_http_referer_module module is used to block access to a site for requests with invalid values in the
“Referer” header field. 可防止盜鏈

1炕横、valid_referers none|blocked|server_names|string ...;

定義referer首部的合法可用值，不能匹配的將是非法值
none：請求報文首部沒有referer首部
blocked：請求報文有referer首部葡粒，但無有效值
server_names：參數(shù)份殿，其可以有值作為主機名或主機名模式
arbitrary_string：任意字符串，但可使用作通配符
regular expression：被指定的正則表達式模式匹配到的字符串,要使用~開頭嗽交，例如： ~..magedu.com

? 示例：
valid_referers none block server_names *.magedu.com
*.mageedu.com magedu.* mageedu.* ~\.magedu\.;
if ($invalid_referer) {
return 403;
}

21. ngx_http_proxy_module模塊：

? The ngx_http_proxy_module module allows passing requests to another
server.

1卿嘲、proxy_pass URL;

Context:location, if in location, limit_except
注意：proxy_pass后面的路徑不帶uri時，其會將location的uri傳遞給后端主機

server {
...
server_name HOSTNAME;
location /uri/ {
proxy_pass http://host[:port]; 最后沒有/
}
...
}
上面示例：http://HOSTNAME/uri --> http://host/uri
http://host[:port]/ 意味著：http://HOSTNAME/uri --> http://host/

? proxy_pass后面的路徑是一個uri時夫壁，其會將location的uri替
換為proxy_pass的uri

server {
...
server_name HOSTNAME;
location /uri/ {
proxy_pass http://host/new_uri/;
}
...
}
http://HOSTNAME/uri/ --> http://host/new_uri/

? 如果location定義其uri時使用了正則表達式的模式拾枣，則
proxy_pass之后必須不能使用uri; 用戶請求時傳遞的uri將直
接附加代理到的服務(wù)的之后

server {
...
server_name HOSTNAME;
location ~|~* /uri/ {
proxy_pass http://host; 不能加/
}
...
}
http://HOSTNAME/uri/ --> http://host/uri/

2、proxy_set_header field value;

設(shè)定發(fā)往后端主機的請求報文的請求首部的值
Context: http, server, location
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
標(biāo)準格式如下：
X-Forwarded-For: client1, proxy1, proxy2

3盒让、proxy_cache_path;

定義可用于proxy功能的緩存放前；Context:http
proxy_cache_path path [levels=levels] [use_temp_path=on|off]
keys_zone=name:size [inactive=time] [max_size=size]
[manager_files=number] [manager_sleep=time]
[manager_threshold=time] [loader_files=number] [loader_sleep=time]
[loader_threshold=time] [purger=on|off] [purger_files=number]
[purger_sleep=time] [purger_threshold=time];

4忿磅、proxy_cache zone | off; 默認off

指明調(diào)用的緩存，或關(guān)閉緩存機制凭语；Context:http,server, location

5葱她、proxy_cache_key string;

緩存中用于“鍵”的內(nèi)容
默認值：proxy_cache_key $scheme$proxy_host$request_uri;

6、proxy_cache_valid [code ...] time;

定義對特定響應(yīng)碼的響應(yīng)內(nèi)容的緩存時長
定義在http{...}中

示例:
proxy_cache_valid 200 302 10m;
proxy_cache_valid 404 1m;
? 示例：
在http配置定義緩存信
proxy_cache_path /var/cache/nginx/proxy_cache
levels=1:1:1 keys_zone=proxycache:20m
inactive=120s max_size=1g;
調(diào)用緩存功能似扔，需要定義在相應(yīng)的配置段吨些，如server{...}；
proxy_cache proxycache;
proxy_cache_key $request_uri;
proxy_cache_valid 200 302 301 1h;
proxy_cache_valid any 1m;

7炒辉、proxy_cache_use_stale;

proxy_cache_use_stale error | timeout |
invalid_header | updating | http_500 | http_502 |
http_503 | http_504 | http_403 | http_404 | off ...
在被代理的后端服務(wù)器出現(xiàn)哪種情況下豪墅，可以真接使用過期的緩存響應(yīng)客戶端

8、proxy_cache_methods GET | HEAD | POST ...;

對哪些客戶端請求方法對應(yīng)的響應(yīng)進行緩存黔寇，GET和
HEAD方法總是被緩存

9偶器、proxy_hide_header field;

By default, nginx does not pass the header fields
“Date”, “Server”, “X-Pad”, and “X-Accel-...” from the
response of a proxied server to a client. 用于隱藏后端服務(wù)器特定的響應(yīng)首部

10、proxy_connect_timeout time;

定義與后端服務(wù)器建立連接的超時時長缝裤，如超時會出現(xiàn)502錯誤屏轰，默認為60s，一般不建議超出75s憋飞，

11霎苗、 proxy_send_timeout time;

把請求發(fā)送給后端服務(wù)器的超時時長；默認為60s

12榛做、proxy_read_timeout time;

等待后端服務(wù)器發(fā)送響應(yīng)報文的超時時長唁盏，默認為60s

22.ngx_http_headers_module模塊

向由代理服務(wù)器響應(yīng)給客戶端的響應(yīng)報文添加自定義首部，或修改指定首部的值

1检眯、add_header name value [always];

添加自定義首部
add_header X-Via $server_addr;
add_header X-Cache $upstream_cache_status;
add_header X-Accel $server_name;

2厘擂、 add_trailer name value [always];

添加自定義響應(yīng)信息的尾部

23.ngx_http_fastcgi_module模塊

轉(zhuǎn)發(fā)請求到FastCGI服務(wù)器，不支持php模塊方式

1锰瘸、fastcgi_pass address;

address為后端的fastcgi server的地址
可用位置：location, if in location

2驴党、fastcgi_index name;

fastcgi默認的主頁資源
示例：fastcgi_index index.php;

3、fastcgi_param parameter value [if_not_empty];

設(shè)置傳遞給 FastCGI服務(wù)器的參數(shù)值获茬，可以是文本，變量或組合

? 示例1：
? 1）在后端服務(wù)器先配置fpm server和mariadb-server
? 2）在前端nginx服務(wù)上做以下配置：
location ~* \.php$ {
fastcgi_pass 后端fpm服務(wù)器IP:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME
/usr/share/nginx/html$fastcgi_script_name;
include fastcgi_params;
…
}
? 示例2：通過/pm_status和/ping來獲取fpm server狀態(tài)信息
location ~* ^/(pm_status|ping)$ {
include fastcgi_params;
fastcgi_pass 后端fpm服務(wù)器IP:9000;
fastcgi_param SCRIPT_FILENAME
$fastcgi_script_name;
}

4倔既、fastcgi_cache_path path [levels=levels] [use_temp_path=on|off]

keys_zone=name:size [inactive=time] [max_size=size]
[manager_files=number] [manager_sleep=time] [manager_threshold=time]
[loader_files=number] [loader_sleep=time] [loader_threshold=time]
[purger=on|off] [purger_files=number] [purger_sleep=time]
[purger_threshold=time];
? 定義fastcgi的緩存恕曲；
path 緩存位置為磁盤上的文件系統(tǒng)
max_size=size
磁盤path路徑中用于緩存數(shù)據(jù)的緩存空間上限
levels=levels：緩存目錄的層級數(shù)量，以及每一級的目錄數(shù)量
levels=ONE:TWO:THREE
示例：leves=1:2:2
keys_zone=name:size
k/v映射的內(nèi)存空間的名稱及大小
inactive=time
非活動時長

5渤涌、fastcgi_cache zone | off;

調(diào)用指定的緩存空間來緩存數(shù)據(jù)
可用位置：http, server, location

6佩谣、fastcgi_cache_key string;

定義用作緩存項的key的字符串

示例：fastcgi_cache_key $request_rui;

7、fastcgi_cache_methods GET | HEAD | POST ...;

為哪些請求方法使用緩存

8实蓬、fastcgi_cache_min_uses number;

緩存空間中的緩存項在inactive定義的非活動時間內(nèi)至少要被訪問到此處所指定的次數(shù)方可被認作活動項

9茸俭、fastcgi_keep_conn on | off;

收到后端服務(wù)器響應(yīng)后吊履，fastcgi服務(wù)器是否關(guān)閉連接，建議啟用長連接

10调鬓、fastcgi_cache_valid [code ...] time;

不同的響應(yīng)碼各自的緩存時長

? 示例：
http {
fastcgi_cache_path /var/cache/nginx/fcgi_cache
levels=1:2:1 keys_zone=fcgicache:20m inactive=120s;
...
server {
location ~* \.php$ {
...
fastcgi_cache fcgicache;
fastcgi_cache_key $request_uri;
fastcgi_cache_valid 200 302 10m;
fastcgi_cache_valid 301 1h;
fastcgi_cache_valid any 1m;
...
}
}

24.ngx_http_upstream_module模塊

用于將多個服務(wù)器定義成服務(wù)器組艇炎，而由proxy_pass,
fastcgi_pass等指令進行引用

1、upstream name { ... }

定義后端服務(wù)器組腾窝，會引入一個新的上下文
默認調(diào)度算法是wrr
Context: http
upstream httpdsrvs {
server ...
server...
...
}

2缀踪、server address [parameters];

在upstream上下文中server成員，以及相關(guān)的參數(shù)虹脯；Context:upstream
address的表示格式：
unix:/PATH/TO/SOME_SOCK_FILE
IP[:PORT]
HOSTNAME[:PORT]
parameters：
weight=number 權(quán)重驴娃，默認為1
max_conns 連接后端報務(wù)器最大并發(fā)活動連接數(shù)，1.11.5后支持
max_fails=number 失敗嘗試最大次數(shù)循集；超出此處指定的次數(shù)時唇敞，server將被標(biāo)記為不可用,默認為1
fail_timeout=time 后端服務(wù)器標(biāo)記為不可用狀態(tài)的連接超時時長，默認10s
backup 將服務(wù)器標(biāo)記為“備用”咒彤，即所有服務(wù)器均不可用時才啟用
down 標(biāo)記為“不可用”疆柔，配合ip_hash使用，實現(xiàn)灰度發(fā)布

3蔼紧、ip_hash 源地址hash調(diào)度方法

4婆硬、least_conn 最少連接調(diào)度算法，當(dāng)server擁有不同的權(quán)重時其為wlc奸例，當(dāng)所有后端主機連接數(shù)相同時彬犯，則使用wrr，適用于長連接

5查吊、hash key [consistent] 基于指定的key的hash表來實現(xiàn)對請求的調(diào)度谐区，此處key可以直接文本、變量或二者組合

作用：將請求分類逻卖，同一類請求將發(fā)往同一個upstream
server宋列，使用consistent參數(shù)，將使用ketama一致性hash算法评也，
適用于后端是Cache服務(wù)器（如varnish）時使用
hash $request_uri consistent;
hash $remote_addr;

6炼杖、keepalive 連接數(shù)N;

為每個worker進程保留的空閑的長連接數(shù)量,可節(jié)約nginx端口，并減少連接管理的消耗

7盗迟、health_check [parameters];

健康狀態(tài)檢測機制坤邪；只能用于location上下文
常用參數(shù)：
interval=time檢測的頻率，默認為5秒
fails=number：判定服務(wù)器不可用的失敗檢測次數(shù)罚缕；默認為1次
passes=number：判定服務(wù)器可用的失敗檢測次數(shù)艇纺；默認為1次
uri=uri：做健康狀態(tài)檢測測試的目標(biāo)uri；默認為/
match=NAME：健康狀態(tài)檢測的結(jié)果評估調(diào)用此處指定的match配置塊
注意：僅對nginx plus有效

8、 match name { ... }

對backend server做健康狀態(tài)檢測時，定義其結(jié)果判斷機制；
只能用于http上下文
? 常用的參數(shù)：
status code[ code ...]: 期望的響應(yīng)狀態(tài)碼
header HEADER[operator value]：期望存在響應(yīng)首
部鉴嗤，也可對期望的響應(yīng)首部的值基于比較操作符和值進行比較
body：期望響應(yīng)報文的主體部分應(yīng)該有的內(nèi)容
注意：僅對nginx plus有效

25.ngx_stream_core_module模塊

? nginx的其它的二次發(fā)行版：
Tengine：由淘寶網(wǎng)發(fā)起的Web服務(wù)器項目。它在Nginx的基礎(chǔ)上夜牡，針對大訪問量網(wǎng)站的需求，添加了很多高級功能和特性捞高。Tengine的性能和穩(wěn)定性已經(jīng)在大型的網(wǎng)站如淘寶網(wǎng)氯材，天貓商城等得到了很好的檢驗。它的最終目標(biāo)是打造一個高效硝岗、穩(wěn)定氢哮、安全、易用的Web平臺型檀。從2011年12月開始冗尤，Tengine成為一個開源項目，官網(wǎng) http://tengine.taobao.org/
OpenResty：基于 Nginx 與 Lua 語言的高性能 Web平臺
? ngx_stream_core_module模塊
模擬反代基于tcp或udp的服務(wù)連接胀溺，即工作于傳輸層的反代或調(diào)度器

1裂七、stream { ... }

定義stream相關(guān)的服務(wù)；Context:main
stream {
upstream telnetsrvs {
server 192.168.22.2:23;
server 192.168.22.3:23;
least_conn;
}
server {
listen 10.1.0.6:23;
proxy_pass telnetsrvs;
}
}

2仓坞、listen

listen address:port [ssl] [udp] [proxy_protocol]
[backlog=number] [bind] [ipv6only=on|off] [reuseport]
[so_keepalive=on|off|[keepidle]:[keepintvl]:[keepcnt]];

26. ngx_stream_proxy_module模塊

可實現(xiàn)代理基于TCP背零，UDP (1.9.13), UNIX-domain
sockets的數(shù)據(jù)流

1 proxy_pass address;

指定后端服務(wù)器地址

2 proxy_timeout timeout;

無數(shù)據(jù)傳輸時，保持連接狀態(tài)的超時時長
默認為10m

3 proxy_connect_timeout time;

設(shè)置nginx與被代理的服務(wù)器嘗試建立連接的超時時長
默認為60s

示例
stream {
upstream telnetsrvs {
server 192.168.10.130:23;
server 192.168.10.131:23;
hash $remote_addr consistent;
}
server {
listen 172.16.100.10:2323;
proxy_pass telnetsrvs;
proxy_timeout 60s;
proxy_connect_timeout 10s;
}
}