共计 15729 个字符,预计需要花费 40 分钟才能阅读完成。
nginx 模块在编译文件下的 odjs 目录下
cat 查看 ngx_modules.c 文件
可以看到一些基本 extern 模块
常用标准模块
1. 性能相关配置
worker 进程的数量;通常应该为当前主机的 cpu 的物理核心数
worker_cpu_affinity auto [cpumask] #将 work 进程绑定在固定 cpu 上提高缓存命中率
例:
worker_cpu_affinity 0001 0010 0100 1000;
worker_cpu_affinity 0101 1010;
worker_priority number
指定 worker 进程的 nice 值,设定 worker 进程优先级:[-20,20]
worker_rlimit_nofile number
worker 进程所能够打开的文件数量上限, 默认较小,生产中需要调大如 65535
2. 时间驱动 events 相关的配置
worker_connections number
每个 worker 进程所能够打开的最大并发连接数数量,如 10240
总最大并发数:worker_processes * worker_connections
use method
指明并发连接请求的处理方法, 默认自动选择最优方法不用调整
如:use epoll;
accept_mutex on | off 互斥;
处理新的连接请求的方法;on 指由各个 worker 轮流处理新请求
,Off 指每个新请求的到达都会通知(唤醒) 所有的 worker 进程,但
只有一个进程可获得连接,造成“惊群”,影响性能,默认 on
3. http 核心模块相关配置 ngx_http_core_module
3.1web 服务模板
server {…}
配置一个虚拟主机
server {
listen address[:PORT]|PORT;
server_name SERVER_NAME;
root /PATH/TO/DOCUMENT_ROOT;
}
注意:
(1) 基于 port;
listen PORT; 指令监听在不同的端口
(2) 基于 ip 的虚拟主机
listen IP:PORT; IP 地址不同
(3) 基于 hostname
server_name fqdn; 指令指向不同的主机名
3.2 套接字相关配置
listen address[:port] [default_server] [ssl] [http2 | spdy] [backlog=number] [rcvbuf=size] [sndbuf=size]
default_server 设定为默认虚拟主机
ssl 限制仅能够通过 ssl 连接提供服务
backlog=number 超过并发连接数后,新请求进入后援队列的长度
rcvbuf=size 接收缓冲区大小
sndbuf=size 发送缓冲区大小
3.3 server_name
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
3.4 延迟发送选项
tcp_nodelay on | off;
tcp_nopush on | off;
在 keepalived 模式下的连接是否启用 TCP_NODELAY 选项
当为 off 时,延迟发送,合并多个请求后再发送
默认 On 时,不延迟发送
可用于:http, server, location
3.5 sendfile
sendfile on | off;
是否启用 sendfile 功能,在内核中封装报文直接发送
默认 Off
3.6 隐藏版本信息
server_tokens on | off | build | string
是否在响应报文的 Server 首部显示 nginx 版本
3.7 location 匹配
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
=:对 URI 做精确匹配;
^~:对 URI 的最左边部分做匹配检查,不区分字符大小写
~:对 URI 做正则表达式模式匹配,区分字符大小写
~*:对 URI 做正则表达式模式匹配,不区分字符大小写
不带符号:匹配起始于此 uri 的所有的 uri
匹配优先级从高到低:
=, ^~, ~/~*, 不带符号
3.7 路径别名 alias path
示例:
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,相当于追加在 root 目录后面
(b) alias,相当于对 location 中的 url 进行替换
3.8 错误页面显示
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 <span class=”token comment”># 防止 404 页面被劫持
3.9 长连接相关配置
keepalive_timeout timeout [header_timeout];
设定保持连接超时时长,0 表示禁止长连接,默认为 75s
keepalive_requests number;
在一次长连接上所允许请求的资源的最大数量,默认为 100
keepalive_disable none | browser …
对哪种浏览器禁用长连接
send_timeout time;
向客户端发送响应报文的超时时长,此处是指两次写操作之间的间隔时长,而非
整个响应过程的传输时长
3.10 请求报文缓存
client_body_buffer_size size;
用于接收每个客户端请求报文的 body 部分的缓冲区大小;默认为 16k;超出此大小时,
其将被暂存到磁盘上的由 client_body_temp_path 指令所定义的位置
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
3.11 对客户端进行限制相关配置
limit_rate rate;
限制响应给客户端的传输速率,单位是 bytes/second 默认值 0 表示无限制
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 网段主机使用
4. 访问控制模块 ngx_http_access_module
实现基于 ip 的访问控制功能
allow address | CIDR | unix: | all;
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;
}
5. 用户认证模块 ngx_http_auth_basic_module
实现基于用户的访问控制,使用 basic 机制进行用户认证
auth_basic string | off;
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 所提供
htpasswd [- c 第一次创建时使用] [- D 删除用户] passwdfile username
6. 状态查看模块 ngx_http_stub_status_module
用于输出 nginx 的基本状态信息
Active connections: 当前状态,活动状态的连接数
accepts:统计总值,已经接受的客户端请求的总数
handled:统计总值,已经处理完成的客户端请求的总数
requests:统计总值,客户端发来的总的请求数
Reading:当前状态,正在读取客户端请求报文首部的连接的连接数
Writing:当前状态,正在向客户端发送响应报文过程中的连接数
Waiting:当前状态,正在等待客户端发出请求的空闲连接数
示例:
location /status {
stub_status;
allow 172.16.0.0/16;
deny all;
}
7. 日志记录模块 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;
json 格式日志示例;log_format json ‘{“@timestamp”:”$time_iso8601″,’
‘”client_ip”:”$remote_addr”,’
‘”size”:$body_bytes_sent,’
‘”responsetime”:$request_time,’
‘”upstreamtime”:”$upstream_response_time”,’
‘”upstreamhost”:”$upstream_addr”,’
‘”http_host”:”$host”,’
‘”method”:”$request_method”,’
‘”request_uri”:”$request_uri”,’
‘”xff”:”$http_x_forwarded_for”,’
‘”referrer”:”$http_referer”,’
‘”agent”:”$http_user_agent”,’
‘”status”:”$status”}’;
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:验正缓存中各缓存项是否为活动项的时间间隔
例: open_log_file_cache max=1000 inactive=20s valid=1m;
8. 压缩相关选项 ngx_http_gzip_module
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-|
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_http_version 1.1;
gzip_vary on;
gzip_min_length 1024;
gzip_buffers 16 8k;
gzip_proxied any;
gzip_disable “MSIE[1-6]\.(?!.*SV1)”;
gzip_types text/xml text/plain text/css application/javascript application/xml application/json;
9. https 模块 ngx_http_ssl_module 模块:
为指定虚拟机启用 HTTPS protocol,建议用 listen 指令代替
当前虚拟主机使用 PEM 格式的证书文件
当前虚拟主机上与其证书匹配的私钥文件
支持 ssl 协议版本,默认为后三个
[shared:name:size];
builtin[:size]:使用 OpenSSL 内建缓存,为每 worker 进程私有
[shared:name:size]:在各 worker 之间使用一个共享的缓存
客户端连接可以复用 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;
}
10. 重定向模块 ngx_http_rewrite_module:
1、rewrite regex replacement [flag]
将用户请求的 URI 基于 regex 所描述的模式进行检查,匹配到时将其替换为 replacement 指定的新的 URI
注意:如果在同一级配置块中存在多个 rewrite 规则,那么会自下而下逐个检查;被某条件规则替换
完成后,会重新一轮的替换检查
隐含有循环机制, 但不超过 10 次;如果超过,提示 500 响应码,[flag]所表示的标志位用于控制此循环
机制
如果 replacement 是以 http:// 或 https:// 开头,则替换结果会直接以重向返回给客户端
[flag]:
last:重写完成后停止对当前 URI 在当前 location 中后续
的其它重写操作,而后对新的 URI 启动新一轮重写检查;提前重
启新一轮循环
break:重写完成后停止对当前 URI 在当前 location 中后
续的其它重写操作,而后直接跳转至重写规则配置块之后的其它
配置;结束循环,建议在 location 中使用
redirect:临时重定向,重写完成后以临时重定向方式直
接返回重写后生成的新 URI 给客户端,由客户端重新发起请求;
不能以 http:// 或 https:// 开头,使用相对路径,状态码:302
permanent: 重写完成后以永久重定向方式直接返回重写
后生成的新 URI 给客户端,由客户端重新发起请求,状态码:301
例:
rewrite ^/zz/(.*\.html)$ /zhengzhou/$1 break;
rewrite ^/zz/(.*\.html)$ https://www.dianping/zhengzhou/$1 permanent;
return code [text];
return code URL;
return URL;
停止处理,并返回给客户端指定的响应码
3、rewrite_log on | off;
是否开启重写日志, 发送至 error_log(notice level)
用户自定义变量
注意:变量定义和调用都要以 $ 开头
引入新的上下文, 条件满足时,执行配置块中的配置指令;server, location
condition:
比较操作符:
== 相同
!= 不同
~:模式匹配,区分字符大小写
~*:模式匹配,不区分字符大小写
!~:模式不匹配,区分字符大小写
!~*:模式不匹配,不区分字符大小写
文件及目录存在性判断:
-e, !-e 存在(包括文件,目录,软链接)
-f, !-f 文件
-d, !-d 目录
-x, !-x 执行
浏览器分流示例:
if ($http_user_agent ~ Chrom) {
rewrite ^(.*)$ /chrome/$1 break;
}
if ($http_user_agent ~ MSIE) {
rewrite ^(.*)$ /IE/$1 break;
}
11. 引用模块 ngx_http_referer_module
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;
}
12. 反向代理模块 ngx_http_proxy_module
12.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/
注意:如果 location 定义其 uri 时使用了正则表达式的模式,则 proxy_pass 之后必须不能使用 uri;
用户请求时传递的 uri 将直接附加代理到的服务的之后
server {
…
server_name HOSTNAME;
location ~|~* /uri/ {
proxy_pass http://host; 不能加 /
}
…
}
http://HOSTNAME/uri/ –> http://host/uri/
12.2 proxy_set_header field value;
设定发往后端主机的请求报文的请求首部的值
Context: http, server, location
后端记录日志记录真实请求服务器 IP
proxy_set_header Host $host;
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
如后端是 Apache 服务器应更改日志格式:
%h —–> %{X-Real-IP}i
12.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];
例:proxy_cache_path /data/nginx/cache(属主要为 nginx)levels=1:2 keys_zone=nginxcache:20m inactive=2m
12.4 调用缓存
proxy_cache zone | off; 默认 off
指明调用的缓存,或关闭缓存机制;Context: http,server, location
12.5
proxy_cache_key string;
缓存中用于“键”的内容
默认值:proxy_cache_key $scheme$proxy_host$request_uri;
12.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;
12.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 …
在被代理的后端服务器出现哪种情况下,可以直接使用过
期的缓存响应客户端
12.8
proxy_cache_methods GET | HEAD | POST …;
对哪些客户端请求方法对应的响应进行缓存,GET 和 HEAD 方法总是被缓存
12.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. 用于隐藏后端服
务器特定的响应首部
12.10
proxy_connect_timeout time;
定义与后端服务器建立连接的超时时长,如超时会出现 502 错误,默认为 60s,一般不建议超出 75s
12.11
proxy_send_timeout time;
把请求发送给后端服务器的超时时长;默认为 60s
12.12
proxy_read_timeout time;
等待后端服务器发送响应报文的超时时长,默认为 60s
13. 首部信息
add_header name value [always];
添加自定义首部
add_header X-Via $server_addr;
add_header X-Cache $upstream_cache_status;
add_header X-Accel $server_name;
add_trailer name value [always];
添加自定义响应信息的尾部
14. hph 相关模块 ngx_http_fastcgi_module
14.1
fastcgi_pass address;
address 为后端的 fastcgi server 的地址
可用位置:location, if in location
14.2
fastcgi_index name;
fastcgi 默认的主页资源
示例:fastcgi_index index.php;
14.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.conf;
…
}
示例 2:
通过 /pm_status 和 /ping 来获取 fpm server 状态信息(真实服务器端 php-fpm 配置文件中将这两项
注释掉)
location ~* ^/(status|ping)$ {
include fastcgi_params;
fastcgi_pass 后端 fpm 服务器 IP:9000;
fastcgi_param SCRIPT_FILENAME $fastcgi_script_name;
include fastcgi.conf;
}
14.4 fastcgi 缓存相关
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
非活动时长
14.5
fastcgi_cache zone | off;
调用指定的缓存空间来缓存数据
可用位置:http, server, location
14.6
fastcgi_cache_key string;
定义用作缓存项的 key 的字符串
示例:fastcgi_cache_key $request_rui;
14.7
fastcgi_cache_methods GET | HEAD | POST …;
为哪些请求方法使用缓存
14.8
fastcgi_cache_min_uses number;
缓存空间中的缓存项在 inactive 定义的非活动时间内至少要被访问到
此处所指定的次数方可被认作活动项
14.9
fastcgi_keep_conn on | off;
收到后端服务器响应后,fastcgi 服务器是否关闭连接,建议启用长连接
14.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;
…
}
}
15. 代理模块 ngx_http_upstream_module 模块
用于将多个服务器定义成服务器组,而由 proxy_pass,fastcgi_pass 等指令进行引用
15.1upstream name {…}
定义后端服务器组,会引入一个新的上下文
默认调度算法是 wrr
Context: http
upstream httpdsrvs {
server …
server…
…
}
15.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 使用,实现灰度发布
15.3
ip_hash 源地址 hash 调度方法
15.4
least_conn 最少连接调度算法,当 server 拥有不同的权重时其为 wlc,当所有后端主机连接数相同时,
则使用 wrr,适用于长连接
15.5
hash key [consistent] 基于指定的 key 的 hash 表来实
现对请求的调度,此处的 key 可以直接文本、变量或二者组合
作用:将请求分类,同一类请求将发往同一个 upstream
server,使用 consistent 参数,将使用 ketama 一致性 hash 算法,
适用于后端是 Cache 服务器(如 varnish)时使用
hash $request_uri consistent;
hash $remote_addr;
15.6
keepalive 连接数 N;
为每个 worker 进程保留的空闲的长连接数量, 可节约 nginx
端口,并减少连接管理的消耗
15.7
health_check [parameters];
健康状态检测机制;只能用于 location 上下文
常用参数:
interval=time 检测的频率,默认为 5 秒
fails=number:判定服务器不可用的失败检测次数;默认为 1 次
passes=number:判定服务器可用的失败检测次数;默认为 1 次
uri=uri:做健康状态检测测试的目标 uri;默认为 /
match=NAME:健康状态检测的结果评估调用此处指定的 match 配置块
注意:仅对 nginx plus 有效
15.8
match name {…}
对 backend server 做健康状态检测时,定义其结果判断机制;
只能用于 http 上下文
常用的参数:
status code[code …]: 期望的响应状态码
header HEADER[operator value]:期望存在响应首
部,也可对期望的响应首部的值基于比较操作符和值进行比较
body:期望响应报文的主体部分应该有的内容
注意:仅对 nginx plus 有效
16. ngx_stream_core_module 模块
模拟反代基于 tcp 或 udp 的服务连接,即工作于传输层的反代或调度器
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;
}
}
listen address:port [ssl] [udp] [proxy_protocol]
[backlog=number] [bind] [ipv6only=on|off] [reuseport]
[so_keepalive=on|off|[keepidle]:[keepintvl]:[keepcnt]];
17. ngx_stream_proxy_module 模块
sockets 的数据流
指定后端服务器地址
无数据传输时,保持连接状态的超时时长
默认为 10m
设置 nginx 与被代理的服务器尝试建立连接的超时时长
默认为 60s
示例:
stream {
upstream telnetsrvs {
server 192.168.10.130:23;
server 192.168.10.131:23;
hash $remote_addr consistent;
根据客户端地址进行 hash 值调度,只要客户端来自一个地址就一直调度过去,tcp,udp 协议也可以往一个上面调度
}
server {
listen 172.16.100.10:2323;
proxy_pass telnetsrvs;
proxy_timeout 60s;
proxy_connect_timeout 10s;
}
}
集合:
: