1.簡介：
? Nginx：engine X ，2002年，開源，商業版
? http協議：web服務器（類似于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）
? 二次開發版：Tengine, OpenResty
? 官網：http://nginx.org
正向代理和反向代理
Paste_Image.png
(1)特性：
? 模塊化設計，較好的擴展性
? 高可靠性
? 支持熱部署：不停機更新配置文件，升級版本，更換日志文件
? 低內存消耗：10000個keep-alive連接模式下的非活動連接，僅需要2.5M內存
? event-driven,aio,mmap，sendfile
(2)基本功能：
? 靜態資源的web服務器
? http協議反向代理服務器
? pop3/imap4協議反向代理服務器
? FastCGI(lnmp),uWSGI(python)等協議
? 模塊化（非DSO），如zip，SSL模塊
2.nginx的程序架構
(1) web服務相關的功能：
虛擬主機（server）
支持 keep-alive 和管道連接
訪問日志（支持基于日志緩沖提高其性能）
url rewirte
路徑別名
基于IP及用戶的訪問控制
支持速率限制及并發數限制
重新配置和在線升級而無須中斷客戶的工作進程
Memcached 的 GET 接口
nginx架構
Paste_Image.png
(2) master/worker結構
? 一個master進程：
負載加載和分析配置文件、管理worker進程、平滑升級
? 一個或多個worker進程
處理并響應用戶請求
? 緩存相關的進程：
cache loader：載入緩存對象
cache manager：管理緩存對象
3.nginx模塊
? nginx高度模塊化，但其模塊早期不支持DSO機制；1.9.11版
本支持動態裝載和卸載
? 模塊分類：
? 核心模塊：core module
? 標準模塊：
? HTTP 模塊： ngx_http_*
HTTP Core modules 默認功能
HTTP Optional modules 需編譯時指定
? Mail 模塊 ngx_mail_*
? Stream 模塊 ngx_stream_*
? 第三方模塊
4.nginx的功用
? 靜態的web資源服務器
html，圖片，js，css，txt等靜態資源
? 結合FastCGI/uWSGI/SCGI等協議反向代理動態資源請求
? http/https協議的反向代理
? imap4/pop3協議的反向代理
? tcp/udp協議的請求轉發（反向代理）
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部分的臨時文件存放路徑，如果服務器允許客戶端使用put方法提交大數據時，臨時存放的磁盤路徑
? --http-proxy-temp-path=/var/cache/nginx/proxy_temp
作為代理服務器，服務器響應報文的臨時文件存放路徑
? --http-fastcgi-temppath=/var/cache/nginx/fastcgi_temp
作為fastcgi代理服務器，服務器響應報文的臨時文件存放路徑
? --http-uwsgi-temp-path=/var/cache/nginx/uwsgi_temp
作為uwsgi代理服務器，服務器響應報文的臨時文件存放路徑
? --http-scgi-temp-path=/var/cache/nginx/scgi_temp 作為
scgi反代服務器，服務器響應報文的臨時文件存放路徑
? --user=nginx 指明以那個身份運行worker進程，主控master進程一般由root運行
? --group=nginx
? --with-http_ssl_module 表示把指定模塊編譯進來
6.nginx目錄結構和命令
? ls /usr/local/nginx/
html是測試頁，sbin是主程序
? ls /usr/local/nginx/sbin/
nginx 只有一個程序文件
? ls /usr/local/nginx/html/
50x.html index.html 測試網頁
? Nginx：默認為啟動nginx
-h 查看幫助選項
-t 測試nginx語法錯誤
-c filename 指定配置文件(default: /etc/nginx/nginx.conf)
-s signal 發送信號給master進程，signal可為：stop, quit,
reopen, reload
示例：-s stop 停止nginx -s reload 加載配置文件
-g directives 在命令行中指明全局指令
7.nginx配置
? 配置文件的組成部分：
? 主配置文件：nginx.conf
子配置文件 include conf.d/*.conf
? fastcgi， uwsgi，scgi等協議相關的配置文件
? mime.types：支持的mime類型
? 主配置文件的配置指令：
? directive value [value2 ...];
? 注意：
(1) 指令必須以分號結尾
(2) 支持使用配置變量
內建變量：由Nginx模塊引入，可直接引用
自定義變量：由用戶使用set命令定義
set variable_name value;
引用變量：$variable_name
? main block：主配置段，即全局配置段，對http,mail都有效
event {
...
} 事件驅動相關的配置
? http {
...
} http/https 協議相關配置段
? mail {
...
} mail 協議相關配置段
? stream {
...
} stream 服務器相關配置段
http協議相關的配置結構
http {
...
... 各server的公共配置
server { 每個server用于定義一個虛擬主機
...
}
server {
...
server_name 虛擬主機名
root 主目錄
alias 路徑別名
location [OPERATOR] URL { 指定URL的特性
...
if CONDITION {
...
}
}
}
}
? Main 全局配置段常見的配置指令分類
? 正常運行必備的配置
? 優化性能相關的配置
? 用于調試及定位問題相關的配置
? 事件驅動相關的配置
? 幫助文檔
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
指明要裝載的動態模塊路徑: /usr/lib64/nginx/modules
9. 性能優化相關的配置：
1、worker_processes number | auto
worker進程的數量；通常應該為當前主機的cpu的物理核心數
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值，設定worker進程優先級：[-20,20]
4、worker_rlimit_nofile number
worker進程所能夠打開的文件數量上限,如65535
10.事件驅動相關的配置:
? events {
...
}
1、worker_connections number
每個worker進程所能夠打開的最大并發連接數數量，如10240
總最大并發數：worker_processes * worker_connections
2、use method
指明并發連接請求的處理方法,默認自動選擇最優方法
use epoll;
3、accept_mutex on | off 互斥
處理新的連接請求的方法；on指由各個worker輪流處理新請求，Off指每個新請求的到達都會通知(喚醒)所有的worker進程，但只有一個進程可獲得連接，造成“驚群”，影響性能，默認on
11.調試和定位問題：
1、daemon on|off
是否以守護進程方式運行nignx，默認是守護進程方式
2、master_process on|off
是否以master/worker模型運行nginx；默認為on
off 將不啟動worker
3、error_log file [level]
錯誤日志文件及其級別；出于調試需要，可設定為debug；但debug僅在編譯時使用了“--with-debug”選項時才有效
方式：file /path/logfile;
stderr:發送到標準錯誤
syslog:server-address[,parameter=values]:發送到syslog
memory:size 內存
level:debug|info|notice|warn|error|crit|alter|emerg
12. http協議的相關配置：
http {
... ...
server {
...
server_name
root
location [OPERATOR] /uri/ {
...
}
}
server {
...
}
}
ngx_http_core_module
? ngx_http_core_module
13.ngx_http_core_module模塊
與套接字相關的配置：
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 設定為默認虛擬主機
ssl 限制僅能夠通過ssl連接提供服務
backlog=number 超過并發連接數后，新請求進入后援隊列的長度
rcvbuf=size 接收緩沖區大小
sndbuf=size 發送緩沖區大小
? 注意：
(1) 基于port；
listen PORT; 指令監聽在不同的端口
(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]
? 匹配優先級機制從高到低：
(1) 首先是字符串精確匹配 如：www.magedu.com
(2) 左側通配符 如：.magedu.com
(3) 右側通配符 如：www.magedu.*
(4) 正則表達式 如： ~^.*.magedu.com$
(5) default_server
ngx_http_core_module
4、tcp_nodelay on | off;
在keepalived模式下的連接是否啟用TCP_NODELAY選項
當為off時，延遲發送，合并多個請求后再發送
默認On時，不延遲發送
可用于：http, server, location
5、sendfile on | off;
是否啟用sendfile功能，在內核中封裝報文直接發送
默認Off
6、server_tokens on | off | build | string
是否在響應報文的Server首部顯示nginx版本
ngx_http_core_module
? 定義路徑相關的配置
7、root
? 設置web資源的路徑映射；用于指明請求的URL所對應的文檔的目錄路徑，可用于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中location配置段可存在多個，用于實現從uri到
文件系統的路徑映射；ngnix會根據用戶請求的URI來檢查定義的所有
location，并找出一個最佳匹配，而后應用其配置
? 示例：
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的最左邊部分做匹配檢查，不區分字符大小寫
? ~：對URI做正則表達式模式匹配，區分字符大小寫
? ~：對URI做正則表達式模式匹配，不區分字符大小寫
? 不帶符號：匹配起始于此uri的所有的uri
? 匹配優先級從高到低：
=, ^~, ～/～, 不帶符號
?示例：
? 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，給定的路徑對應于location中的/uri/左側的/
(b) alias，給定的路徑對應于location中的/uri/右側的/
10、index file ...;
指定默認網頁資源，注意：ngx_http_index_module模塊
11、error_page code ... [=[response]] uri;
模塊：ngx_http_core_module
定義錯誤頁，以指定的響應狀態碼進行響應
可用位置：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;
按順序檢查文件是否存在，返回第一個找到的文件或文件夾（結尾加斜線表示為文件夾），如果所有的文件或文件夾都找不到，會進行一個內部重定向到最后一個參數。只有最后一個參數可以引起一個內部重定向，之前的參數只設置內部URI的指向。最后一個參數是回退URI且必須存在，否則會出現內部500錯誤
location /images/ { try_files $uri /images/default.gif; }
location / { try_files $uri $uri/index.html $uri.html =404; }
? 定義客戶端請求的相關配置
13、keepalive_timeout timeout [header_timeout];
設定保持連接超時時長，0表示禁止長連接，默認為75s
14、keepalive_requests number;
在一次長連接上所允許請求的資源的最大數量
默認為100
15、keepalive_disable none | browser ...
對哪種瀏覽器禁用長連接
16、send_timeout time;
向客戶端發送響應報文的超時時長，此處是指兩次寫操作之間的間隔時長，而非整個響應過程的傳輸時長
17、client_body_buffer_size size;
用于接收每個客戶端請求報文的body部分的緩沖區大?。荒J為16k；超出此大小時，其將被暫存到磁盤上的由
client_body_temp_path指令所定義的位置
18、client_body_temp_path path [level1 [level2 [level3]]];
設定用于存儲客戶端請求報文的body部分的臨時存儲路徑及子目錄結構和數量
目錄名為16進制的數字；
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
? 對客戶端進行限制的相關配置
19、limit_rate rate;
限制響應給客戶端的傳輸速率，單位是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網
段主機使用
文件操作優化的配置
21、aio on | off | threads[=pool];
是否啟用aio功能
22、directio size | off;
是否同步（直接）寫磁盤，而非寫緩存，在Linux主機啟用
O_DIRECT標記，則文件大于等于給定大小時使用，例如directio 4m
23、open_file_cache off;
open_file_cache max=N [inactive=time];
nginx可以緩存以下三種信息：
(1) 文件元數據：文件的描述符、文件大小和最近一次的修改時間
(2) 打開的目錄結構
(3) 沒有找到的或者沒有權限訪問的文件的相關信息
max=N：可緩存的緩存項上限；達到上限后會使用LRU算法實現管理
inactive=time：緩存項的非活動時長，在此處指定的時長內未被命中的或命中的次數少于open_file_cache_min_uses指令所指定的次數的緩存項
即為非活動項，將被刪除
24、open_file_cache_errors on | off;
是否緩存查找時發生錯誤的文件一類的信息
默認值為off
25、open_file_cache_min_uses number;
open_file_cache指令的inactive參數指定的時長內，至少被命中此處指定的次數方可被歸類為活動項
默認值為1
26、open_file_cache_valid time;
緩存項有效性的檢查頻率
默認值為60s
ngx_http_access_module
? ngx_http_access_module模塊
實現基于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模塊
實現基于用戶的訪問控制，使用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命令實現
httpd-tools所提供
15.ngx_http_stub_status_module模塊
用于輸出nginx的基本狀態信息
輸出信息示例：
Active connections: 291
server accepts handled requests
16630948 16630948 31070465
對應上面accepts,handled,requests三個值
Reading: 6 Writing: 179 Waiting: 106
Active connections:當前狀態，活動狀態的連接數
accepts：統計總值，已經接受的客戶端請求的總數
handled：統計總值，已經處理完成的客戶端請求的總數
requests：統計總值，客戶端發來的總的請求數
Reading：當前狀態，正在讀取客戶端請求報文首部的連接的連接數
Writing：當前狀態，正在向客戶端發送響應報文過程中的連接數
Waiting：當前狀態，正在等待客戶端發出請求的空閑連接數
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核心模塊及其它模塊內嵌的變量
2、access_log path [format [buffer=size] [gzip[=level]]
[flush=time] [if=condition]];
access_log off;
訪問日志文件路徑，格式及相關的緩沖的配置
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;
緩存各日志文件相關的元數據信息
max：緩存的最大文件描述符數量
min_uses：在inactive指定的時長內訪問大于等于此值方
可被當作活動項
inactive：非活動時長
valid：驗正緩存中各緩存項是否為活動項的時間間隔
17. ngx_http_gzip_module模塊：用gzip方法壓縮響應數據，節約帶寬
1、gzip on | off;
啟用或禁用gzip壓縮
2、gzip_comp_level level;
壓縮比由低到高：1 到 9
默認：1
3、gzip_disable regex ...;
匹配到客戶端瀏覽器不執行壓縮
4、gzip_min_length length;
啟用壓縮功能的響應報文大小閾值
5、gzip_http_version 1.0 | 1.1;
設定啟用壓縮功能時，協議的最小版本
默認：1.1
6、gzip_buffers number size;
支持實現壓縮功能時緩沖區數量及每個緩存區的大小
默認：32 4k 或 16 8k
7、gzip_types mime-type ...;
指明僅對哪些類型的資源執行壓縮操作；即壓縮過濾器
默認包含有text/html，不用顯示指定，否則出錯
8、gzip_vary on | off;
如果啟用壓縮，是否在響應報文首部插入“Vary: AcceptEncoding”
9、gzip_proxied off | expired | no-cache | no-store | private | no_last_modified | no_etag | auth | any ...;
nginx對于代理服務器請求的響應報文，在何種條件下啟用壓縮功能
off：對被代理的請求不啟用壓縮
expired,no-cache, no-store，private：對代理服務器
請求的響應報文首部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;
當前虛擬主機使用PEM格式的證書文件
3、ssl_certificate_key file;
當前虛擬主機上與其證書匹配的私鑰文件
4、ssl_protocols [SSLv2] [SSLv3] [TLSv1] [TLSv1.1] [TLSv1.2];
支持ssl協議版本，默認為后三個
5、ssl_session_cache off | none | [builtin[:size]] [shared:name:size];
builtin[:size]：使用OpenSSL內建緩存，為每worker進程私有
[shared:name:size]：在各worker之間使用一個共享的緩存
6、ssl_session_timeout time;
客戶端連接可以復用ssl session cache中緩存的ssl參數的有效時長，默認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規則，那么會自下而下逐個檢查；被某條件規則替換完成后，會重新一輪的替換檢查
隱含有循環機制,但不超過10次；如果超過，提示500響應碼，[flag]所表示的標志位用于控制此循環機制如果replacement是以http://或https://開頭，則替換結果會直接以重向返回給客戶端
301：永久重定向
? [flag]：
last：重寫完成后停止對當前URI在當前location中后續的其它重寫操作，而后對新的 URI啟動新一輪重寫檢查；提前重啟新一輪循環
break：重寫完成后停止對當前URI在當前location中后續的其它重寫操作，而后直接跳轉至重寫規則配置塊之后的其它配置；結束循環，建議在location中使用
redirect：臨時重定向，重寫完成后以臨時重定向方式直接返回重寫后生成的新URI給客戶端，由客戶端重新發起請求；不能以http://或https://開頭，使用相對路徑，狀態碼：302
permanent:重寫完成后以永久重定向方式直接返回重寫后生成的新URI給客戶端，由客戶端重新發起請求，狀態碼：301
2、return
return code [text];
return code URL;
return URL;
停止處理，并返回給客戶端指定的響應碼
3、rewrite_log on | off;
是否開啟重寫日志, 發送至error_log（notice level）
4、set $variable value;
用戶自定義變量
注意：變量定義和調用都要以$開頭
5、if (condition) { ... }
引入新的上下文,條件滿足時，執行配置塊中的配置指令；server, location condition：
比較操作符：
== 相同
!= 不同
~：模式匹配，區分字符大小寫
~*：模式匹配，不區分字符大小寫
!~：模式不匹配，區分字符大小寫
!~*：模式不匹配，不區分字符大小寫
文件及目錄存在性判斷：
-e, !-e 存在（包括文件，目錄，軟鏈接）
-f, !-f 文件
-d, !-d 目錄
-x, !-x 執行
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：參數，其可以有值作為主機名或主機名模式
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將直
接附加代理到的服務的之后
server {
...
server_name HOSTNAME;
location ~|~* /uri/ {
proxy_pass http://host; 不能加/
}
...
}
http://HOSTNAME/uri/ --> http://host/uri/
2、proxy_set_header field value;
設定發往后端主機的請求報文的請求首部的值
Context: http, server, location
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
標準格式如下：
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
指明調用的緩存，或關閉緩存機制；Context:http,server, location
5、proxy_cache_key string;
緩存中用于“鍵”的內容
默認值：proxy_cache_key $scheme$proxy_host$request_uri;
6、proxy_cache_valid [code ...] time;
定義對特定響應碼的響應內容的緩存時長
定義在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;
調用緩存功能，需要定義在相應的配置段，如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 ...
在被代理的后端服務器出現哪種情況下，可以真接使用過期的緩存響應客戶端
8、proxy_cache_methods GET | HEAD | POST ...;
對哪些客戶端請求方法對應的響應進行緩存，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. 用于隱藏后端服務器特定的響應首部
10、proxy_connect_timeout time;
定義與后端服務器建立連接的超時時長，如超時會出現502錯誤，默認為60s，一般不建議超出75s，
11、 proxy_send_timeout time;
把請求發送給后端服務器的超時時長；默認為60s
12、proxy_read_timeout time;
等待后端服務器發送響應報文的超時時長，默認為60s
22.ngx_http_headers_module模塊
向由代理服務器響應給客戶端的響應報文添加自定義首部，或修改指定首部的值
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];
添加自定義響應信息的尾部
23.ngx_http_fastcgi_module模塊
轉發請求到FastCGI服務器，不支持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];
設置傳遞給 FastCGI服務器的參數值，可以是文本，變量或組合
? 示例1：
? 1）在后端服務器先配置fpm server和mariadb-server
? 2）在前端nginx服務上做以下配置：
location ~* \.php$ {
fastcgi_pass 后端fpm服務器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狀態信息
location ~* ^/(pm_status|ping)$ {
include fastcgi_params;
fastcgi_pass 后端fpm服務器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 緩存位置為磁盤上的文件系統
max_size=size
磁盤path路徑中用于緩存數據的緩存空間上限
levels=levels：緩存目錄的層級數量，以及每一級的目錄數量
levels=ONE:TWO:THREE
示例：leves=1:2:2
keys_zone=name:size
k/v映射的內存空間的名稱及大小
inactive=time
非活動時長
5、fastcgi_cache zone | off;
調用指定的緩存空間來緩存數據
可用位置：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定義的非活動時間內至少要被訪問到此處所指定的次數方可被認作活動項
9、fastcgi_keep_conn on | off;
收到后端服務器響應后，fastcgi服務器是否關閉連接，建議啟用長連接
10、fastcgi_cache_valid [code ...] time;
不同的響應碼各自的緩存時長
? 示例：
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模塊
用于將多個服務器定義成服務器組，而由proxy_pass,
fastcgi_pass等指令進行引用
1、upstream name { ... }
定義后端服務器組，會引入一個新的上下文
默認調度算法是wrr
Context: http
upstream httpdsrvs {
server ...
server...
...
}
2、server address [parameters];
在upstream上下文中server成員，以及相關的參數；Context:upstream
address的表示格式：
unix:/PATH/TO/SOME_SOCK_FILE
IP[:PORT]
HOSTNAME[:PORT]
parameters：
weight=number 權重，默認為1
max_conns 連接后端報務器最大并發活動連接數，1.11.5后支持
max_fails=number 失敗嘗試最大次數；超出此處指定的次數時，server將被標記為不可用,默認為1
fail_timeout=time 后端服務器標記為不可用狀態的連接超時時長，默認10s
backup 將服務器標記為“備用”，即所有服務器均不可用時才啟用
down 標記為“不可用”，配合ip_hash使用，實現灰度發布
3、ip_hash 源地址hash調度方法
4、least_conn 最少連接調度算法，當server擁有不同的權重時其為wlc，當所有后端主機連接數相同時，則使用wrr，適用于長連接
5、hash key [consistent] 基于指定的key的hash表來實現對請求的調度，此處key可以直接文本、變量或二者組合
作用：將請求分類，同一類請求將發往同一個upstream
server，使用consistent參數，將使用ketama一致性hash算法，
適用于后端是Cache服務器（如varnish）時使用
hash $request_uri consistent;
hash $remote_addr;
6、keepalive 連接數N;
為每個worker進程保留的空閑的長連接數量,可節約nginx端口，并減少連接管理的消耗
7、health_check [parameters];
健康狀態檢測機制；只能用于location上下文
常用參數：
interval=time檢測的頻率，默認為5秒
fails=number：判定服務器不可用的失敗檢測次數；默認為1次
passes=number：判定服務器可用的失敗檢測次數；默認為1次
uri=uri：做健康狀態檢測測試的目標uri；默認為/
match=NAME：健康狀態檢測的結果評估調用此處指定的match配置塊
注意：僅對nginx plus有效
8、 match name { ... }
對backend server做健康狀態檢測時，定義其結果判斷機制；
只能用于http上下文
? 常用的參數：
status code[ code ...]: 期望的響應狀態碼
header HEADER[operator value]：期望存在響應首
部，也可對期望的響應首部的值基于比較操作符和值進行比較
body：期望響應報文的主體部分應該有的內容
注意：僅對nginx plus有效
25.ngx_stream_core_module模塊
? nginx的其它的二次發行版：
Tengine：由淘寶網發起的Web服務器項目。它在Nginx的基礎上，針對大訪問量網站的需求，添加了很多高級功能和特性。Tengine的性能和穩定性已經在大型的網站如淘寶網，天貓商城等得到了很好的檢驗。它的最終目標是打造一個高效、穩定、安全、易用的Web平臺。從2011年12月開始，Tengine成為一個開源項目，官網 http://tengine.taobao.org/
OpenResty：基于 Nginx 與 Lua 語言的高性能 Web平臺
? ngx_stream_core_module模塊
模擬反代基于tcp或udp的服務連接，即工作于傳輸層的反代或調度器
1、stream { ... }
定義stream相關的服務；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模塊
可實現代理基于TCP，UDP (1.9.13), UNIX-domain
sockets的數據流
1 proxy_pass address;
指定后端服務器地址
2 proxy_timeout timeout;
無數據傳輸時，保持連接狀態的超時時長
默認為10m
3 proxy_connect_timeout time;
設置nginx與被代理的服務器嘗試建立連接的超時時長
默認為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;
}
}
