Nginx配置说明

2 篇文章 0 订阅
1 篇文章 0 订阅

       Nginx即:“engine x”,是一个高性能的HTTP和反向代理服务器,也是一个IMAP/POP3/SMTP服务器。

       正向代理:也就是使用类似“VPN"代理软件访问资源,这里不进行讲解;

       反向代理:到达WEB服务器之后所加的代理,比如访问百度。中间有个负载代理服务器,用于指向实际的服务器。对于反向代理来说,用户无法感知使用了代理,但服务器可以感知使用了代理,我们称之为反向代理服务器。如图所示:

1、功能特性

1)基本HTTP服务

       可以作为http代理服务器和反向代理服务器,支持通过缓存加速访问,可以完成简单的负载均衡和容错,支持包过滤,支持SSL,具体包括:

       1>处理静态文件,如HTML网页以及请求;

       2>打开并自行管理文件描述符缓存;

       3>提供反向代理服务,并且可用缓存加速反向代理;

       4>提供远程FastCGI(通用网关接口)服务的缓存机制;

       5>模块化提供过滤器功能,gzip压缩 ranges支持 chunked响应 XSLT SSI 图像缩放 针对包含多个SSI的页面,经由反向代理SSI过滤器可并行处理;

       6>支持安全套接协议SSL;

2)高级HTTP服务

       可以进行自定义配置,支持虚拟主机,支持URL重定向,支持网络监控,支持流媒体传输等,具体包括:

       1>支持基于名字和IP的虚拟主机设置;

       2>支持HTTP/1.0 中的keep-alive模式和管线模型(PipelLined)连接;

       3>支持重新升级时,无需中断正在处理的请求;

       4>自定义访问日志格式、带缓存的日志写操作以及快速日志轮转;

       5>提供3xx 5xx错误代码重定向功能;

       6>支持重写模块扩展;

       7>支持HTTP DAV模块,从而为HTTP DAV模块提供PUT DELETE MKCOL COPY MOVE方法;

       8>支持FLV流和MP4流传输;

       9>支持网络监控,访问控制、速度限制或请求限制等;

       10>支持嵌入perl语言;

3)邮件代理服务

       邮件代理服务器,支持IMAP/POP3代理服务功能,支持内部SMTP代理服务功能,具体包括:

       1>支持使用外部HTTP认证服务器重定向用户到IMAP/POP3后端,并支持IMAP认证方式和POP3认证方式;

       2>支持使用外部HTTP认证服务器器认证用户后重定向连接到内部SMTP后端,并支持SMTP认证方式;

       3>支持邮件代理服务下的安全套接层安全协议SSL;

       4>支持纯文本通信协议的扩展协议STARTTLS

4)常用功能

       1>HTTP代理和反向代理,优势:请求稳定,后端转发与业务配合分离,配置灵活,支持判断表达式。

       2>负载均衡,优势:

           1》将单一的重负载分担到多个网络节点上做并行处理,每个节点处理结束后将结果汇总给用户提高网络系统的处理能力;

      2》将大量的前端并发访问或者数据流量分担到多个后端网络节点上分别处理;

         nginx的负载均衡策略:

             1》内置策略:轮询、加权轮询、IP hash

      2》扩展策略 主要通过第三方模块实现,常见有url hash

       3>WEB缓存,主要由Proxy_Cache提供代理服务时,对后端服务器返回内容进行URL缓存)和FastCGI_Cache对FastCGI程序缓存)指令集构成。

2、常用命令

1)检查:nginx -t

2)启动:nginx   加参数-c指定nginx.conf

3)停止:nginx -s stop

4)重启:nginx -s reload

3、配置

nginx.conf主要由以下三块组成:

1)全局块

       配置一些影响整体运行的指令,通常有:服务器用户组、允许生成的worker、process、nginx.pid存放路径、日志存放路径、类型和配置文件引入,全局块配置项有:

配置项说明其它可配置的地方
user

配置用户和组,默认为nobody nobody,表示所有用户有启停权限。

daemon设置是否以守护进程模式运行,默认on。该选项仅用于开发测试。
debug_points断点调试。
master_process设置是否启用主进程,默认on。

worker_processes

设置为数字,表示启动后就具有几个worker process,

设置为auto则表示自动检测。

worker_rlimit_nofileworker进程能打开的文件描述符个数
worker_rlimit_sigpending设置每个用户能够发往worker进程的信号数量(信号队列的大小)
worker_cpu_affinity为worker进程绑定若干个CPU,OS为linux才能使用此参数。
worker_priority设置worker进程的优先级
error_log指定nginx的运行日志存放路径,必须包含文件名称。

全局块、http块、server块和location块

pid

指定nginx的pid存放路径,必须包含文件名称。

SSL_engine

指定所使用的ssl硬件加速设备。
timer_resolution设置多长时间获取一次系统时间并更新nginx的缓存时钟。
include引入的其他配置文件路径。任意位置

2)events块

       影响nginx服务器与用户的网络连接,这一块的设置对服务的性能影响较大。通常有:是否开启对WP下的网络进行序列化、是否允许同时接受多个网络连接、事件驱动模型、每个WP可以同时支持处理的最大连接数,events块配置项有:

配置项说明

其他可配置的地方

use设置事件驱动模动模型,建议让nginx自行选择。可以设置为:

select、poll、kqueue、epoll、rtsig /dev/poll、eventport。

debug_connection设置指定的IP产生debug日志。
accept_mutex是否开启负载均衡锁,即:当只有一个请求进来时,是否只唤醒一个进程(控制“惊群效应”),否则轮流接受请求。
lock_file设置负载均衡锁文件路径
multi_accept设置一个进程是否可以同时接受多个请求。
accept_mutex_delay设置获得负载均衡锁的重试时间间隔。
worker_connections允许每一个worker process同时开启的最大连接数,此值不能大于操作系统支持的打开的最大文件句柄数,默认512。

3)http块

        nginx.conf最重要的组成部分,包括:MIME-TYPE定义、日志自定义、是否使用sendfile传输文件、连接超时时间、单连接请求数上限、代理、缓存和第三方模块的配置。http块中包含http全局块和多个server块。http全局块配置项有:

配置项说明其他可配置的地方
allow配置允许访问服务的ipserver块、location块
deny配置不允许访问服务的ipserver块、location块
default_type

默认为text/plain。

server块、location块

log_format [name] [string]

string整体需要用'括起来,变量名称使用双引号括起来。
access_log [path] [format_name [buffer=size]]应答前端请求的服务日志,关闭日志使用off。server块、location块
sendfile是否允许sendfile方式传输文件,默认on。
sendfile_max_chunk每个进程每次调用传输数量不能大于设定的值,默认为0,即不设上限。
client_body_in_file_only指定是否将用户请求体存储到一个文件里。server块、location块

client_body_in_single_buffer

设置是否将完整的请求主体存储在单个缓冲区中。
client_body_buffer_size指定用户请求体所使用的buffer的最大值。server块、location块
client_body_temp_path设置存储用户请求体的文件的目录路径server块、location块
client_body_timeout设置用户请求体的超时时间。server块、location块
client_header_buffer_size设置用户请求头所使用的buffer大小server块

large_client_header_buffers

设置用于读取大型客户端请求头的缓冲区的最大数量和大小
client_header_timeout设置用户请求头的超时时间。server块、location块
client_max_body_size设置所能接收的最大请求体的大小,默认1M。server块、location块
send_timeout指定响应客户端的超时时间,单位:秒,默认60
keepalive_timeout设置用户会话连接的保持时间。server块、location块
tcp_nopush设置TCP链接是否不推送,默认on。
tcp_nodelay设置TCP链接是否延迟,默认on。将tcp_nopush和tcp_nodelay两个指令设置为on用于防止网络阻塞。
autoindex如果没有首页文件是否列出目录中的所有文件,即是否开启目录浏览功能。server块、location块
autoindex_format设置目录浏览功能展示风格,可选:html、xml、json、jsonpserver块、location块
autoindex_exact_size设置文件大小是否以字节数显示,autoindex_format为html时有效。server块、location块
autoindex_localtime是否以服务器的文件时间作为显示的时间,autoindex_format为html时有效。server块、location块
set_real_ip_from设置符合条件的网段,结合real_ip_header,设置新的$remote_addrserver块、location块
real_ip_header结合set_real_ip_from,设置新的$remote_addr,如果设置X-Forwarded-For则为真实的ipserver块、location块
gzip是否开启gzip压缩。
gzip_min_length设置允许压缩的页面最小字节数,默认0。
gzip_buffers设置系统获取几个单位的缓存用于存储gzip的压缩结果数据流。
gzip_http_version识别http的协议版本。
gzip_comp_levelgzip压缩比,1压缩比最小处理速度最快,9压缩比最大但处理速度最慢(传输快但比较消耗cpu)。
gzip_types匹配mime类型进行压缩,无论是否指定,”text/html”类型总是会被压缩的。
gzip_vary和http头有关系,加个vary头,给代理服务器用的,有的浏览器支持压缩,有的不支持,所以避免浪费不支持的也压缩,所以根据客户端的HTTP头来判断,是否需要压缩。
gzip_disable指定版本浏览器不压缩。
upstream

指定负载均衡的后端服务器,例如:server www.xx.com:8080;其后的选项有:

weight:负载均衡策略权重, 默认为1;

max_fails:在一定时间内(这个时间在fail_timeout参数中设置) 检查这个服务器是否可用时产生的最多失败请求数;

fail_timeout:在fail_timeout时间内经历了max_fails次失败后, 暂停服务的时间。 max_fails可以和fail_timeout一起使用, 进行对后端服务器的健康状态检查;

backup:当所有后端服务器都宕机时, 可以指定代理服务器自身作为备份, 对外提供维护提示页面;

down:永久不可用。

proxy_cache_path

定义一个完整的缓存空间,指定缓存数据的磁盘路径、索引存放的内存空间以及一些其他参数。常用选项有:

levels:配置在该目录下再分两层目录,一层1个随机字符作为名称,二层2个随机字符作为名称,levels最多三层,每层最多两个字符,这是为了加快访问文件的速度;最后使用代理url的哈希值作为关键字与文件名;

keys_zone:用来为这个缓存区起名,并设置大小;

max_size:指定最大缓存数据磁盘空间的大小;

inactive:在inactive指定的时间内,未被访问的缓存数据将从缓存中删除。

proxy_cache

用来proxy_cache_path中keys_zone定义的缓存空间, 打开缓存功能,off表示关闭缓存。

proxy_cache_key设置缓存唯一key

proxy_cache_valid

设置不同响应代码的缓存时间,比如200 304 12h;
underscores_in_headersheader中是否支持下划线,默认为off不支持,on为支持;server块

        每个server块中包含server全局块和多个location块,采用就近原则生效。server全局块配置项有:

配置项说明其他可配置的地方
keepalive_requests

单连接请求上限次数。

location块
listen

设置监听地址和端口,可加如下参数:

address:ip地址,如果是ipv6需要使用[fe13:..]格式;

port:端口号,如果只有ip则默认80;

path:socket文件路径;

default_server:标识符,将ip:port设置为默认的虚拟主机; 

backlog:设置监听函数listen()最多允许多少网络连接同时处于挂起的状态,默认511(FreeBSD 为-1) 

rcvbuf:设置监听socket接受缓存区大小;

sendbuf:设置监听socket发送缓存区大小;

deferred:标识符,将accept()设置为Deferred模式;

bind: 标识符,使用独立的bind()处理此adress:port,一般情况下端口相同而IP地址不同,只使用一个 

ssl:标识符,设置会话使用ssl模式(https);

accept_filter:设置监听端口的请求过滤,被过滤的内容不能被接受和处理(只在FreeBSD NetBSD中有用); 

setfib:为监听socket关联路由表,只对FreeBSD起作用;

server_name

设置虚拟主机名称,支持多个。可以使用正则,~作为正则开始的标记,并支持捕获。

匹配的优先级为:

1. 精确匹配,如:www.li.com

2. 通配符在开始 ,如:*.li.com

3. 通配符在结尾 ,如:www.*

4. 正则表达式匹配 ,以波浪线开头(~^*.li.com$)

如果都不匹配

1.优先选择listen配置项后有default或default_server的

2.找到匹配listen端口的第一个server块

server_name_hash_bucket_size为实现快速主机查找,nginx使用hash表保存主机名,该参数用来设置hash表大小。
root设置服务器收到请求后查找资源的根目录路径,最终路径拼接为:root路径+location路径。通常$document_root、$realpath_root只在location块中使用。location块
alias设置服务器收到请求后查找资源的根目录路径,最终路径替换为:alias路径+文件名。alias无法在正则的location中使用。
underscores_in_headersheader中是否支持下划线,默认为off不支持,on为支持;http块

       location匹配有五种:按优先顺序分别为:

            ① = /uri:精确匹配;

            ② ^~  /uri:前缀匹配,不会对uri进行url编码;

            ③ 正则匹配,如果有多个正则,则按定义的先后顺序为优先级,细分为四种正则匹配:

                    ❶ ~:正则匹配区分大小写;

                    ❷ ~* :正则匹配不区分大小写;

                    ❸ !~:与❶相反,不匹配区分大小写的正则;

                    ❹ !~*:与❷相反,不匹配不区分大小写的正则;

            ④ /uri:不带任何修饰符的前缀匹配;

            ⑤ /:通用的默认匹配,所有未匹配location的都会匹配此种匹配;

      如果uri可以同时满足同种匹配方式的多个匹配,那么以uri匹配最长的为准。比如请求http://localhost/dir01/dir02/index.html同时满足前缀匹配:location /dir01、location /dir01/dir02,但最终将匹配到location /dir01/dir02。

location块可以使用if条件,配置项有:

配置项说明其他可配置的地方

add_header [key] [value]

设置response响应报文的header
auth_basic是否开启认证功能,并设置提示信息,off关闭。
auth_basic_user_file

指定包含用户名信息的文件路径。

rewrite

重写跳转地址,支持正则。重写规则后需指定控制标识,控制标识有:

last:重写完成后停止对当前URI在当前location中后续的其它重写操作,而后对新的URI启动新一轮(从第一个开始)重写检查,在循环中则提前重启新一轮循环;

break:重写完成后停止对当前URI在当前location中后续的其它重写操作,而后直接跳转至重写规则配置块之后的其它配置;在循环中则结束循环,建议在location中使用;

redirect:临时重定向,重写完成后以临时重定向方式直接返回重写后生成的新URI给客户端,由客户端重新发起请求;不能以http://或https://开头,使用相对路径,状态码:302;

permanent:重写完成后以永久重定向方式直接返回重写后生成的新URI给客户端,由客户端重新发起请求,状态码:301。

server块
rewrite_log是否把重写过程记录到错误日志中,默认为off,级别默认notice。
try_files后面可以跟多个文件名,表示逐个匹配文件,如果没有则继续往后一个文件匹配
return [code] [url]用于结束rewrite规则,并且为客户端返回状态码204,400,402-400,500-504等。格式可以为return code、return url或者return code url
index设置网站的默认首页。
error_page [code] [path]设置网站的错误页面。http块、server块

proxy_pass

指定反向代理的服务器池,如:192.168.10.10 或使用upstream,服务器池是tomcat动态程序

proxy_redirecturl中末尾是没有后缀:/ 的目录时,nginx内置了301重定向,重定向追加/,此参数可以修改反向代理重定向的url

proxy_set_header

设置发往后端请求头,参数有:

Host:指定反向代理到哪个主机名;

X-REMOTE-IP:上一跳的ip;

X-Forwarded-For:设置客户端ip;

http_user_agent:设置客户端OS;

默认情况下,只有两个请求头会被重新定义:

proxy_set_header Host $proxy_host;

proxy_set_header Connection close;

proxy_body_buffer_size

设置客户端请求主体缓冲区大小,可以理解为先保存到本地在传给用户。

proxy_connect_timeout

设置后端服务器连接的超时时间,即发起握手等候响应的超时时间。

proxy_send_timeout

设置后端服务器的数据回传时间,即在规定的时间内后端服务器必须传完所有的数据,否则nginx将断开这个连接。

proxy_read_timeout

设置从后端服务器获取信息的时间,表示连接建立成功之后,nginx等待后端服务器的响应时间,其实nginx已经进入后端的排队之中等候处理。

proxy_buffer_size

设置缓冲区大小。

proxy_buffers

设置缓冲区的数量和大小。

proxy_busy_buffers_size

设置系统忙碌时可以使用的proxy_buffers大小,官方推荐为proxy_buffers*2

proxy_tmep_file_write_size

指定proxy缓存临时文件的大小

proxy_next_upstream

请求出错后,转向下一个节点

fastcgi_pass

指定fastcgi进程监听的IP地址和端口,例如127.0.0.1:9000或者unix:/tmp/fastcgi.socket。也可以使用upstream指定,例如:

upstream backend  {

     server  127.0.0.1:9000;

}

fastcgi_pass   backend;

服务是php程序

http块、server块

fastcgi_pass_header

设置请求fastcgi的请求头。http块、server块
fastcgi_read_timeoutfastcgi服务器的响应超时时间。http块、server块
fastcgi_send_timeout

为上游服务器设置等待一个FastCGI进程的传送数据时间。

http块、server块
fastcgi_split_path_info0.7.31以上版本使用,是否允许设置SCRIPT_FILENAME (SCRIPT_NAME)和PATH_INFO变量,分别对应:$fastcgi_script_name和$fastcgi_path_info。http块、server块
fastcgi_store设置存储前端文件的路径,on指定将使用root和alias指令相同的路径,off禁止存储,此外还可以指定具体的路径。http块、server块
fastcgi_store_access指定创建文件或目录的权限,比如:

user:rw  group:rw  all:r

http块、server块
fastcgi_temp_path指定存储从别的服务器传送来的数据临时文件路径http块、server块
fastcgi_index如果请求fastcgi的URI以/结束,该指令设置的文件会被附加到URI的后面并保存在变量$fastcgi_script_name中http块、server块
fastcgi_param指定参数传递给fastcgihttp块、server块
fastcgi_redirect_errors已重命名为:fastcgi_intercept_errors。指定是否传递4xx和5xx错误信息到客户端,或者是否允许nginx使用error_page处理错误信息。http块、server块
uwsgi_pass与proxy_pass、fastcgi_pass类似,指向的是python程序http块、server块
expires指定浏览器缓存失效时长,比如:30s http块、server块
if_modified_since指定是否启用if_modified_since请求头http块、server块

4、内置变量

变量名说明
$uri当前请求的URI,不带参数
$document_uri当前请求的URI,不带参数
$request_uri请求的uri,带完整参数
$is_args表示请求中的 URI 是否带参数,如果带参数,$is_args 值为 ?,如果不带参数,则是空字符串
$argshttp请求的完整参数
$arg_[param]http请求中某个参数的值
$query_stringhttp请求的完整参数,只读不可改变
$hosthttp请求报文中的host首部,如果请求中没有host首部,则以处理此请求的虚拟主机的主机名代替
$hostnamenginx服务运行在的主机的主机名。
$proxy_hostnginx对于upstream默认使用的是基于IP的转发,所以表示请求到对应的upstream配置的域名的ip
$remote_addr客户端的ip地址,如果客户端有代理,则为最近的代理服务器的ip
$http_x_real_ip客户端的ip地址,如果客户端有代理,则为已设置的最新的代理服务器的ip
$http_x_forwarded_for客户端的ip地址,默认是空。使用proxy_set_header设置后,多个ip按顺序用逗号隔开,但不包含最近的代理服务器的ip。第1个ip是离服务器最远的ip,即第1个发起请求的ip
$proxy_add_x_forwarded_for$http_x_forwarded_for和$remote_addr,中间用逗号隔开
$binary_remote_addr二进制格式的客户端地址
$remote_port客户端端口
$remote_user启用用户认证时,客户端输入的用户名
$request_method请求方法
$request_filename用户请求中的uri经过本地root或alias转换后映射的本地文件路径
$request_body表示http请求中的body体,该参数只在proxy_pass或fastcgi_pass中有意义
$request_body_file

表示http请求中的body体存储的临时文件名

$request_completion当请求已经全部完成时,其值为 “ok” 。若没有完成,就要返回客户端,则其值为空字符串;或者在断点续传等情况下使用http range访问的并不是文件的最后一块,那么其值也是空字符串。
$server_addr服务器地址
$server_name服务器域名
$server_port服务器端口
$server_protocol服务器向客户端发送响应时的协议,如http/1.1
$scheme在请求中使用scheme,如https://www.magedu.com/中的https
$http_[header]匹配请求报文中指定的HEADER,例如:$http_host匹配请求报文中的host首部
$sent_http_[header]匹配响应报文中指定的HEADER,例如:$sent_http_content_type匹配响应报文中content-type首部
$document_root当前请求映射到的root配置项
$time_local访问时间与时区
$request请求的url与http协议
$status请求状态,成功是200
$body_bytes_sent发送给客户端文件主体内容大小
$http_referer记录从那个页面链接访问过来的
$http_user_agent记录客户端浏览器的相关信息
$content_length请求头部中的Content-Length字段
$content_type请求头部中的Content-Type字段
$cookie_COOKIE请求头部中的cookie字段
$limit_rate表示当前连接的限速是多少,0表示无限速
$nginx_version表示当前Nginx的版本号
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值