# Nginx学习笔记(二)
> 本片主要介绍Nginx的使用命令和配置文件的参数，配置参数笔记多，建议按照大纲目录阅读。 ---总结性文章，可以当做手册使用
## Nginx常用命令
##### systemctl 系统命令：
```shell
# 开机配置
systemctl enable nginx # 开机自动启动
systemctl disable nginx # 关闭开机自动启动
# 启动Nginx
# 启动Nginx成功后，可以直接访问主机IP，此时会展示Nginx默认页面
# 停止Nginx
systemctl stop nginx
# 重启Nginx
systemctl restart nginx
# 重新加载Nginx
systemctl reload nginx
# 查看 Nginx 运行状态
systemctl status nginx
# 查看Nginx进程
ps -ef | grep nginx
# 杀死Nginx进程
kill -9 pid # 根据上面查看到的Nginx进程号，杀死Nginx进程，-9 表示强制结束进程
```
##### Nginx 应用程序命令：
```shell
nginx -s reload # 向主进程发送信号，重新加载配置文件，热重启
nginx -s reopen # 重启
Nginxnginx -s stop # 快速关闭
nginx -s quit # 等待工作进程处理完成后关闭
nginx -T # 查看当前 Nginx 最终的配置
nginx -t # 检查配置是否有问题
```
## Nginx 核心配置
> 重点了解掌握Nginx核心配置文件的配置
Nginx核心配置文件`/usr/local/nginx/conf/nginx.conf`
看一下Nginx核心配置文件的结构，下面是典型的示例。
```shell
# main段配置信息
user nginx; # 运行用户，默认即是nginx，可以不进行设置
worker_processes auto; # Nginx 进程数，一般设置为和 CPU 核数一样
error_log /var/log/nginx/error.log warn; # Nginx 的错误日志存放目录
pid /var/run/nginx.pid; # Nginx 服务启动时的 pid 存放位置
# events段配置信息
events {
use epoll; # 使用epoll的I/O模型(如果你不知道Nginx该使用哪种轮询方法，会自动选择一个最适合你操作系统的)
worker_connections 1024; # 每个进程允许最大并发数
}
# http段配置信息
# 配置使用最频繁的部分，代理、缓存、日志定义等绝大多数功能和第三方模块的配置都在这里设置
http {
# 设置日志模式
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"';
access_log /var/log/nginx/access.log main; # Nginx访问日志存放位置
sendfile on; # 开启高效传输模式
tcp_nopush on; # 减少网络报文段的数量
tcp_nodelay on;
keepalive_timeout 65; # 保持连接的时间，也叫超时时间，单位秒
types_hash_max_size 2048;
include /etc/nginx/mime.types; # 文件扩展名与类型映射表
default_type application/octet-stream; # 默认文件类型
include /etc/nginx/conf.d/*.conf; # 加载子配置项
# server段配置信息
server {
listen 80; # 配置监听的端口
server_name localhost; # 配置的域名
# location段配置信息
location / {
root /usr/share/nginx/html; # 网站根目录
index index.html index.htm; # 默认首页文件
deny 172.168.22.11; # 禁止访问的ip地址，可以为all
allow 172.168.33.44；# 允许访问的ip地址，可以为all
}
error_page 500 502 503 504 /50x.html; # 默认50x对应的访问页面
error_page 400 404 error.html; # 同上
}
}
```
这里一共有6大段配置信息，分别如下：
- main 全局配置，对全局生效；
- events 配置影响 [Nginx 服务器](https://link.segmentfault.com/?enc=gTseazGwt2%2FqDMKkbTjqOw%3D%3D.eMFu9Co8IttWyTsLF9jCWWf%2F00NaIoHfc8PnI8s3ODIpfhDy8WhmmVi3U%2BArMMO484d%2B580MDRbArI6ob4t3Bi0Pv6HJ%2Bq7pT7KcuI%2FGgH9aR6w5Lcsxv2PGRnpyHfecBB7rzLOGCSjSv36%2FVzwF9n9t2bXz3lL5oIqTNQ6RpAsE8kGHdcA8GmSqIKeXq3%2FDR%2BFENFX6D%2F%2FGpcaT9JuQ%2BkeC1nIYabqLKcKwwugttWw%2Fe7FUOJ1sjkPdfSLYqfInCmo8MaMV0UKY9krf5gPHOQHjCNOdORL%2B5vviHAt7zLrtENMCLiHtkMCH%2BUggU82J)与用户的网络连接；
- http 配置代理，缓存，日志定义等绝大多数功能和第三方模块的配置；
- server 配置虚拟主机的相关参数，一个 http 块中可以有多个 server 块；
- location 用于配置匹配的 uri ；
- upstream 配置后端服务器具体地址，负载均衡配置不可或缺的部分；
### 配置文件 main 段核心参数
##### user
指定运行 [Nginx](https://link.segmentfault.com/?enc=3uyxmT0%2FoPa9w%2FDJSLtZ1Q%3D%3D.uoNSJ4SNB9tgavueVePb8FmeVwTDTfe8eX9E3o3NHoztqvxa2W3mW%2Bte5GQ7nYoE2bt7tZgZfyMFrBzhr2FekucH%2BLVSmDJZdBc8TPewJfR7ciF%2BmXUpXloTcCe7XzTQQ7zy3w5OwOV0bkLHsxOmCXjp%2Fcow%2BSCDfvIDcIic4T8CmBKG00nv%2F8y5kfkfO8jd4KYDPytTv%2F%2BvAnmch95q%2BBWiWrbiIqskCa4oDoWYmKQJgohJvt9nvQbYDk8NTgpj07rXEFH%2Bfkxm4bJbAGuS0K%2BrXvbv2QtheMI0sH5PV7KAHmoJOQ4i%2B%2FoGXdm%2BHLQA) 的 woker 子进程的属主和属组，其中组可以不指定。
```crmsh
user USERNAME [GROUP]
user nginx lion; # 用户是nginx;组是lion
```
##### pid
指定运行 [Nginx](https://link.segmentfault.com/?enc=TuFx%2FhF%2FZEURh1hpLZdHcQ%3D%3D.woVA3MQmlWg6gQdx4ryG0j%2FwwRtO8%2BoueEJ5PXsaNl24uWjmvSuWkZ0rDKN%2BzdtjiKwgwYrfhey739IvWtL%2FzBGHMAllFcqR%2B6WF%2FMWWveWUeQD53%2BfDkPdleomjAwYTDUKYyZjXpg%2BQ2I%2F%2BNghUs817bdNb6Y%2BNvSaRYq3GQpfBfUh%2BkWBXiLn5q%2F0s6CQEHZs5ZZ%2BJ9jLHq%2BfE47R3Gbx9MBFIKvVVBOvHf%2BLZD656gAepNq%2FkUpMpLlnR3S7osK7WahuBKhnbuLJHy32xKA%2Fzak2sUUetPnYLnr%2FUpPlnC8I5Fw8TVgPjlO0P6IsE) master 主进程的 pid 文件存放路径。
```awk
pid /opt/nginx/logs/nginx.pid # master主进程的的pid存放在nginx.pid的文件
```
##### worker_rlimit_nofile_number
指定 worker 子进程可以打开的最大文件句柄数。
```nginx
worker_rlimit_nofile 20480; # 可以理解成每个worker子进程的最大连接数量。
```
##### worker_rlimit_core
指定 worker 子进程异常终止后的 core 文件，用于记录分析问题。
```clean
worker_rlimit_core 50M; # 存放大小限制working_directory /opt/nginx/tmp; # 存放目录
```
##### worker_processes_number
指定 [Nginx 启动](https://link.segmentfault.com/?enc=jDVOfNNjXPazBLBDWXzwBw%3D%3D.mj8Q26lwnn5O%2FYJG4Et7pVtKWooNpVMZWQLiXEqKLjfoDcBbrUc%2BFbDLFRpdSYpCZaj7yeAnt5vBZv0sH4SE3L%2Bqf8a9KutCPraXYZaQAnzHPO7WKa6mcCcKSwh1e07z5gbotr2wUlDRNF1rv%2BksRHV2NAlIHX%2BbPNxBSvmMt06P%2FUU4OiJTwjO0XYiQ7RPNEoNz7hb1Oqu%2FbNpczl40zv5TQuqsOf68bbqjKc4fEVVGPbkW8ZpuoZy5oYKpgsY7PzAIoeJ1cbnysBIp0qqt0dCrrRRRoGBMwdnIjkFuhwDdKy1QTRNPQ07wQj%2BkxyU6)的 worker 子进程数量。
```nginx
worker_processes 4; # 指定具体子进程数量
worker_processes auto; # 与当前cpu物理核心数一致
```
##### worker_cpu_affinity
将每个 worker 子进程与我们的 cpu 物理核心绑定。
```apache
worker_cpu_affinity 0001 0010 0100 1000; # 4个物理核心，4个worker子进程
```
将每个 worker 子进程与特定 CPU 物理核心绑定，优势在于，避免同一个 worker 子进程在不同的 CPU 核心上切换，缓存失效，降低性能。但其并不能真正的避免进程切换。
##### worker_priority
指定 worker 子进程的 nice 值，以调整运行 [Nginx](https://link.segmentfault.com/?enc=dj%2BpcyBqOA7PML93NXk5kw%3D%3D.GT3wSvkLu3PfkJ6OgXIMMRm2tFZy4CHZ2HqqOMo77aI9RTEMbpcYv%2FklsWUXdu9X2Z8mGMy8D44ii3oOjWoN6oOjFj4HSSBpKjL5O6Vy3%2FSFlkeT64dw%2BXYlqr2kovdZCKQ%2FggZU1E4mP%2FzMHlvXYIUchNOTKbfX7NeG1wwXuTo2GpmwiX0c1QKwqTgulXkOp2nu%2FJN%2B5AOPnCS5RQeWN5shzQnJN0tGUsgzv2jHpIhQA%2Fdvnm9chtTW52ci4%2FIVnVbzeY%2B3rE75jZmyodhsdLwW4Dm%2F3mQ6WFGRWd28lOtege39MJcSVd%2FeiYOyeg7a) 的优先级，通常设定为负值，以优先调用 Nginx 。
```apache
worker_priority -10; # 120-10=110，110就是最终的优先级
```
Linux 默认进程的优先级值是120，值越小越优先；nice 定范围为 -20 到 +19
[**备注**] 应用的默认优先级值是120加上 nice 值等于它最终的值，这个值越小，优先级越高。
##### worker_shutdown_timeout
指定 worker 子进程优雅退出时的超时时间。
```abnf
worker_shutdown_timeout 5s;timer_resolution
```
worker 子进程内部使用的计时器精度，调整时间间隔越大，系统调用越少，有利于性能提升；反之，系统调用越多，性能下降。
##### timer_resolution 100ms;
在 Linux 系统中，用户需要获取计时器时需要向操作系统内核发送请求，有请求就必然会有开销，因此这个间隔越大开销就越小。
##### daemon
指定 [Nginx](https://link.segmentfault.com/?enc=BPCvN5gVcmh2UUNO%2FqPCTQ%3D%3D.TGAGyR6wxrHzlcEDg6Yhqqcvu5WzVHslSUeOjPXc4e56f7%2Br%2FNgKWKmxisCEiWLkUUnqnMkhXSPiiJh6JeL8wbkEv5X9X9sGPTE9cNh4EeoSGuuS49r22mSdZOugII9Mx8NMFY4jCNkv2YIkYvqT5dC4%2F6jjKvTsNWI7noNh3NtqslYxGG8FWdvxMFGQhBMenMQJ262rzAvuBhj0X1mMxqCKkIBR8Z6ERhJdy4Gy4FMGGxGXzbs%2B3Rzg4CbfNZdTFtO05t3%2BlqTPq%2FnWPn3qn1SK83YKMN%2B5nB0oSuWKfNyz%2BUWkr1OB4khpdq%2BNKVew) 的运行方式，前台还是后台，前台用于调试，后台用于生产。
```nginx
daemon off; # 默认是on，后台运行模式
```
### 配置文件 events 段核心参数
##### use
[Nginx](https://link.segmentfault.com/?enc=kygMaPVgBNJJ4dcZ2Z7DHA%3D%3D.E2KdGAhUzd8XoTelHnxV2sTWhqBWlpwwDmmSMoXuzin7Ks5s0s7%2F2nomduuWsMnN3vfnAV%2FoO7YC80LfFIgnYLsy0F6AxwJx79ZoarB8wCprkL8EHPdbVcabrT7oHY30OlTCG3Nuvm9qbc90CHqxNgmAd3aCdZ2qKP6DkxIrKjJaltgMUB%2BOiA8wG7wsze8kcOYIABKnt6YUN9aZZUUmV4y1IibFuDkqoy4poqY1%2BUXnoJe%2FuFT5SVZJnfcZvmKt2fBqSh6sMPxZeLmk0lNvhLSUD6uYJdn64kyYOtvztx3V%2ByJpWIhpaAfPiAVP2RAH) 使用何种事件驱动模型。
```oxygene
use method; # 不推荐配置它，让nginx自己选择method 可选值为：select、poll、kqueue、epoll、/dev/poll、eventport
```
##### workr_connections
worker 子进程能够处理的最大并发连接数。
```apache
worker_connections 1024 # 每个子进程的最大连接数为1024
```
##### accept_mutex
是否打开负载均衡互斥锁。
```nginx
accept_mutex on # 默认是off关闭的，这里推荐打开
```
## server_name 指令
指定虚拟主机域名。
```nginx
server_name name1 name2 name3
# 示例：
server_name www.nginx.com;
```
域名匹配的四种写法：
```sas
精确匹配：server_name www.nginx.com ;
左侧通配：server_name *.nginx.com ;
右侧统配：server_name www.nginx.* ;
正则匹配：server_name ~^www\.nginx\.*$ ;
匹配优先级：精确匹配 > 左侧通配符匹配 > 右侧通配符匹配 > 正则表达式匹配
```
#### server_name 配置实例：
1、配置本地 DNS 解析 vim /etc/hosts （ macOS 系统）
```accesslog
# 添加如下内容，其中 121.42.11.34 是阿里云服务器IP地址
121.42.11.34 www.nginx-test.com
121.42.11.34 mail.nginx-test.com
121.42.11.34 www.nginx-test.org
121.42.11.34 doc.nginx-test.com
121.42.11.34 www.nginx-test.cn
121.42.11.34 fe.nginx-test.club
```
[注意] 这里使用的是虚拟域名进行测试，因此需要配置本地 DNS 解析，如果使用阿里云上购买的域名，则需要在阿里云上设置好域名解析。
2、配置阿里云 [Nginx](https://link.segmentfault.com/?enc=fQpS0BxGBdykE2NSF7HcFw%3D%3D.f2sAKt%2BFxShE%2Fc3DIIm2PAKMj6U%2BoxPCP6oZ3jf7Mz%2F06cGq9fGWVLgxZVx2%2BDnbFOi7uAfuWlMGJt1exA2x4axbEDqZyGox2PGYBeBrBm25PTD6wvwr%2FRUuIBb6WlNUNdrwZF9N7eoA9smdwEot1YMykG79eF6SWDW%2BKAifp1vR19HIUM0Fnj%2BHG4jBhXEzEmd2KpO8qGF1xAtRAo7%2B6WpxyJwYOMmXOlSuVAcDCwOfQcO7mjdP1VHc8WSXfn5Kgy%2Bezwa9HaE2ygLDi1DLWz835OSfMKzBgnHqE6kWAHjHvaCcIqk3lfbujJqcmdWI) ，vim /etc/nginx/nginx.conf
```awk
# 这里只列举了http端中的sever端配置
# 左匹配
server {
listen 80;
server_name *.nginx-test.com;
root /usr/share/nginx/html/nginx-test/left-match/;
location / {
index index.html;
}
}
# 正则匹配
server {
listen 80;
server_name ~^.*\.nginx-test\..*$;
root /usr/share/nginx/html/nginx-test/reg-match/;
location / {
index index.html;
}
}
# 右匹配
server {
listen 80;
server_name www.nginx-test.*;
root /usr/share/nginx/html/nginx-test/right-match/;
location / {
index index.html;
}
}
# 完全匹配
server {
listen 80;
server_name www.nginx-test.com;
root /usr/share/nginx/html/nginx-test/all-match/;
location / {
index index.html;
}
}
```
3、访问分析
```stylus
当访问 www.nginx-test.com 时，都可以被匹配上，因此选择优先级最高的“完全匹配”；
当访问 mail.nginx-test.com 时，会进行“左匹配”；
当访问 www.nginx-test.org 时，会进行“右匹配”；
当访问 doc.nginx-test.com 时，会进行“左匹配”；
当访问 www.nginx-test.cn 时，会进行“右匹配”；
当访问 fe.nginx-test.club 时，会进行“正则匹配”；
```
###### root
指定静态资源目录位置，它可以写在 http 、 server 、 location 等配置中。
```dos
root path
```
例如：
```crmsh
location /image {
root /opt/nginx/static;
}
```
当用户访问 www.test.com/image/1.png 时，实际在服务器找的路径是 /opt/[nginx](https://link.segmentfault.com/?enc=e%2FYZJcn02g0gpWooxYRoWw%3D%3D.3uA%2BVeSVlQYhNATMLzzBnecZIe9ddii09UZeBMSg%2B%2Bsj0josxf%2Ba6eI%2BBep35v9uabxOFnPTVvuTg05I7NPLK9ENmk1f5VoJ4zfQYq0ZNcqtx0sz7DcuQQZf23qz%2BYt9N2etCnsJE%2BpN%2BDztJKl07TDzw1oXCoNAtf0kH0601uMRm7ojbPtfruZfz9zF1paQGreTtST2pGsV6Z0LYq5xeGMKWhtfDl9TQUTDhyZ9kQeyvC4Ra5CZxqYmB2BuluSSgyk5aqb0tM41T7%2BP4uW9ZPc8HUzb%2Bp%2Fh8V7yzlUQ2CEBTCBXHYuM2woQr7ao%2Bd4j)/static/image/1.png
[注意] root 会将定义路径与 URI 叠加， alias 则只取定义路径。
###### alias
它也是指定静态资源目录位置，它只能写在 location 中。
```awk
location /image {
alias /opt/nginx/static/image/;
}
```
当用户访问 www.test.com/image/1.png 时，实际在服务器找的路径是 /opt/nginx/static/image/1.png
[注意] 使用 alias 末尾一定要添加 / ，并且它只能位于 location 中。
###### location
配置路径。
```crmsh
location [ = | ~ | ~* | ^~ ] uri {
...
}
```
匹配规则：
```asciidoc
= 精确匹配；
~ 正则匹配，区分大小写；
~* 正则匹配，不区分大小写；
^~ 匹配到即停止搜索；
匹配优先级： = > ^~ > ~ > ~* > 不带任何字符。
```
实例：
```gradle
server {
listen 80;
server_name www.nginx-test.com;
# 只有当访问 www.nginx-test.com/match_all/ 时才会匹配到/usr/share/nginx/html/match_all/index.html
location = /match_all/ {
root /usr/share/nginx/html
index index.html
}
# 当访问 www.nginx-test.com/1.jpg 等路径时会去 /usr/share/nginx/images/1.jpg 找对应的资源
location ~ \.(jpeg|jpg|png|svg)$ {
root /usr/share/nginx/images;
}
# 当访问 www.nginx-test.com/bbs/ 时会匹配上 /usr/share/nginx/html/bbs/index.html
location ^~ /bbs/ {
root /usr/share/nginx/html;
index index.html index.htm;
}
}
location 中的反斜线
location /test {
...
}
location /test/ {
...
}
```
- 不带 / 当访问 www.nginx-test.com/test 时， [Nginx](https://link.segmentfault.com/?enc=qw0%2FYyl9oI6FZCbZItz7dw%3D%3D.NdnlN5Yc4ucvxafX8cVP%2FTnEHeNoSp58qUrAnlj8VectZJjx5wt2svBdMqtiuFXUEblepsiCxmxfjX%2BL8TouZXTlwceTQVDRWMbDA3K3W3qlpZ4L9rKcRbf20Lg5i34iqhXrnEZe63IOGztuUyk6HxBYMKIZFa9rMj6LPYLTwgEcrNxlKRWVxEuW813C8kpAW0WvdmCjHW3W4GZ5Evn7xI%2F6X19zCHcokCsTOwDIRb1c68ed1JHWHOMSIWSJJx%2FEM4a9q4VSFD7qAdJnUmQV2TEMKQdiO7Sq3u7f87JvTe06caDSFSpoL3nh7ovy6cdM) 先找是否有 test 目录，如果有则找 test 目录下的 index.html ；如果没有 test 目录， nginx 则会找是否有 test 文件。
- 带 / 当访问 www.nginx-test.com/test 时， [Nginx](https://link.segmentfault.com/?enc=t9%2FPKH70SgTugeDS6q%2FOYw%3D%3D.9PvTpNys8i8WdpPelE3mMUFJK7RfljETCpA9P10YiCx33xN8BgaVB34lsls1lqztztbFxDhJCQRPBjAcfz1Tf%2FJetjh7LZm7ZoSLQq2ZJPyniK84TNbdi8bhF0nFyPMxbtWKmxanoD%2BdF8GU9XhTwFljCA7kPz5vCuR5f6EElq79KAn6%2B92T9evrnK2URIJ738MtQS1YD7Q82gXkxzJpxkEvbc38mr1Yx36ZbrJZ1SG3HRqT4Pq%2B0M59rSNmsaW%2FaqkYNN5MInewZjonBqP9EWscFOZQoHRCUV6c1YlscAn8r2iSQmlKLmenTgn6bbVt) 先找是否有 test 目录，如果有则找 test 目录下的 index.html ，如果没有它也不会去找是否存在 test 文件。
###### return
停止处理请求，直接返回响应码或重定向到其他 URL ；执行 return 指令后， location 中后续指令将不会被执行。
```kotlin
return code [text];
return code URL;
return URL;
```
例如：
```crmsh
location / {
return 404; # 直接返回状态码
}
location / {
return 404 "pages not found"; # 返回状态码 + 一段文本
}
location / {
return 302 /bbs ; # 返回状态码 + 重定向地址
}
location / {
return https://www.baidu.com ; # 返回重定向地址
}
```
###### rewrite
根据指定正则表达式匹配规则，重写 URL 。
```pgsql
语法：rewrite 正则表达式 要替换的内容 [flag];上下文：server、location、if
```
示例：rewirte /images/(._.jpg)1; # $1是前面括号(._.jpg)的反向引用
flag 可选值的含义：
- last 重写后的 URL 发起新请求，再次进入 server 段，重试 location 的中的匹配；
- break 直接使用重写后的 URL ，不再匹配其它 location 中语句；
- redirect 返回302临时重定向；
- permanent 返回301永久重定向；
```crmsh
server{
listen 80;
server_name fe.lion.club; # 要在本地hosts文件进行配置
root html;
location /search {
rewrite ^/(.*) https://www.baidu.com redirect;
}
location /images {
rewrite /images/(.*) /pics/$1;
}
location /pics {
rewrite /pics/(.*) /photos/$1;
}
location /photos {
}
}
```
按照这个配置我们来分析：
- 当访问 fe.lion.club/search 时，会自动帮我们重定向到 [https://www.baidu.com。](https://link.segmentfault.com/?enc=Y4ISIIhLEETCkm9ovjnwVg%3D%3D.SZ0B2BtBlo3oja0TeOetgshX%2Fgf8Uxke%2B7%2BhEWpv8D0%3D)
- 当访问 fe.lion.club/images/1.jpg 时，第一步重写 URL 为 fe.lion.club/pics/1.jpg ，找到 pics 的 location ，继续重写 URL 为 fe.lion.club/photos/1.jpg ，找到 /photos 的 location 后，去 html/photos 目录下寻找 1.jpg 静态资源。
###### if 指令
```nim
语法：if (condition) {...}
上下文：server、location
```
示例：
```awk
if($http_user_agent ~ Chrome){
rewrite /(.*)/browser/$1 break;
}
```
condition 判断条件：
```asciidoc
$variable 仅为变量时，值为空或以0开头字符串都会被当做 false 处理；
= 或 != 相等或不等；
~ 正则匹配；
! ~ 非正则匹配；
~* 正则匹配，不区分大小写；
-f 或 ! -f 检测文件存在或不存在；
-d 或 ! -d 检测目录存在或不存在；
-e 或 ! -e 检测文件、目录、符号链接等存在或不存在；
-x 或 ! -x 检测文件可以执行或不可执行；
```
实例：
```nginx
server {
listen 8080;
server_name localhost;
root html;
location / {
if ( $uri = "/images/" ){
rewrite (.*) /pics/ break;
}
}
}
```
当访问 localhost:8080/images/ 时，会进入 if 判断里面执行 rewrite 命令。
###### autoindex
用户请求以 / 结尾时，列出目录结构，可以用于快速搭建静态资源下载网站。
autoindex.conf 配置信息：
```nginx
server {
listen 80;
server_name fe.lion-test.club;
location /download/ {
root /opt/source;
autoindex on; # 打开 autoindex，，可选参数有 on | off
autoindex_exact_size on; # 修改为off，以KB、MB、GB显示文件大小，默认为on，以bytes显示出⽂件的确切⼤⼩
autoindex_format html; # 以html的方式进行格式化，可选参数有 html | json | xml
autoindex_localtime off; # 显示的⽂件时间为⽂件的服务器时间。默认为off，显示的⽂件时间为GMT时间
}
}
```
当访问 fe.lion.com/download/ 时，会把服务器 /opt/source/download/ 路径下的文件展示出来，如下图所示：
Nginx提供给使用者的变量非常多，但是终究是一个完整的请求过程所产生数据， Nginx 将这些数据以变量的形式提供给使用者。
下面列举些项目中常用的变量：
```mipsasm
remote_addr #客户端 IP 地址
remote_port #客户端端口
server_addr #服务端 IP 地址
server_port #服务端端口
server_protocol #服务端协议
binary_remote_addr #二进制格式的客户端 IP 地址
connection #TCP 连接的序号，递增
connection_request #TCP 连接当前的请求数量
uri #请求的URL，不包含参数
request_uri #请求的URL，包含参数
scheme #协议名， http 或 https
request_method #请求方法
request_length #全部请求的长度，包含请求行、请求头、请求体
args #全部参数字符串
arg_参数名 #获取特定参数值
is_args #URL 中是否有参数，有的话返回 ? ，否则返回空
query_string #与 args 相同
host #请求信息中的 Host ，如果请求中没有 Host 行，则在请求头中找，最后使用 nginx 中设置的 server_name 。
http_user_agent #用户浏览器
http_referer #从哪些链接过来的请求
http_via #每经过一层代理服务器，都会添加相应的信息
http_cookie #获取用户 cookie
request_time #处理请求已消耗的时间
https #是否开启了 https ，是则返回 on ，否则返回空
request_filename #磁盘文件系统待访问文件的完整路径
document_root #由 URI 和 root/alias 规则生成的文件夹路径
limit_rate #返回响应时的速度上限值
```
实例演示 var.conf ：
```stata
server{
listen 8081;
server_name var.lion-test.club;
root /usr/share/nginx/html;
location / {
return 200 "
remote_addr: $remote_addr
remote_port: $remote_port
server_addr: $server_addr
server_port: $server_port
server_protocol: $server_protocol
binary_remote_addr: $binary_remote_addr
connection: $connection
uri: $uri
request_uri: $request_uri
scheme: $scheme
request_method: $request_method
request_length: $request_length
args: $args
arg_pid: $arg_pid
is_args: $is_args
query_string: $query_string
host: $host
http_user_agent: $http_user_agent
http_referer: $http_referer
http_via: $http_via
request_time: $request_time
https: $https
request_filename: $request_filename
document_root: $document_root
";
}
}
```
当我们访问 [http://var.lion-test.club:808...](https://link.segmentfault.com/?enc=gEyfenylgckXMNVuF%2BEydQ%3D%3D.0%2Baa3GE12auuOM2vyOpD8FMaxLWAQJsVCD%2FjFqzRhi0mig33imp21eZRdM7TbPdXIifnFUrSl5CSZvLcP9S74Q%3D%3D) 时，由于 Nginx 中写了 return 方法，因此 chrome 浏览器会默认为我们下载一个文件，下面展示的就是下载的文件内容：
```dts
remote_addr: 27.16.220.84
remote_port: 56838
server_addr: 172.17.0.2
server_port: 8081
server_protocol: HTTP/1.1
binary_remote_addr:
connection: 126
uri: /test/
request_uri: /test/?pid=121414&cid=sadasd
scheme: http
request_method: GET
request_length: 518
args: pid=121414&cid=sadasd
arg_pid: 121414
is_args: ?
query_string: pid=121414&cid=sadasd
host: var.lion-test.club
http_user_agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/88.0.4324.182 Safari/537.36
http_referer:
http_via:
request_time: 0.000
https:
request_filename: /usr/share/nginx/html/test/
document_root: /usr/share/nginx/html
```
Nginx 的配置还有非常多，以上只是罗列了一些常用的配置，在实际项目中还是要学会查阅文档。
# Nginx学习笔记(二)
> 本片主要介绍Nginx的使用命令和配置文件的参数，配置参数笔记多，建议按照大纲目录阅读。 ---总结性文章，可以当做手册使用
## Nginx常用命令
##### systemctl 系统命令：
```shell
# 开机配置
systemctl enable nginx # 开机自动启动
systemctl disable nginx # 关闭开机自动启动
# 启动Nginx
# 启动Nginx成功后，可以直接访问主机IP，此时会展示Nginx默认页面
# 停止Nginx
systemctl stop nginx
# 重启Nginx
systemctl restart nginx
# 重新加载Nginx
systemctl reload nginx
# 查看 Nginx 运行状态
systemctl status nginx
# 查看Nginx进程
ps -ef | grep nginx
# 杀死Nginx进程
kill -9 pid # 根据上面查看到的Nginx进程号，杀死Nginx进程，-9 表示强制结束进程
```
##### Nginx 应用程序命令：
```shell
nginx -s reload # 向主进程发送信号，重新加载配置文件，热重启
nginx -s reopen # 重启
Nginxnginx -s stop # 快速关闭
nginx -s quit # 等待工作进程处理完成后关闭
nginx -T # 查看当前 Nginx 最终的配置
nginx -t # 检查配置是否有问题
```
## Nginx 核心配置
> 重点了解掌握Nginx核心配置文件的配置
Nginx核心配置文件`/usr/local/nginx/conf/nginx.conf`
看一下Nginx核心配置文件的结构，下面是典型的示例。
```shell
# main段配置信息
user nginx; # 运行用户，默认即是nginx，可以不进行设置
worker_processes auto; # Nginx 进程数，一般设置为和 CPU 核数一样
error_log /var/log/nginx/error.log warn; # Nginx 的错误日志存放目录
pid /var/run/nginx.pid; # Nginx 服务启动时的 pid 存放位置
# events段配置信息
events {
use epoll; # 使用epoll的I/O模型(如果你不知道Nginx该使用哪种轮询方法，会自动选择一个最适合你操作系统的)
worker_connections 1024; # 每个进程允许最大并发数
}
# http段配置信息
# 配置使用最频繁的部分，代理、缓存、日志定义等绝大多数功能和第三方模块的配置都在这里设置
http {
# 设置日志模式
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"';
access_log /var/log/nginx/access.log main; # Nginx访问日志存放位置
sendfile on; # 开启高效传输模式
tcp_nopush on; # 减少网络报文段的数量
tcp_nodelay on;
keepalive_timeout 65; # 保持连接的时间，也叫超时时间，单位秒
types_hash_max_size 2048;
include /etc/nginx/mime.types; # 文件扩展名与类型映射表
default_type application/octet-stream; # 默认文件类型
include /etc/nginx/conf.d/*.conf; # 加载子配置项
# server段配置信息
server {
listen 80; # 配置监听的端口
server_name localhost; # 配置的域名
# location段配置信息
location / {
root /usr/share/nginx/html; # 网站根目录
index index.html index.htm; # 默认首页文件
deny 172.168.22.11; # 禁止访问的ip地址，可以为all
allow 172.168.33.44；# 允许访问的ip地址，可以为all
}
error_page 500 502 503 504 /50x.html; # 默认50x对应的访问页面
error_page 400 404 error.html; # 同上
}
}
```
这里一共有6大段配置信息，分别如下：
- main 全局配置，对全局生效；
- events 配置影响 [Nginx 服务器](https://link.segmentfault.com/?enc=gTseazGwt2%2FqDMKkbTjqOw%3D%3D.eMFu9Co8IttWyTsLF9jCWWf%2F00NaIoHfc8PnI8s3ODIpfhDy8WhmmVi3U%2BArMMO484d%2B580MDRbArI6ob4t3Bi0Pv6HJ%2Bq7pT7KcuI%2FGgH9aR6w5Lcsxv2PGRnpyHfecBB7rzLOGCSjSv36%2FVzwF9n9t2bXz3lL5oIqTNQ6RpAsE8kGHdcA8GmSqIKeXq3%2FDR%2BFENFX6D%2F%2FGpcaT9JuQ%2BkeC1nIYabqLKcKwwugttWw%2Fe7FUOJ1sjkPdfSLYqfInCmo8MaMV0UKY9krf5gPHOQHjCNOdORL%2B5vviHAt7zLrtENMCLiHtkMCH%2BUggU82J)与用户的网络连接；
- http 配置代理，缓存，日志定义等绝大多数功能和第三方模块的配置；
- server 配置虚拟主机的相关参数，一个 http 块中可以有多个 server 块；
- location 用于配置匹配的 uri ；
- upstream 配置后端服务器具体地址，负载均衡配置不可或缺的部分；
### 配置文件 main 段核心参数
##### user
指定运行 [Nginx](https://link.segmentfault.com/?enc=3uyxmT0%2FoPa9w%2FDJSLtZ1Q%3D%3D.uoNSJ4SNB9tgavueVePb8FmeVwTDTfe8eX9E3o3NHoztqvxa2W3mW%2Bte5GQ7nYoE2bt7tZgZfyMFrBzhr2FekucH%2BLVSmDJZdBc8TPewJfR7ciF%2BmXUpXloTcCe7XzTQQ7zy3w5OwOV0bkLHsxOmCXjp%2Fcow%2BSCDfvIDcIic4T8CmBKG00nv%2F8y5kfkfO8jd4KYDPytTv%2F%2BvAnmch95q%2BBWiWrbiIqskCa4oDoWYmKQJgohJvt9nvQbYDk8NTgpj07rXEFH%2Bfkxm4bJbAGuS0K%2BrXvbv2QtheMI0sH5PV7KAHmoJOQ4i%2B%2FoGXdm%2BHLQA) 的 woker 子进程的属主和属组，其中组可以不指定。
```crmsh
user USERNAME [GROUP]
user nginx lion; # 用户是nginx;组是lion
```
##### pid
指定运行 [Nginx](https://link.segmentfault.com/?enc=TuFx%2FhF%2FZEURh1hpLZdHcQ%3D%3D.woVA3MQmlWg6gQdx4ryG0j%2FwwRtO8%2BoueEJ5PXsaNl24uWjmvSuWkZ0rDKN%2BzdtjiKwgwYrfhey739IvWtL%2FzBGHMAllFcqR%2B6WF%2FMWWveWUeQD53%2BfDkPdleomjAwYTDUKYyZjXpg%2BQ2I%2F%2BNghUs817bdNb6Y%2BNvSaRYq3GQpfBfUh%2BkWBXiLn5q%2F0s6CQEHZs5ZZ%2BJ9jLHq%2BfE47R3Gbx9MBFIKvVVBOvHf%2BLZD656gAepNq%2FkUpMpLlnR3S7osK7WahuBKhnbuLJHy32xKA%2Fzak2sUUetPnYLnr%2FUpPlnC8I5Fw8TVgPjlO0P6IsE) master 主进程的 pid 文件存放路径。
```awk
pid /opt/nginx/logs/nginx.pid # master主进程的的pid存放在nginx.pid的文件
```
##### worker_rlimit_nofile_number
指定 worker 子进程可以打开的最大文件句柄数。
```nginx
worker_rlimit_nofile 20480; # 可以理解成每个worker子进程的最大连接数量。
```
##### worker_rlimit_core
指定 worker 子进程异常终止后的 core 文件，用于记录分析问题。
```clean
worker_rlimit_core 50M; # 存放大小限制working_directory /opt/nginx/tmp; # 存放目录
```
##### worker_processes_number
指定 [Nginx 启动](https://link.segmentfault.com/?enc=jDVOfNNjXPazBLBDWXzwBw%3D%3D.mj8Q26lwnn5O%2FYJG4Et7pVtKWooNpVMZWQLiXEqKLjfoDcBbrUc%2BFbDLFRpdSYpCZaj7yeAnt5vBZv0sH4SE3L%2Bqf8a9KutCPraXYZaQAnzHPO7WKa6mcCcKSwh1e07z5gbotr2wUlDRNF1rv%2BksRHV2NAlIHX%2BbPNxBSvmMt06P%2FUU4OiJTwjO0XYiQ7RPNEoNz7hb1Oqu%2FbNpczl40zv5TQuqsOf68bbqjKc4fEVVGPbkW8ZpuoZy5oYKpgsY7PzAIoeJ1cbnysBIp0qqt0dCrrRRRoGBMwdnIjkFuhwDdKy1QTRNPQ07wQj%2BkxyU6)的 worker 子进程数量。
```nginx
worker_processes 4; # 指定具体子进程数量
worker_processes auto; # 与当前cpu物理核心数一致
```
##### worker_cpu_affinity
将每个 worker 子进程与我们的 cpu 物理核心绑定。
```apache
worker_cpu_affinity 0001 0010 0100 1000; # 4个物理核心，4个worker子进程
```
将每个 worker 子进程与特定 CPU 物理核心绑定，优势在于，避免同一个 worker 子进程在不同的 CPU 核心上切换，缓存失效，降低性能。但其并不能真正的避免进程切换。
##### worker_priority
指定 worker 子进程的 nice 值，以调整运行 [Nginx](https://link.segmentfault.com/?enc=dj%2BpcyBqOA7PML93NXk5kw%3D%3D.GT3wSvkLu3PfkJ6OgXIMMRm2tFZy4CHZ2HqqOMo77aI9RTEMbpcYv%2FklsWUXdu9X2Z8mGMy8D44ii3oOjWoN6oOjFj4HSSBpKjL5O6Vy3%2FSFlkeT64dw%2BXYlqr2kovdZCKQ%2FggZU1E4mP%2FzMHlvXYIUchNOTKbfX7NeG1wwXuTo2GpmwiX0c1QKwqTgulXkOp2nu%2FJN%2B5AOPnCS5RQeWN5shzQnJN0tGUsgzv2jHpIhQA%2Fdvnm9chtTW52ci4%2FIVnVbzeY%2B3rE75jZmyodhsdLwW4Dm%2F3mQ6WFGRWd28lOtege39MJcSVd%2FeiYOyeg7a) 的优先级，通常设定为负值，以优先调用 Nginx 。
```apache
worker_priority -10; # 120-10=110，110就是最终的优先级
```
Linux 默认进程的优先级值是120，值越小越优先；nice 定范围为 -20 到 +19
[**备注**] 应用的默认优先级值是120加上 nice 值等于它最终的值，这个值越小，优先级越高。
##### worker_shutdown_timeout
指定 worker 子进程优雅退出时的超时时间。
```abnf
worker_shutdown_timeout 5s;timer_resolution
```
worker 子进程内部使用的计时器精度，调整时间间隔越大，系统调用越少，有利于性能提升；反之，系统调用越多，性能下降。
##### timer_resolution 100ms;
在 Linux 系统中，用户需要获取计时器时需要向操作系统内核发送请求，有请求就必然会有开销，因此这个间隔越大开销就越小。
##### daemon
指定 [Nginx](https://link.segmentfault.com/?enc=BPCvN5gVcmh2UUNO%2FqPCTQ%3D%3D.TGAGyR6wxrHzlcEDg6Yhqqcvu5WzVHslSUeOjPXc4e56f7%2Br%2FNgKWKmxisCEiWLkUUnqnMkhXSPiiJh6JeL8wbkEv5X9X9sGPTE9cNh4EeoSGuuS49r22mSdZOugII9Mx8NMFY4jCNkv2YIkYvqT5dC4%2F6jjKvTsNWI7noNh3NtqslYxGG8FWdvxMFGQhBMenMQJ262rzAvuBhj0X1mMxqCKkIBR8Z6ERhJdy4Gy4FMGGxGXzbs%2B3Rzg4CbfNZdTFtO05t3%2BlqTPq%2FnWPn3qn1SK83YKMN%2B5nB0oSuWKfNyz%2BUWkr1OB4khpdq%2BNKVew) 的运行方式，前台还是后台，前台用于调试，后台用于生产。
```nginx
daemon off; # 默认是on，后台运行模式
```
### 配置文件 events 段核心参数
##### use
[Nginx](https://link.segmentfault.com/?enc=kygMaPVgBNJJ4dcZ2Z7DHA%3D%3D.E2KdGAhUzd8XoTelHnxV2sTWhqBWlpwwDmmSMoXuzin7Ks5s0s7%2F2nomduuWsMnN3vfnAV%2FoO7YC80LfFIgnYLsy0F6AxwJx79ZoarB8wCprkL8EHPdbVcabrT7oHY30OlTCG3Nuvm9qbc90CHqxNgmAd3aCdZ2qKP6DkxIrKjJaltgMUB%2BOiA8wG7wsze8kcOYIABKnt6YUN9aZZUUmV4y1IibFuDkqoy4poqY1%2BUXnoJe%2FuFT5SVZJnfcZvmKt2fBqSh6sMPxZeLmk0lNvhLSUD6uYJdn64kyYOtvztx3V%2ByJpWIhpaAfPiAVP2RAH) 使用何种事件驱动模型。
```oxygene
use method; # 不推荐配置它，让nginx自己选择method 可选值为：select、poll、kqueue、epoll、/dev/poll、eventport
```
##### workr_connections
worker 子进程能够处理的最大并发连接数。
```apache
worker_connections 1024 # 每个子进程的最大连接数为1024
```
##### accept_mutex
是否打开负载均衡互斥锁。
```nginx
accept_mutex on # 默认是off关闭的，这里推荐打开
```
## server_name 指令
指定虚拟主机域名。
```nginx
server_name name1 name2 name3
# 示例：
server_name www.nginx.com;
```
域名匹配的四种写法：
```sas
精确匹配：server_name www.nginx.com ;
左侧通配：server_name *.nginx.com ;
右侧统配：server_name www.nginx.* ;
正则匹配：server_name ~^www\.nginx\.*$ ;
匹配优先级：精确匹配 > 左侧通配符匹配 > 右侧通配符匹配 > 正则表达式匹配
```
#### server_name 配置实例：
1、配置本地 DNS 解析 vim /etc/hosts （ macOS 系统）
```accesslog
# 添加如下内容，其中 121.42.11.34 是阿里云服务器IP地址
121.42.11.34 www.nginx-test.com
121.42.11.34 mail.nginx-test.com
121.42.11.34 www.nginx-test.org
121.42.11.34 doc.nginx-test.com
121.42.11.34 www.nginx-test.cn
121.42.11.34 fe.nginx-test.club
```
[注意] 这里使用的是虚拟域名进行测试，因此需要配置本地 DNS 解析，如果使用阿里云上购买的域名，则需要在阿里云上设置好域名解析。
2、配置阿里云 [Nginx](https://link.segmentfault.com/?enc=fQpS0BxGBdykE2NSF7HcFw%3D%3D.f2sAKt%2BFxShE%2Fc3DIIm2PAKMj6U%2BoxPCP6oZ3jf7Mz%2F06cGq9fGWVLgxZVx2%2BDnbFOi7uAfuWlMGJt1exA2x4axbEDqZyGox2PGYBeBrBm25PTD6wvwr%2FRUuIBb6WlNUNdrwZF9N7eoA9smdwEot1YMykG79eF6SWDW%2BKAifp1vR19HIUM0Fnj%2BHG4jBhXEzEmd2KpO8qGF1xAtRAo7%2B6WpxyJwYOMmXOlSuVAcDCwOfQcO7mjdP1VHc8WSXfn5Kgy%2Bezwa9HaE2ygLDi1DLWz835OSfMKzBgnHqE6kWAHjHvaCcIqk3lfbujJqcmdWI) ，vim /etc/nginx/nginx.conf
```awk
# 这里只列举了http端中的sever端配置
# 左匹配
server {
listen 80;
server_name *.nginx-test.com;
root /usr/share/nginx/html/nginx-test/left-match/;
location / {
index index.html;
}
}
# 正则匹配
server {
listen 80;
server_name ~^.*\.nginx-test\..*$;
root /usr/share/nginx/html/nginx-test/reg-match/;
location / {
index index.html;
}
}
# 右匹配
server {
listen 80;
server_name www.nginx-test.*;
root /usr/share/nginx/html/nginx-test/right-match/;
location / {
index index.html;
}
}
# 完全匹配
server {
listen 80;
server_name www.nginx-test.com;
root /usr/share/nginx/html/nginx-test/all-match/;
location / {
index index.html;
}
}
```
3、访问分析
```stylus
当访问 www.nginx-test.com 时，都可以被匹配上，因此选择优先级最高的“完全匹配”；
当访问 mail.nginx-test.com 时，会进行“左匹配”；
当访问 www.nginx-test.org 时，会进行“右匹配”；
当访问 doc.nginx-test.com 时，会进行“左匹配”；
当访问 www.nginx-test.cn 时，会进行“右匹配”；
当访问 fe.nginx-test.club 时，会进行“正则匹配”；
```
###### root
指定静态资源目录位置，它可以写在 http 、 server 、 location 等配置中。
```dos
root path
```
例如：
```crmsh
location /image {
root /opt/nginx/static;
}
```
当用户访问 www.test.com/image/1.png 时，实际在服务器找的路径是 /opt/[nginx](https://link.segmentfault.com/?enc=e%2FYZJcn02g0gpWooxYRoWw%3D%3D.3uA%2BVeSVlQYhNATMLzzBnecZIe9ddii09UZeBMSg%2B%2Bsj0josxf%2Ba6eI%2BBep35v9uabxOFnPTVvuTg05I7NPLK9ENmk1f5VoJ4zfQYq0ZNcqtx0sz7DcuQQZf23qz%2BYt9N2etCnsJE%2BpN%2BDztJKl07TDzw1oXCoNAtf0kH0601uMRm7ojbPtfruZfz9zF1paQGreTtST2pGsV6Z0LYq5xeGMKWhtfDl9TQUTDhyZ9kQeyvC4Ra5CZxqYmB2BuluSSgyk5aqb0tM41T7%2BP4uW9ZPc8HUzb%2Bp%2Fh8V7yzlUQ2CEBTCBXHYuM2woQr7ao%2Bd4j)/static/image/1.png
[注意] root 会将定义路径与 URI 叠加， alias 则只取定义路径。
###### alias
它也是指定静态资源目录位置，它只能写在 location 中。
```awk
location /image {
alias /opt/nginx/static/image/;
}
```
当用户访问 www.test.com/image/1.png 时，实际在服务器找的路径是 /opt/nginx/static/image/1.png
[注意] 使用 alias 末尾一定要添加 / ，并且它只能位于 location 中。
###### location
配置路径。
```crmsh
location [ = | ~ | ~* | ^~ ] uri {
...
}
```
匹配规则：
```asciidoc
= 精确匹配；
~ 正则匹配，区分大小写；
~* 正则匹配，不区分大小写；
^~ 匹配到即停止搜索；
匹配优先级： = > ^~ > ~ > ~* > 不带任何字符。
```
实例：
```gradle
server {
listen 80;
server_name www.nginx-test.com;
# 只有当访问 www.nginx-test.com/match_all/ 时才会匹配到/usr/share/nginx/html/match_all/index.html
location = /match_all/ {
root /usr/share/nginx/html
index index.html
}
# 当访问 www.nginx-test.com/1.jpg 等路径时会去 /usr/share/nginx/images/1.jpg 找对应的资源
location ~ \.(jpeg|jpg|png|svg)$ {
root /usr/share/nginx/images;
}
# 当访问 www.nginx-test.com/bbs/ 时会匹配上 /usr/share/nginx/html/bbs/index.html
location ^~ /bbs/ {
root /usr/share/nginx/html;
index index.html index.htm;
}
}
location 中的反斜线
location /test {
...
}
location /test/ {
...
}
```
- 不带 / 当访问 www.nginx-test.com/test 时， [Nginx](https://link.segmentfault.com/?enc=qw0%2FYyl9oI6FZCbZItz7dw%3D%3D.NdnlN5Yc4ucvxafX8cVP%2FTnEHeNoSp58qUrAnlj8VectZJjx5wt2svBdMqtiuFXUEblepsiCxmxfjX%2BL8TouZXTlwceTQVDRWMbDA3K3W3qlpZ4L9rKcRbf20Lg5i34iqhXrnEZe63IOGztuUyk6HxBYMKIZFa9rMj6LPYLTwgEcrNxlKRWVxEuW813C8kpAW0WvdmCjHW3W4GZ5Evn7xI%2F6X19zCHcokCsTOwDIRb1c68ed1JHWHOMSIWSJJx%2FEM4a9q4VSFD7qAdJnUmQV2TEMKQdiO7Sq3u7f87JvTe06caDSFSpoL3nh7ovy6cdM) 先找是否有 test 目录，如果有则找 test 目录下的 index.html ；如果没有 test 目录， nginx 则会找是否有 test 文件。
- 带 / 当访问 www.nginx-test.com/test 时， [Nginx](https://link.segmentfault.com/?enc=t9%2FPKH70SgTugeDS6q%2FOYw%3D%3D.9PvTpNys8i8WdpPelE3mMUFJK7RfljETCpA9P10YiCx33xN8BgaVB34lsls1lqztztbFxDhJCQRPBjAcfz1Tf%2FJetjh7LZm7ZoSLQq2ZJPyniK84TNbdi8bhF0nFyPMxbtWKmxanoD%2BdF8GU9XhTwFljCA7kPz5vCuR5f6EElq79KAn6%2B92T9evrnK2URIJ738MtQS1YD7Q82gXkxzJpxkEvbc38mr1Yx36ZbrJZ1SG3HRqT4Pq%2B0M59rSNmsaW%2FaqkYNN5MInewZjonBqP9EWscFOZQoHRCUV6c1YlscAn8r2iSQmlKLmenTgn6bbVt) 先找是否有 test 目录，如果有则找 test 目录下的 index.html ，如果没有它也不会去找是否存在 test 文件。
###### return
停止处理请求，直接返回响应码或重定向到其他 URL ；执行 return 指令后， location 中后续指令将不会被执行。
```kotlin
return code [text];
return code URL;
return URL;
```
例如：
```crmsh
location / {
return 404; # 直接返回状态码
}
location / {
return 404 "pages not found"; # 返回状态码 + 一段文本
}
location / {
return 302 /bbs ; # 返回状态码 + 重定向地址
}
location / {
return https://www.baidu.com ; # 返回重定向地址
}
```
###### rewrite
根据指定正则表达式匹配规则，重写 URL 。
```pgsql
语法：rewrite 正则表达式 要替换的内容 [flag];上下文：server、location、if
```
示例：rewirte /images/(._.jpg)1; # $1是前面括号(._.jpg)的反向引用
flag 可选值的含义：
- last 重写后的 URL 发起新请求，再次进入 server 段，重试 location 的中的匹配；
- break 直接使用重写后的 URL ，不再匹配其它 location 中语句；
- redirect 返回302临时重定向；
- permanent 返回301永久重定向；
```crmsh
server{
listen 80;
server_name fe.lion.club; # 要在本地hosts文件进行配置
root html;
location /search {
rewrite ^/(.*) https://www.baidu.com redirect;
}
location /images {
rewrite /images/(.*) /pics/$1;
}
location /pics {
rewrite /pics/(.*) /photos/$1;
}
location /photos {
}
}
```
按照这个配置我们来分析：
- 当访问 fe.lion.club/search 时，会自动帮我们重定向到 [https://www.baidu.com。](https://link.segmentfault.com/?enc=Y4ISIIhLEETCkm9ovjnwVg%3D%3D.SZ0B2BtBlo3oja0TeOetgshX%2Fgf8Uxke%2B7%2BhEWpv8D0%3D)
- 当访问 fe.lion.club/images/1.jpg 时，第一步重写 URL 为 fe.lion.club/pics/1.jpg ，找到 pics 的 location ，继续重写 URL 为 fe.lion.club/photos/1.jpg ，找到 /photos 的 location 后，去 html/photos 目录下寻找 1.jpg 静态资源。
###### if 指令
```nim
语法：if (condition) {...}
上下文：server、location
```
示例：
```awk
if($http_user_agent ~ Chrome){
rewrite /(.*)/browser/$1 break;
}
```
condition 判断条件：
```asciidoc
$variable 仅为变量时，值为空或以0开头字符串都会被当做 false 处理；
= 或 != 相等或不等；
~ 正则匹配；
! ~ 非正则匹配；
~* 正则匹配，不区分大小写；
-f 或 ! -f 检测文件存在或不存在；
-d 或 ! -d 检测目录存在或不存在；
-e 或 ! -e 检测文件、目录、符号链接等存在或不存在；
-x 或 ! -x 检测文件可以执行或不可执行；
```
实例：
```nginx
server {
listen 8080;
server_name localhost;
root html;
location / {
if ( $uri = "/images/" ){
rewrite (.*) /pics/ break;
}
}
}
```
当访问 localhost:8080/images/ 时，会进入 if 判断里面执行 rewrite 命令。
###### autoindex
用户请求以 / 结尾时，列出目录结构，可以用于快速搭建静态资源下载网站。
autoindex.conf 配置信息：
```nginx
server {
listen 80;
server_name fe.lion-test.club;
location /download/ {
root /opt/source;
autoindex on; # 打开 autoindex，，可选参数有 on | off
autoindex_exact_size on; # 修改为off，以KB、MB、GB显示文件大小，默认为on，以bytes显示出⽂件的确切⼤⼩
autoindex_format html; # 以html的方式进行格式化，可选参数有 html | json | xml
autoindex_localtime off; # 显示的⽂件时间为⽂件的服务器时间。默认为off，显示的⽂件时间为GMT时间
}
}
```
当访问 fe.lion.com/download/ 时，会把服务器 /opt/source/download/ 路径下的文件展示出来，如下图所示：
Nginx提供给使用者的变量非常多，但是终究是一个完整的请求过程所产生数据， Nginx 将这些数据以变量的形式提供给使用者。
下面列举些项目中常用的变量：
```mipsasm
remote_addr #客户端 IP 地址
remote_port #客户端端口
server_addr #服务端 IP 地址
server_port #服务端端口
server_protocol #服务端协议
binary_remote_addr #二进制格式的客户端 IP 地址
connection #TCP 连接的序号，递增
connection_request #TCP 连接当前的请求数量
uri #请求的URL，不包含参数
request_uri #请求的URL，包含参数
scheme #协议名， http 或 https
request_method #请求方法
request_length #全部请求的长度，包含请求行、请求头、请求体
args #全部参数字符串
arg_参数名 #获取特定参数值
is_args #URL 中是否有参数，有的话返回 ? ，否则返回空
query_string #与 args 相同
host #请求信息中的 Host ，如果请求中没有 Host 行，则在请求头中找，最后使用 nginx 中设置的 server_name 。
http_user_agent #用户浏览器
http_referer #从哪些链接过来的请求
http_via #每经过一层代理服务器，都会添加相应的信息
http_cookie #获取用户 cookie
request_time #处理请求已消耗的时间
https #是否开启了 https ，是则返回 on ，否则返回空
request_filename #磁盘文件系统待访问文件的完整路径
document_root #由 URI 和 root/alias 规则生成的文件夹路径
limit_rate #返回响应时的速度上限值
```
实例演示 var.conf ：
```stata
server{
listen 8081;
server_name var.lion-test.club;
root /usr/share/nginx/html;
location / {
return 200 "
remote_addr: $remote_addr
remote_port: $remote_port
server_addr: $server_addr
server_port: $server_port
server_protocol: $server_protocol
binary_remote_addr: $binary_remote_addr
connection: $connection
uri: $uri
request_uri: $request_uri
scheme: $scheme
request_method: $request_method
request_length: $request_length
args: $args
arg_pid: $arg_pid
is_args: $is_args
query_string: $query_string
host: $host
http_user_agent: $http_user_agent
http_referer: $http_referer
http_via: $http_via
request_time: $request_time
https: $https
request_filename: $request_filename
document_root: $document_root
";
}
}
```
当我们访问 [http://var.lion-test.club:808...](https://link.segmentfault.com/?enc=gEyfenylgckXMNVuF%2BEydQ%3D%3D.0%2Baa3GE12auuOM2vyOpD8FMaxLWAQJsVCD%2FjFqzRhi0mig33imp21eZRdM7TbPdXIifnFUrSl5CSZvLcP9S74Q%3D%3D) 时，由于 Nginx 中写了 return 方法，因此 chrome 浏览器会默认为我们下载一个文件，下面展示的就是下载的文件内容：
```dts
remote_addr: 27.16.220.84
remote_port: 56838
server_addr: 172.17.0.2
server_port: 8081
server_protocol: HTTP/1.1
binary_remote_addr:
connection: 126
uri: /test/
request_uri: /test/?pid=121414&cid=sadasd
scheme: http
request_method: GET
request_length: 518
args: pid=121414&cid=sadasd
arg_pid: 121414
is_args: ?
query_string: pid=121414&cid=sadasd
host: var.lion-test.club
http_user_agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/88.0.4324.182 Safari/537.36
http_referer:
http_via:
request_time: 0.000
https:
request_filename: /usr/share/nginx/html/test/
document_root: /usr/share/nginx/html
```
Nginx 的配置还有非常多，以上只是罗列了一些常用的配置，在实际项目中还是要学会查阅文档。
Nginx学习笔记(二)
Copyright: 采用 知识共享署名4.0 国际许可协议进行许可
Links: /archives/nginx学习笔记二
