一、nginx的配置文件:nginx.conf
1、nginx配置文件的结构:
main(全局配置段)
events {...}
http {
...
server {
location ... {...}
location ... {...}
...
}
server {
...
}
}
2、配置参数需要以分号结尾,语法格式:
参数名 值1 [值2 ...];
3、配置文件中还可使用变量:
模块内置变量
用户自定义变量:set var_name value
4、配置文件检查:nginx -t
5、nginx配置文件vim语法高亮
vim对编译安装的nginx配置文件默认没有设置语法高亮,可执行以下步骤解决:
#mkdir -pv ~/.vim/syntax
#cd ~/.vim/syntax
#wget http://www.vim.org/scripts/download_script.php?src_id=14376 -O nginx.vim
#echo "au BufRead,BufNewFile /usr/local/nginx/* set ft=nginx" >> ~/.vim/filetype.vim
二、nginx的基本核心配置(main段、events{}段)
1、正常运行的必备配置:
①user username [groupname]; #指定运行worker进程的用户和组
②pid /path/to/pidfile_name; #指定nginx的pid文件
③worker_rlimit_nofile #;
worker进程所能够打开的最大文件句柄数。该值不能小于worker_connections×worker_processes,如果nginx工作为反向代理服务器,则该值不能小于worker_connections×worker_processes×2,因为此时一个请求需要维持两个套接字文件。
④worker_rlimit_sigpending #; 设定每个用户能够发往worker进程的信号的数量;
2、优化性能相关的配置:
①worker_processes #; #worker进程的个数;通常其数值应该为CPU的核心数减1;
②worker_cpu_affinity cpumask ...;
例如:
worker_processes 3;
worker_cpu_affinity 0001 0010 1000;
表示将3个worker进程分别绑定在CPU0,CPU1,CPU3上
③ssl_engine device; #在存在ssl硬件加速器的服务器上,指定所使用的ssl硬件加速设备;
④timer_resolution t; #每次内核事件调用返回时,都会使用gettimeofday()来更新nginx缓存时钟;timer_resolution用于定义每隔多久才会由gettimeofday()更新一次缓存时钟;x86-64系统上,gettimeofday()代价已经很小,可以忽略此配置;
⑤worker_priority nice; #-20,19之间的值;
3、事件相关的配置
①accept_mutex [on|off] #是否打开nginx的负载均衡锁;此锁能够让多个worker进程轮流地、序列化地与新的客户端建立连接;而通常当一个worker进程的负载达到其上限的7/8,master就尽可能不再将请求调度此worker;
②lock_file /path/to/lock_file;
③accept_mutex_delay #ms; #accept锁模式中,一个worker进程为取得accept锁的等待时长;如果某worker进程在某次试图取得锁时失败了,至少要等待#ms才能再一次请求锁;
④multi_accept on|off; #是否允许一次性地响应多个用户请求;默认为off;
⑤use [epoll|rtsig|select|poll]; #定义使用的事件模型,建议让nginx自动选择;
⑥worker_connections #; #每个worker进程能够并发响应的最大请求数;
4、用于调试、定位问题: 只调试nginx时使用
①daemon on|off; #是否让ningx运行于后台;默认为on,调试时可以设置为off,使得所有信息直接输出至控制台;
②master_process on|off #是否以master/worker模式运行nginx;默认为on;调试时可设置off以方便追踪;
③error_log /path/to/error_log level; #错误日志文件及其级别;默认为error级别;调试时可以使用debug级别,但要求在编译时必须使用--with-debug启用debug功能;
三、nginx的http web核心功能(http_core_module)
nginx必须使用虚拟主机来配置站点,每个虚拟主机使用一个server {}段配置
非虚拟主机的配置或公共配置,需要定义在server之外,http之内
◆虚拟主机相关的配置:
⑴server {...}
定义一个虚拟主机;nginx支持使用基于主机名或IP的虚拟主机;
⑵listen address[:port] [default_server] [ssl]...;
listen port [default_server] [ssl]...;
default_server:定义此server为http中默认的server;如果所有的server中没有任何一个listen使用此参数,那么第一个server即为默认server
rcvbuf=SIZE:接收缓冲大小
sndbuf=SIZE:发送缓冲大小
ssl:https server
⑶server_name [...];
server_name可以跟多个主机名,名称中可以使用通配符和正则表达式(通常以~开头);当nginx收到一个请求时,会取出其首部的server的值,而后跟众server_name进行比较;比较方式:
①先做精确匹配,如 www.magedu.com
②左侧通配符匹配,如 *.magedu.com
③右侧通配符匹配,如 www.*
④正则表达式匹配,如 ~^.*\.magedu\.com$
⑷server_name_hash_bucket_size 32|64|128;
为了实现快速主机查找,nginx使用hash表来保存主机名
⑸location [ = | ~ | ~* | ^~ ] uri { ... } #location只能放在server和location中,location可出现多次
location @name { ... }
功能:允许根据用户请求的URI来匹配指定的各location以进行访问配置;匹配到时,将被location块中的配置所处理;比如:http://www.magedu.com/p_w_picpaths/logo.gif
匹配规则:
=:精确匹配;
~:正则表达式模式匹配,区分字符大小写
~*:正则表达式模式匹配,忽略字符大小写
^~:URI前缀匹配,不检查正则表达式
@:用来定义“Named Location”这种“Named Location”不是用来处理外部的http请求,而是专门用来处理内部重定向的;此用法不常用
匹配优先级:
精确匹配、以^~开头的最长前缀匹配、正则表达式检索(由第一个匹配到所处理)、最长前缀匹配
示例:
① location / {
root /web/a;
}
② location ^~ /documents/ {
root /web/b;
}
③ location /documents/media/ {
root /web/c;
}
④ location ~* \.(gif|jpg|jpeg)$ {
root /web/d;
}
⑤ location = /documents/media/test.jpg {
root /web/e;
}
若请求的uri为/documents/media/test.jpg,则匹配的优先次序为⑤②④③①
◆文件路径定义:
⑴root path; #指定web资源根目录,可用于http,server和location中
⑵alias path; #定义指定路径的替换路径,只能用于location中
区别root path和alias path:
例,用户请求www.magedu.com/p_w_picpaths/b.html
①location /i/ {
root /data/p_w_picpaths;
}
“/i/top.gif”将由/data/p_w_picpaths/i/top.gif文件来响应
②location /i/ {
alias /data/p_w_picpaths/;
}
“/i/top.gif”将由/data/p_w_picpaths/top.gif文件来响应
说明:
root和alias指定的path都可以包含除$document_root和$realpath_root以外的变量
root文件路径的构造仅仅是将URI拼在root指令的值后面。如果需要修改URI,应该使用alias指令。
如果在定义了正则表达式的路径中使用了alias,那么正则表达式中应该含有匹配组, 并且alias应该引用这些匹配组来组成一个完整的文件路径,比如:
location ~ ^/users/(.+\.(?:gif|jpe?g|png))$ {
alias /data/w3/p_w_picpaths/$1;
}
⑶index file ...; #定义默认页面,可跟多个值
⑷error_page code ... [=[response]] uri;
当对于某个请求返回错误时,如果匹配上了error_page指令中设定的code,则重定向到新的uri,uri可以包含变量;还可以使用“=response”语法改变响应状态码。例如:
error_page 404 =200 /empty.gif;
error_page 403 http:/example.com/forbidden.html; #还可对错误进行重定向
如果内部跳转时无需改变URI,可以将错误处理转到一个命名路径:
location / {
error_page 404 = @fallback;
}
location @fallback {
proxy_pass http://backend;
}
⑸try_files path1 [path2 ...] uri;
自左至右尝试读取由path所指定路径,在第一次找到即停止并返回;如果所有path均不存在,则按最后一个uri进行内部跳转。最后一个参数也可以是code,还可以是命名路径,如@fallback;
例如:
location ~* ^/documents/(.*)$ {
root /www/htdocs;
try_files $uri /docu/$1 /temp.html @fallback; #或前面的几个文件都找不到,则会以原始URI转到最后指定的命名location
}
location /text/ {
alias /web/a/;
try_files $uri /text/back.html =404; #若去掉“=404”而以“/text/back.html”结尾,则“/text/back.html”不再表示一个文件的相对路径,而表示uri,它会重新寻找匹配的location
}
若请求/text/temp.html,则寻找的文件路径依次是/web/a/temp.html,/web/a/text/back.html,若这两个文件都找不到,则返回404
◆网络连接相关的设置:
⑴keepalive_timeout time; #保持连接的超时时长;默认为75秒
⑵keepalive_requests n; #在一次长连接上允许承载的最大请求数
⑶keepalive_disable [msie6 | safari | none ]; #对指定的浏览器禁止使用长连接
⑷tcp_nodelay on|off; #对keepalive连接是否使用TCP_NODELAY选项
⑸client_header_timeout time; #读取http请求首部的超时时长
⑹client_body_timeout time; #读取http请求包体的超时时长
⑺send_timeout time; #发送响应的超时时长
◆对客户端请求的限制:
⑴limit_except method ... { ... }
指定对范围之外的其它方法的访问控制,只能用在location中
例:
limit_except GET { #除get以外的其它方法只允许172.16.0.0访问
allow 172.16.0.0/16;
deny all;
}
⑵client_max_body_size size;
http请求包体的最大值;常用于限定客户所能够请求的最大包体;根据请求首部中的Content-Length来检测,以避免无用的传输;
⑶limit_rate speed; #限制客户端每秒钟传输的字节数;默认为0,表示没有限制;
⑷limit_rate_after time;
nginx向客户端发送响应报文时,如果时长超出了此处指定的时长,则后续的发送过程开始限速;
◆文件操作的优化:
⑴sendfile on|off; #是否启用sendfile功能;
⑵aio on|off; #是否启用aio功能;
⑶open_file_cache max=N [inactive=time]|off; #是否打开文件缓存功能;
max: 缓存条目的最大值;当满了以后将根据LRU算法进行置换;
inactive: 某缓存条目在指定时长时没有被访问过时,将自动被删除;默认为60s
缓存的信息包括:
文件句柄、文件大小和上次修改时间;
已经打开的目录结构;
没有找到或没有访问权限的信息;
⑷open_file_cache_errors on|off; #是否缓存文件找不到或没有权限访问等相关信息;
⑸open_file_cache_valid time; #多长时间检查一次缓存中的条目是否超出非活动时长,默认为60s
⑹open_file_cache_min_use #; #在inactive指定的时长内被访问超此处指定的次数地,才不会被删除;
◆对客户端请求的特殊处理:
⑴ignore_invalid_headers on|off;
是否忽略不合法的http首部;默认为on,off意味着请求首部中出现不合规的首部将拒绝响应;只能用于server和http
⑵log_not_found on|off; #是否将文件找不到的信息也记录进错误日志中;
⑶resolver address; #指定nginx使用的dns服务器地址;
⑷resover_timeout time; #指定DNS解析超时时长,默认为30s;
⑸server_tokens on|off; #是否在错误页面中显示nginx的版本号;
◆内存及磁盘资源分配:
⑴client_body_in_file_only on|clean|off;
HTTP的包体是否存储在磁盘文件中;非off表示存储,即使包体大小为0也会创建一个磁盘文件;on表示请求结束后包体文件不会被删除,clean表示会被删除;
⑵client_body_in_single_buffer on|off;
HTTP的包体是否存储在内存buffer当中;默认为off;
⑶cleint_body_buffer_size size;
nginx接收HTTP包体的内存缓冲区大小;若包体超出该值,则会写入磁盘文件中
⑷client_body_temp_path dir-path [level1 [level2 [level3]]];
HTTP包体存放的临时目录;
例如:client_body_temp_path /var/tmp/client/ 1 2;
后面的数字表示十六制的位数;此语句表示在/var/tmp/client目录下创建16个一级子目录,然后在每个一级子目录下创建16*16个二级子目录
⑸client_header_buffer_size size;
正常情况下接收用户请求的http报文header部分时分配的buffer大小;默认为1k
⑹large_client_header_buffers number size;
存储超大Http请求首部的内存buffer大小及个数;
⑺connection_pool_size size;
nginx对于每个建立成功的tcp连接都会预先分配一个内存池,此处即用于设定此内存池的初始大小;默认为256
⑻request_pool_size size;
nginx在处理每个http请求时会预先分配一个内存池,此处即用于设定此内存池的初始大小;默认为4k
◆http核心模块的内置变量:
$uri: 当前请求的uri,不带参数;
$request_uri: 请求的uri,带完整参数;
$host: http请求报文中host首部;如果请求中没有host首部,则以处理此请求的虚拟主机的主机名代替;
$hostname: nginx服务运行在的主机的主机名;
$remote_addr: 客户端IP
$remote_port: 客户端Port
$remote_user: 使用用户认证时客户端用户输入的用户名;
$request_filename: 用户请求中的URI经过本地root或alias转换后映射的本地的文件路径;
$request_method: 请求方法
$server_addr: 服务器地址
$server_name: 服务器名称
$server_port: 服务器端口
$server_protocol: 服务器向客户端发送响应时的协议,如http/1.1, http/1.0
$scheme: 在请求中使用scheme, 如https://www.magedu.com/中的https;
$http_HEADER: 匹配请求报文中指定的HEADER,$http_host匹配请求报文中的host首部
$sent_http_HEADER: 匹配响应报文中指定的HEADER,例如$http_content_type匹配响应报文中的content-type首部;
$document_root:当前请求映射到的root配置;
四、nginx作为web server的其它功能
1、访问控制(http_access_module)
allow address | CIDR | unix: | all;
deny address | CIDR | unix: | all;
缺省是allow all
示例:
location / {
deny 192.168.1.1;
allow 192.168.1.0/24;
allow 10.1.1.0/16;
deny all;6
}
2、用户认证(http_auth_basic_module)
auth_basic string | off;
auth_basic_user_file file;
示例:
location /admin/ {
root /www/b.org;
auth_basic "admin area";
auth_basic_user_file /etc/nginx/.htpasswd;
}
3、当无默认主页时显示文件列表,常用于建立下载站点(http_autoindex_module)
autoindex on | off;
4、防盗链(http_referer_module)
⑴定义合规的引用
valid_referers none | blocked | server_names | string ...;
说明:
none:缺少“Referer”请求头;
blocked:“Referer” 请求头存在,但是它的值被防火墙或者代理服务器删除; 这些值都不以“http://” 或者 “https://”字符串作为开头;
server_names:“Referer” 请求头包含某个虚拟主机名;
string可以是:
任意字符串:定义一个服务器名和可选的URI前缀。服务器名允许在开头或结尾使用“*”符号。 当nginx检查时,“Referer”请求头里的服务器端口将被忽略。
正则表达式:必须以“~”符号作为开头。 需要注意的是表达式会从“http://”或者“https://”之后的文本开始匹配
示例:
valid_referers none blocked server_names
*.example.com example.* www.example.org/galleries/
~\.google\.;
⑵拒绝不合规的引用
if ($invalid_referer) {
rewrite ^/.*$ http://www.b.org/403.html;
}
5、URL重写(http_rewrite_module)
⑴rewrite regex replacement [flag];
如果URI能匹配指定的正则表达式,此URI将被replacement参数定义的字符串改写。如果replacement的字符串以“http://”或“https://”开头,nginx将结束执行过程,并返回给客户端一个重定向。
flag参数可以是:
①last:一旦被当前规则匹配并重写后立即停止检查后续的其它rewrite的规则,而后通过重写后的规则重新发起请求
②break:一旦被当前规则匹配并重写后立即停止检查后续的其它rewrite的规则,而后继续由nginx进行后续操作;
③redirect:返回302临时重定向,浏览器会显示跳转后的URL地址
④permanent:返回301永久重定向,浏览器会显示跳转后的URL地址。
注意:
last和break只是实现URL重写,浏览器地址栏中的URL地址不变,这与重定向不同。
一般将rewrite写在location中时都使用break标志,或者将rewrite写在if上下文中
如果replacement字符串包括新的请求参数,以往的请求参数会添加到新参数后面。如果不希望这样,在replacement字符串末尾加一个问号“?”,就可以避免,例如:
rewrite ^/users/(.*)$ /show?user=$1? last;
如果正则表达式中包含字符“}”或者“;”,整个表达式应该被包含在单引号或双引号的引用中,因这两个符号在nginx配置文件中有特殊意义。
示例:
location / {
root /www/b.org;
rewrite ^/p_w_picpaths/(.*)$ /imgs/$1 last;
rewirte ^/imgs/(.*)$ /p_w_picpaths/$1 last;
}
上述用法会造成nginx重复10轮循环,然后返回错误500,应将last换成break
⑵rewrite_log on|off;
是否把重写过程记录在错误日志中,默认为off;若开启,默认为notice级别;
⑶return code [text];
return code URL;
return URL;
用于结束rewrite规则,并且为客户返回状态码;可以使用的状态码有204, 400, 402-406, 500-504等;
⑷if (condition) { ... }
示例:
if ($http_user_agent ~ MSIE) {
rewrite ^(.*)$ /msie/$1 break;
}
if ($invalid_referer) {
return 403;
}
6、查看nginx基本状态信息(http_stub_status_module,非标准模块,需在编译安装nginx时指定)
location /basic_status {
stub_status on;
}
转载于:https://blog.51cto.com/9124573/1773201