... # 全局块
events { # events块
...
}
http { # http块
... # http全局块
server { # server块
... # server全局块
location [PATTERN] { # location块
...
}
location [PATTERN] {
...
}
}
server {
...
}
... # http全局块
}
注意:Nginx 配置的注释是以 #
开头,并且每条语句都要以 ;
结束,除了语句块 {}
。
所有在 nginx.conf 内但不在任何 { } 中的指令都属于全局块的指令:
# 用户组
user myUsr myGroup;
# 工作进程数
worker_processes 1;
# 进程文件路径
pid /user/local/nginx/nginx.pid;
# 日志路径和日志级别
error_log logs/error.log debug;
指令详解:
debug|info|notice|warn|error|crit|alert|emerg
注意:Nginx 配置中,以 /
开头的路径表示绝对路径,不以 /
开头的路径表示相对路径,相对路径的根目录为 Nginx 的根目录。
所有写在 events{}
中的指令都属于 Events 块指令:
events {
# 设置网路连接序列化
accept_mutex on;
# 一个进程是否同时接受多个网络连接
multi_accept on;
# 事件驱动模型
use epoll;
# 最大连接数
worker_connections 1024;
}
指令详解:
select|poll|kqueue|epoll|resig|/dev/poll|eventport
。所有写在 http{}
块中,但不写在 http{ } 内的子模块中的所有指定就是 HTTP 全局块,会影响 http{ } 及其子模块的内容:
http {
# 文件扩展名与文件类型映射表
include mime.types;
# 默认文件类型
default_type application/octet-stream;
# 是否开启服务日志
access_log off;
# 自定义服务日志格式
log_format myLogFormat '$remote_addr–$remote_user [$time_local] $request $status $body_bytes_sent $http_referer $http_user_agent $http_x_forwarded_for';
# 设置日志的格式
access_log log/access.log myLogFormat;
# 是否开启高效文件传输模式
sendfile on;
# 每个进程每次最大传输值
sendfile_max_chunk 100k;
# 长连接超时时间
keeplive_timeout 100;
# 响应客户端的超时时间
send_timeout 75;
# 客户端请求头的区缓冲区大小
client_header_buffer_size 32k;
# 客户端请求头的最大缓冲区数量和大小
large_client_header_buffers 8 32k;
# 允许客户端请求的最大字节数
client_max_body_size 10m;
# 客户端请求体的缓冲区大小
client_body_buffer_size 128k;
}
指令详解:
nginx/conf
下;text/plain
;access_log
路径;sendfile
指令指定 nginx 是否调用 sendfile 函数来输出文件,减少用户空间到内核空间的上下文切换;对于普通应用设为 on,如果用来进行下载等应用磁盘 IO 重负载应用,可设置为 off,以平衡磁盘与网络 I/O 处理速度,降低系统的负载;sendfile_max_chunk
指令的默认为 0,表示不设上限;keeplive_timeout
指令的单位是秒,这个参数很敏感,涉及浏览器的种类、后端服务器的超时设置、操作系统的设置;长连接在请求大量小文件的时候,可以减少重建连接的开销;但如果上传大文件时在设置的超时时间内没上传完成会导致失败,如果设置时间过长,用户又多,长时间保持连接会占用大量资源;send_timeout
指令仅限于两个连接活动之间的时间,如果超过这个时间,客户端没有任何活动,Nginx将会关闭连接;client_header_buffer_size
指令时,为避免请求 header 过大出现 400 错误,可以适当设置大一点;large_client_header_buffers
指令时,为避免请求 header 过大出现 400 错误,可以适当设置大一点。除了这些常用的 http 配置外,还用一些特定的 http 配置,比如反向代理配置:
http {
...
# 配置 https_proxy 反向代理
proxy_connect_timeout 75;
proxy_read_timeout 75;
proxy_send_timeout 100;
proxy_buffer_size 4k;
proxy_buffers 4 32k;
proxy_busy_buffers_size 64k;
proxy_max_temp_file_size 64k;
proxy_temp_file_write_size 64k;
proxy_temp_path proxy_temp;
...
}
http_proxy 模块指令详解:
proxy_connect_timeout
:表示 Nginx 跟代理服务器连接超时时间;proxy_read_timeout
:表示 Nginx 与代理服务器两个成功的响应操作之间超时时间;proxy_send_timeout
:表示 Nginx 传输文件至代理服务器的超时时间;proxy_buffer_size
:用于设置从代理服务器读取并保存用户头信息的缓冲区大小;proxy_buffers
:设置代理缓冲区大小,Nginx 针对单个连接,缓存来自代理服务器的响应,网页平均在32k以下的话,可以设置为 4 32K ;proxy_busy_buffers_size
:设置高负荷下的缓冲大小,一般为 proxy_buffers 的两倍;proxy_max_temp_file_size
:的用途介绍:当 proxy_buffers 放不下后端服务器的响应内容时,会将一部分保存到硬盘的临时文件中,这个值用来设置最大临时文件大小,默认1024M,它与 proxy_cache 没有关系;大于这个值,将从 upstream 服务器传回,设置为 0 禁用;proxy_temp_file_write_size
:当缓存被代理的服务器响应到临时文件时,这个选项限制每次写临时文件的大小;proxy_temp_path
:用于指定临时文件所在的目录。以及 http_gzip 模块配置:
http {
...
# 配置 http_gzip 模块
gzip on;
gzip_min_length 1K;
gzip_buffers 4 16k;
gzip_http_version 1.0;
gzip_comp_level 6;
gzip_types text/plain text/css application/json;
gzip_proxied any;
gzip_vray on;
...
}
http_gzip 配置详解:
gzip
:如果设置为 on 则表示开启 gzip 压缩输出,可减少网络传输;gzip_min_length
:设置允许压缩的页面最小字节数(到达这个大小才进行压缩),页面字节数从 header 头的 content-length 中进行获取。默认值是 20。建议设置成大于 1k 的字节数,小于 1k 可能会越压越大;gzip_buffers
:设置系统获取多少个单位的缓存用于存储 gzip 的压缩结果数据流,4 16k 表示按照原始数据大小以 16k 为单位的 4 倍进行内存申请;gzip_http_version
:设置 http 协议的版本,早期的浏览器不支持 Gzip 压缩,用户就会看到乱码,所以为了支持前期版本加上了这个选项;如果你用了 Nginx 的反向代理并启用 Gzip 压缩的话就需要加上,而由于末端通信是 http/1.0,故请设置为 1.0;gzip_comp_level
:zip 压缩比,为 1 时,压缩比最小处理速度最快;为 9 时,压缩比最大但处理速度最慢;gzip_types
:匹配 mime 类型进行压缩,无论是否指定,text/html
类型总是会被压缩的;gzip_proxied
:置开启或者关闭后端服务器返回的结果是否压缩,Nginx 作为反向代理的时候启用,匹配的前提是后端服务器必须要返回包含 Via
的 header头;gzip_vray
: 该配置和 http 头有关系,会在响应头加个 Vary: Accept-Encoding
,可以让前端的缓存服务器缓存经过 gzip 压缩的页面,例如:用 Squid 缓存经过 Nginx 压缩的数据。负载均衡后台服务器列表:
upstream backend {
server 192.168.56.10:8080 max_fails=2 fail_timeout=30s backup; # 热备
server 192.168.56.11:8080 max_fails=2 fail_timeout=30s;
}
所有位于 server{}
模块中的指令都属于 Server 块指令:
server {
# 监听端口
listen 8080;
# 监听服务器地址
server_name 192.168.56.10;
# 每个连接请求上限次数
keepalive_requests 120;
# 字符集
charset utf-8;
# 服务日志所在目录以及日志格式
access_log logs/host80.log myLogFormat;
# 错误页
error_page 404 /404.html;
error_page 500 502 503 504 /50x.html;
}
指令详解:
server_name + error_page
。除了以上常用的 Server 块指令外还有其他特殊的指令,比如 ssl
模块,在请求方式中,如果使用 https 进行请求的话是需要证书,这时就要对 https 请求设置 ssl:
server {
# 开启 ssl
ssl on;
# ssl 证书路径
ssl_certificate /opt/ssl/nginx.crt;
# ssl 证书秘钥
ssl_certificate_key /opt/ssl/nginx.key;
# ssl 会话超时时间
ssl_session_timeout 1d;
# ssl 缓存
ssl_session_cache shared:SSL:50m;
# ssl 会话票据
ssl_session_tickets off;
# ssl 协议版本
ssl_protocols TLSv1.2;
# ssl 密码套件
ssl_ciphers 'HIGH:!aNULL:!MD5';
# 开启 ssl 服务密码套件
ssl_prefer_server_ciphers on;
}
常用 location 指令:
location ~* ^.+$ {
# 服务器的默认网站根目录位置
root /var/www/html;
# 默认访问的文件名
index index.html index.htm index.jsp;
# 拒绝的 IP
deny 192.168.56.21;
deny all;
# 允许的 IP
allow 192.168.56.10;
allow all;
}
指令详解:
~
表示区分大小写,~*
表示不区分大小写);root
:定义服务器的默认网站根目录位置,如果 LocationURL 匹配的是子目录或文件,root 指令没什么作用,一般放在 server 指令里面或 LocationURL 为 /
的 location 块下;index
:定义该 location 路径下默认访问的文件名,一般跟 root 的路径放在一起。设置响应头(可用于访问控制和处理跨域问题):
location {
# 设置允许跨域类型
add_header Access-Control-Allow-Origin * always;
# 是否允许信任证书
add_header Access-Control-Allow-Credentials 'true' always;
# 允许的请求头类型
add_header Access-Control-Allow-Headers * always;
# 设置允许的请求方式
add_header Access-Control-Allow-Methods 'PUT, GET, POST, DELETE, OPTIONS' always;
# 处理 OPTIONS 请求
if ($request_method = 'OPTIONS') {
return 204;
}
}
指令详解:
always
;设置反向代理服务器:
location {
# 反向代理服务器地址
proxy_pass http://192.168.56.33;
# 是否重定向代理服务器地址
proxy_redirect off;
}
设置向代理服务器发送请求时的请求头数据:
location {
# cookie
proxy_pass_header Set-Cookie;
# 主机名
proxy_set_header Host $host;
# 真实 IP
proxy_set_header X-Real-Ip $remote_addr;
# 表示 HTTP 请求端真实 IP
proxy_set_header X-Forwarded-For $remote_addr;
}
PS:更多关于 Nginx 配置文档可以参考 Nginx 官方文档:http://nginx.org/en/docs/
# 工作进程数
worker_processes 1;
# 日志文件路径
error_log logs/error.log;
# 进程运行文件路径
pid logs/nginx.pid;
events {
# 使用 epoll 事件驱动
use epoll;
# 最大连接数
worker_connections 1024;
}
http {
# 文件类型设置
include mime.types;
default_type application/octet-stream;
# 日志格式
log_format mainFromat '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"';
# 服务日志
access_log logs/access.log mainFromat;
# 开启高效文件传输模式
sendfile on;
# 配置 tcp 发送模式
tcp_nopush on;
tcp_nodelay on;
# 长连接超时时间
keepalive_timeout 65;
# 请求头
client_header_buffer_size 32k;
large_client_header_buffers 4 32k;
# 请求体
client_body_buffer_size 128k;
client_max_body_size 10m;
# 设置 gzip
gzip on;
gzip_disable "msie6";
gzip_vary on;
gzip_proxied any;
gzip_comp_level 6;
gzip_buffers 16 8k;
gzip_http_version 1.1;
gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
# 代理服务器相关设置
proxy_connect_timeout 75;
proxy_read_timeout 75;
proxy_send_timeout 100;
# 监听http服务
server {
# 服务器端口地址
listen 80;
server_name 192.168.56.10;
# 字符集
charset utf-8;
# 服务日志路径
access_log logs/host.access.log mainFromat;
# 地址定位模块
location / {
root html;
index index.html index.htm index.jsp;
}
location /demo {
# 添加反向代理服务器
proxy_pass http://192.168.56.10:8080;
proxy_redirect off;
proxy_pass_header Set-Cookie;
proxy_set_header Host $host;
proxy_set_header X-Real-Ip $remote_addr;
proxy_set_header X-Forwarded-For $remote_addr;
# 添加请求头
add_header Access-Control-Allow-Origin * always;
add_header Access-Control-Allow-Credentials 'true' always;
add_header Access-Control-Allow-Methods 'PUT, GET, POST, DELETE, OPTIONS' always;
add_header Access-Control-Allow-Headers * always;
# 处理 OPTION 请求
if ($request_method = 'OPTIONS') {
return 204;
}
}
# 重定向错误页到静态页
error_page 404 /404.html;
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root html;
}
}
# 监听https服务
server {
listen 443 ssl;
server_name 192.168.56.10;
# ssl 设置
ssl_certificate /opt/ssl/nginx.crt;
ssl_certificate_key /opt/ssl/nginx.key;
ssl_session_timeout 1d;
ssl_session_cache shared:SSL:50m;
ssl_session_tickets off;
ssl_protocols TLSv1.2;
ssl_ciphers HIGH:!aNULL:!MD5;
ssl_prefer_server_ciphers on;
ssl_stapling on;
ssl_stapling_verify on;
location / {
root html;
index index.html index.htm;
}
}
# 监听其他端口服务
server {
listen 8081;
server_name localhost;
location / {
root html;
index index.html index.htm;
}
}
}