内容摘自nginx 官方文档，自己配合实例更细致的熟悉 nginx

命令启动，停止，重启配置

一旦 nginx 运行起来，通过如下方式 invoking nginx 的控制变更：

nginx -s stop // 停服
nginx -s quit // 优雅的停服
nginx -s reload // 重启配置文件
nginx -s reopen // 重新打开log文件

quit 和 stop 有何区别？

quit 会等最近一个 request 响应结束后退出进程（graceful shutdown）。
比如一个服务会 hold 起数秒，即使执行了 quit 命令，还是会等结果处理完毕后关闭 nginx。
stop 则马上停止。

配置文件错误，reload 是否会影响线上？

不会，如果 configure 错误，nginx 将 roll back 回老的配置文件，直到配置正确才会真正 reload 起效。

除了 stop 等，怎么停止 nginx 服务？

ps -ax | grep nginx
26318 ?        Ss     0:00 nginx: master process nginx
26351 ?        S      0:00 nginx: worker process
26357 pts/3    R+     0:00 grep --color=auto nginx
# 需要停止master进程
kill -s QUIT 26318

了解更多 nginx 控制命令

nginx 配置文件的结构

events {
    worker_connections 1024;
}
http {
    server {
        location / {
            proxy_pass http://127.0.0.1:8080;
        }
    }
}

文件服务

静态文件管理也是 Nginx 最大的特色之一（托管图片资源，静态 HTML 文件）

使用场景

比如如下是个存放静态资源的路径

1 2	/root/mydata/test/www # 存放html /root/mydata/test/images # 存放资源

访问静态页面
location 指定以 / 为前缀（prefix），匹配请求地址的 URI，匹配到的 URI 将添加到 root 指令的地址后。
访问：http://test.eminoda.com:81/test.html
nginx 按照：/root/mydata/test/www/test.html 输出文件

1
2
3

location / {
    root   /root/mydata/test/www;
}

访问图片等资源
匹配以 /images/ 开始的资源请求地址，注意，location / 也是可以匹配到的，但会根据实际路径有优先关系
访问：http://test.eminoda.com:81/images/yuyu.jpg
nginx 按照：/root/mydata/test/images/yuyu.jpg 输出文件

1
2
3

location /images/ {
    root /root/mydata/test;
}

root 和 alias 的区别？

指令	范围
root	http, server, location, if in location
alias	location

访问：http://test.eminoda.com:81/versionChange/yuyu.jpg
nginx 按照：/root/mydata/test/images/yuyu.jpg 输出文件

# 模拟一种常见，因为某些需求，更改了资源路径，但不能影响原有资源的输出访问
location /versionChange/ {
    alias /root/mydata/test/images/;
}

注意：斜杠问题，结合上例，比较有何不同

location /versionChange/ {
    alias /root/mydata/test/images; #error /root/mydata/test/imagesyuyu.jpg
}
location /versionChange {
    alias /root/mydata/test/images; #ok
}

怎么权衡 root 和 alias 的使用？

如果 location 匹配路径和指令的 value 最后部分相同时，建议使用 root。

location /images/ {
    alias /data/w3/images/;
}
# better
location /images/ {
    root /data/w3;
}

alias 和正则匹配问题？

如果 location 包含 regex expression，就会匹配正则捕获内容，在 alias 中替换（而非替换整个 location 路径）。
访问：http://test.eminoda.com:81/yuyu.jpg

1
2
3

location ~ ^/(.+\.(?:gif|jpg|png))$ {
    alias /root/mydata/test/images/$1;
}

访问：http://test.eminoda.com:81/foo/yuyu.jpg

1
2
3

location ~ ^/foo/(.+\.(?:gif|jpg|png))$ {
    alias /root/mydata/test/images/$1; #error /root/mydata/test/images/foo/yuyu.jpg
}

设置简单的代理 Proxy 服务

使用 nginx 代理，可能是解决我们日常开发，服务调用的最大原因

在了解 proxy 之前，先看下 location 路径匹配

location

指令	范围	语法
location	server, location	location [ = \| ~ \| ~* \| ^~ ] uri { … }

location 依赖 request 的 URI。按优先级排序。
=: 绝对匹配，exact match
~*：正则（忽略大小写），case-insensitive matching
~：正则，case-sensitive matching
^~：不能和 uri 定义的配置重复，prefix match
uri：路径 URI 匹配，uri match

举个经典的范例

location = / {
    [ configuration A ]
}

location / {
    [ configuration B ]
}

location /documents/ {
    [ configuration C ]
}

location ^~ /images/ {
    [ configuration D ]
}

location ~* \.(gif|jpg|jpeg)$ {
    [ configuration E ]
}

首先命中绝对匹配
如果有符合 regex 规则，则进入正则匹配。
剩下根据 uri 匹配

normalized URI 标准化 URI

decode 参数
解析相对路径
解析斜杠（merge_slashes）

merge_slashes

key	value
Syntax	merge_slashes on \| off;
Default	merge_slashes on;
Context	http, server

打开 merge_slashes 配置，将允许 //foo 之类多斜杠的路径匹配

proxy_pass

指令	范围
proxy_pass	location, if in location, limit_except

proxy_pass 定义了 URI 的区别

http://127.0.0.1:9000/users 提供服务

specified without a URI（忽略 URI）
访问：http://test.eminoda.com:81/users

1
2
3

location /users {
    proxy_pass http://127.0.0.1:3001;
}

request URI 在 location 匹配后，原样传送给 server

specified with a URI （指定 URI）
访问：http://test.eminoda.com:81/withinURI/users

1
2
3

location /withinURI/ {
    proxy_pass http://127.0.0.1:9000/;
}

如果 proxy_pass is specified with a URI，当 request URI 在 location 命中，URI 将替换被 location 匹配中的 request URI 的 part（注意 location 需要后面维护个/）

If the proxy_pass directive is specified with a URI, then when a request is passed to the server, the part of a normalized request URI matching the location is replaced by a URI specified in the directive

注意：location 需要后面维护个/
访问：http://test.eminoda.com:81/withinURIusers 注意这里故意没有写 /

1
2
3

location /withinURI {
    proxy_pass http://127.0.0.1:9000/;
}

修改配置：注意 location 的/
访问：http://test.eminoda.com:81/users

1
2
3

location /users/ {
    proxy_pass http://127.0.0.1:3001;
}

注意：浏览器 http://test.eminoda.com:81/users 会自动变成 http://test.eminoda.com:81/users/。原以为浏览器会默认添加，但是错了。

浏览器分别输入/users，当 location /users，浏览器不会默认添加/，而 location /users/ 则会自动添加。感觉像是 location 告诉浏览器你给我变的样子
查阅 location 文档：
如果 location 规则尾部包含斜杠（location /users/），在响应时会发送 301 永久重定向，地址后面自动加上斜杠（这就是为何浏览器会有斜杠的原因）

If a location is defined by a prefix string that ends with the slash character, and requests are processed by one of proxy_pass, fastcgi_pass, uwsgi_pass, scgi_pass, memcached_pass, or grpc_pass, then the special processing is performed. In response to a request with URI equal to this string, but without the trailing slash, a permanent redirect with the code 301 will be returned to the requested URI with the slash appended.

proxy_pass 有些其他规则，request URI 不确定被替换更改

location 定义正则，同时 proxy_pass 不能定义 URI
location 定义中有 rewrite break，后跟 proxy_pass

location /name/ {
    rewrite    /name/([^/]+) /users?name=$1 break;
    proxy_pass http://127.0.0.1;
}

proxy_pass 使用变量

1
2
3

location /name/ {
    proxy_pass http://127.0.0.1$request_uri;
}

rewrite

指令	范围
rewrite	server, location, if

rewrite regex replacement [flag];
如果正则匹配到 request URI，URI 则会和 replacement 替换

last

stops processing the current set of ngx_http_rewrite_module directives and starts a search for a new location matching the changed URI;

location /rewrite/test1 {
    rewrite ^/rewrite /last last; #跳出本location，到新的location查找/last
    return 404; #并不会输出
}
location /last {
    proxy_pass http://127.0.0.1:3001;
}

访问 http://test.eminoda.com:81/rewrite/test1，location，rewrite 命中，发起/last 请求，在 location 中继续寻找

修改配置：location 做如下修改
访问 http://test.eminoda.com:81/rewrite/test1，location 不会命中，rewrite 则不会匹配到
访问 http://test.eminoda.com:81/rewrite/test1/，可以命中

1
2
3

location /rewrite/test1/ {
    rewrite ^/rewrite /last last;
}

和本例无关，只是平时书写 location，要增强路径/的判断。请求地址包含/，则在 location 的规则上写上/，不然就不要添加

break

stops processing the current set of ngx_http_rewrite_module directives as with the break directive

location /rewrite/test2 {
    rewrite ^/rewrite/test2/foo /break break;
    proxy_pass http://127.0.0.1:3001;
}
# 不会执行
location /break {
    proxy_pass http://127.0.0.1:3001;
}

访问 http://test.eminoda.com:81/rewrite/test2，location 命中，rewrite 未匹配，之后请求 proxy_pass
访问 http://test.eminoda.com:81/rewrite/test2/foo，location 中 rewrite 命中，发起/break，由于之后是 proxy_pass，则实际访问 http://127.0.0.1:3001/break
和 last 不同，rewrite 匹配后，不会重新寻找 location

修改配置：结合上例，主要体现 ngx_http_rewrite_module 这个点

location /rewrite/test2 {
    rewrite ^/rewrite/test2/foo /break break;
    return 500;
}

访问 http://test.eminoda.com:81/rewrite/test2，location 匹配，rewrite 未匹配，直接访问 return 返回 500
访问 http://test.eminoda.com:81/rewrite/test2/foo，location 中 rewrite 命中，发起/break，注意break 会停止 ngx_http_rewrite_module 模块的指令，则不会像上例一样，或者 last 寻找新的 location。会在本地寻找 ooxx/break 资源，无则返回 404；

redirect

1 2	rewrite ^/redirect1 / redirect ; rewrite ^/redirect2 http://test.eminoda.com:81 redirect ;

返回 302 code，如果不以协议“http://”, “https://”, or “\$scheme”开头的匹配，则替换

permanent

returns a permanent redirect with the 301 code.

ngx_http_rewrite_module

break
if
return
rewrite
rewrite_log
set
uninitialized_variable_warn

了解更多

ngx_http_rewrite_module

有如下指令：

break
if
return
rewrite
set
…

再次强调

location 根据 request URI 来匹配
以上这些 directives 在 location 中将顺序执行
如果请求被 rewrite 多次，次数至多 10 次

break

停止 ngx_http_rewrite_module 语句

如果在 location 中，则会继续执行之后语句。上面 rewrite 的 break 已经说明过。

if 条件判断

比较变量

if ($test = 1){

}
if ($test !=1 ){

}

正则匹配

~ 匹配大小写；~* 忽略大小写
!~，!~*：否定判断
如果正则包含 } ; 等结尾符号，需要用引号包裹
文件判断（file existence）：-f !-f
目录判断（directory existence）：-d !-d
文件、目录、超链（file, directory, or symbolic link existence）：-e !-e
可执行文件（executable file）：-x !-x

http://test.eminoda.com:82/user
http://test.eminoda.com:82/userrr
http://test.eminoda.com:82/id/123

set $test 0;
if ( $request_uri !~ \/admin){
    set $test 1;
}
if ( $request_uri ~ '(\/use)r{2,3}$'){
    set $test 2;
}
if ( $request_uri ~* \/id\/[1-9]+){
    set $test 3;
}
location / {
    proxy_pass http://127.0.0.1:9000/$test;
}

结果

1
2
3

GET /1 404 4.039 ms - 1215
GET /2 404 4.609 ms - 1215
GET /3 404 4.540 ms - 1215

return

return http_status
return http_status URL
return URL

命令启动，停止，重启 配置

quit 和 stop 有何区别？

配置文件错误，reload 是否会影响线上？

除了 stop 等，怎么停止 nginx 服务？

了解更多 nginx 控制命令

nginx 配置文件的结构

文件服务

使用场景

root 和 alias 的区别？

怎么权衡 root 和 alias 的使用？

alias 和 正则匹配问题？

设置简单的代理 Proxy 服务

location

proxy_pass

proxy_pass 有些其他规则，request URI 不确定被替换更改

rewrite

last

break

redirect

permanent

ngx_http_rewrite_module

ngx_http_rewrite_module

break

if 条件判断

return

命令启动，停止，重启配置

alias 和正则匹配问题？