典型配置

  2. # main段配置信息
  3. user  nginx;                        # 运行用户，默认即是nginx，可以不进行设置
  4. worker_processes  auto;             # Nginx 进程数，一般设置为和 CPU 核数一样
  5. error_log  /var/log/nginx/error.log warn;   # Nginx 的错误日志存放目录
  6. pid        /var/run/nginx.pid;      # Nginx 服务启动时的 pid 存放位置
  8. # events段配置信息
  9. events {
  10.     use epoll;                 # 使用epoll的I/O模型(如果你不知道Nginx该使用哪种轮询方法，会自动选择一个最适合你操作系统的)
  11.     worker_connections 1024;   # 每个进程允许最大并发数
  12. }
  14. # http段配置信息
  15. # 配置使用最频繁的部分，代理、缓存、日志定义等绝大多数功能和第三方模块的配置都在这里设置
  16. http { 
  17.     # 设置日志模式
  18.     log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
  19.                       '$status $body_bytes_sent "$http_referer" '
  20.                       '"$http_user_agent" "$http_x_forwarded_for"';
  22.     access_log  /var/log/nginx/access.log  main;   # Nginx访问日志存放位置
  24.     sendfile            on;   # 开启高效传输模式
  25.     tcp_nopush          on;   # 减少网络报文段的数量
  26.     tcp_nodelay         on;
  27.     keepalive_timeout   65;   # 保持连接的时间，也叫超时时间，单位秒
  28.     types_hash_max_size 2048;
  30.     include             /etc/nginx/mime.types;      # 文件扩展名与类型映射表
  31.     default_type        application/octet-stream;   # 默认文件类型
  33.     include /etc/nginx/conf.d/*.conf;   # 加载子配置项
  34. }
  35.     # server段配置信息
  36.     server {
  37.       listen       80;       # 配置监听的端口
  38.       server_name  localhost;    # 配置的域名
  40.       # location段配置信息
  41.       location / {
  42.         root   /usr/share/nginx/html;  # 网站根目录
  43.         index  index.html index.htm;   # 默认首页文件
  44.         deny 172.168.22.11;   # 禁止访问的ip地址，可以为all
  45.         allow 172.168.33.44；# 允许访问的ip地址，可以为all
  46.       }
  48.       error_page 500 502 503 504 /50x.html;  # 默认50x对应的访问页面
  49.       error_page 400 404 error.html;   # 同上
  50.     }
  51. stream {
  52.         #nginx代理172.18.103.197:8899服务
  53.         upstream backend {
  54.           server 172.18.103.197:8899 weight=1;
  55.         }
  56.         server {
  57.            listen 9001;
  58.            proxy_pass backend;
  59.         }
  60.         #nginx代理172.18.103.197:8489服务
  61.         server {
  62.           listen 8489;
  63.           proxy_pass 172.18.103.197:8489;
  64.         }
  65.         server {
  66.         listen 8848;
  67.         proxy_pass 172.18.103.197:8848; 
  68.         }
  69.     }

- main：全局配置，对全局生效；
- events：配置影响 Nginx 服务器与用户的网络连接；
- http：配置代理，缓存，日志定义等绝大多数功能和第三方模块的配置；
- server：配置虚拟主机的相关参数，一个 http 块中可以有多个 server 块；
- location：用于配置匹配的 uri ；
- upstream：配置后端服务器具体地址，负载均衡配置不可或缺的部分。
 image.png

main段配置

  1. #user USERNAME [GROUP]                #运行用户名 用户组可选
  2. user  nginx;                        # 运行用户，默认即是nginx，可以不进行设置
  3. pid        /var/run/nginx.pid;      # Nginx 服务启动时的 pid 存放位置
  4. worker_rlimit_nofile 20480; # 可以理解成每个worker子进程的最大连接数量。
  5. worker_rlimit_core 50M; # 存放大小限制
  6. working_directory /opt/nginx/tmp; # 存放目录
  7. worker_processes  auto;             # Nginx 进程数，一般设置为和 CPU 核数一样
  8. error_log  /var/log/nginx/error.log warn;   # Nginx 的错误日志存放目录
  9. worker_priority -10; # 120-10=110，110就是最终的优先级
  10. worker_shutdown_timeout 5s;
  11. timer_resolution 100ms;
  12. daemon off; # 默认是on，后台运行模式

user：指定运行 Nginx 的 woker 子进程的属主和属组，其中组可以不指定。
pid：指定运行 Nginx master 主进程的 pid 文件存放路径。
worker_rlimit_nofile_number：指定 worker 子进程可以打开的最大文件句柄数。
worker_rlimit_core：指定 worker 子进程异常终止后的 core 文件，用于记录分析问题。
worker_processes_number：指定 Nginx 启动的 worker 子进程数量。
worker_cpu_affinity：将每个 worker 子进程与我们的 cpu 物理核心绑定。将每个 worker 子进程与特定 CPU 物理核心绑定，优势在于，避免同一个 worker 子进程在不同的 CPU 核心上切换，缓存失效，降低性能。但其并不能真正的避免进程切换
image.png
worker_priority：指定 worker 子进程的 nice 值，以调整运行 Nginx 的优先级，通常设定为负值，以优先调用 Nginx 。（Linux 默认进程的优先级值是120，值越小越优先；nice 定范围为 -20 到 +19 ）应用的默认优先级值是120加上 nice 值等于它最终的值，这个值越小，优先级越高。
worker_shutdown_timeout：指定 worker 子进程优雅退出时的超时时间。
timer_resolution：worker 子进程内部使用的计时器精度，调整时间间隔越大，系统调用越少，有利于性能提升；反之，系统调用越多，性能下降。
daemon：指定 Nginx 的运行方式，前台还是后台，前台用于调试，后台用于生产。

events端配置

use

Nginx 使用何种事件驱动模型。

  1. use method; # 不推荐配置它，让nginx自己选择method 可选值为：select、poll、kqueue、epoll、/dev/poll、eventport

worker_connections

worker 子进程能够处理的最大并发连接数。

  1. worker_connections 1024 # 每个子进程的最大连接数为1024

accept_mutex

是否打开负载均衡互斥锁。

  1. accept_mutex on # 默认是off关闭的，这里推荐打开

server_name 指令

指定虚拟主机域名。

  1. server_name name1 name2 name3
  2. # 示例：server_name www.nginx.com;

域名匹配的四种写法：

  • 精确匹配：server_name www.nginx.com ;
  • 左侧通配：server_name *.nginx.com ;
  • 右侧统配：server_name www.nginx.* ;
  • 正则匹配：server_name ~^www.nginx.*$ ;

匹配优先级：精确匹配 > 左侧通配符匹配 > 右侧通配符匹配 > 正则表达式匹配。

server_name 配置实例

1) 配置本地 DNS 解析 vim /etc/hosts

  1. # 添加如下内容，其中 121.42.11.34 是阿里云服务器IP地址
  2. 121.42.11.34 www.nginx-test.com
  3. 121.42.11.34 mail.nginx-test.com
  4. 121.42.11.34 www.nginx-test.org
  5. 121.42.11.34 doc.nginx-test.com
  6. 121.42.11.34 www.nginx-test.cn
  7. 121.42.11.34 fe.nginx-test.club

[注意] 这里使用的是虚拟域名进行测试，因此需要配置本地 DNS 解析，如果使用阿里云上购买的域名，则需要在阿里云上设置好域名解析。

2) 配置Nginx ，vim /etc/nginx/nginx.conf

  1. # 列举http端中的sever端配置
  3. # 左匹配
  4. server {
  5.   listen  80;
  6.   server_name  *.nginx-test.com;
  7.   root  /usr/share/nginx/html/nginx-test/left-match/;
  8.   location / {
  9.     index index.html;
  10.   }
  11. }
  13. # 正则匹配
  14. server {
  15.   listen  80;
  16.   server_name  ~^.*\.nginx-test\..*$;
  17.   root  /usr/share/nginx/html/nginx-test/reg-match/;
  18.   location / {
  19.     index index.html;
  20.   }
  21. }
  23. # 右匹配
  24. server {
  25.   listen  80;
  26.   server_name  www.nginx-test.*;
  27.   root  /usr/share/nginx/html/nginx-test/right-match/;
  28.   location / {
  29.     index index.html;
  30.   }
  31. }
  33. # 完全匹配
  34. server {
  35.   listen  80;
  36.   server_name  www.nginx-test.com;
  37.   root  /usr/share/nginx/html/nginx-test/all-match/;
  38.   location / {
  39.     index index.html;
  40.   }
  41. }

3) 访问分析

  • 当访问 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 等配置中。 ```java root path

例如： location /image { root /opt/nginx/static; }

当用户访问 www.test.com/image/1.png 时，实际在服务器找的路径是 /opt/nginx/static/image/1.png

  1. [注意] root 会将定义路径与 URI 叠加， alias 则只取定义路径。
  2. <a name="HIBib"></a>
  3. ## alias
  4. 指定静态资源目录位置，它**只能写在 location** 中。
  5. ```java
  6. location /image {
  7.   alias /opt/nginx/static/image/;
  8. }
  10. 当用户访问 www.test.com/image/1.png 时，实际在服务器找的路径是 /opt/nginx/static/image/1.png

[注意] 使用 alias 末尾一定要添加 / ，并且它只能位于 location 中。

location

配置路径。
location [ = | ~ | ~* | ^~ ] uri { …}
匹配规则：

  • = 精确匹配；
  • ~ 正则匹配，区分大小写；
  • ~* 正则匹配，不区分大小写；
  • ^~ 匹配到即停止搜索；

匹配优先级：= > ^~ > ~ > ~* > 不带任何字符。

配置实例

  1. server {
  2.   listen  80;
  3.   server_name  www.nginx-test.com;
  5.   # 只有当访问 www.nginx-test.com/match_all/ 时才会匹配到/usr/share/nginx/html/match_all/index.html
  6.   location = /match_all/ {
  7.       root  /usr/share/nginx/html
  8.       index index.html
  9.   }
  11.   # 当访问 www.nginx-test.com/1.jpg 等路径时会去 /usr/share/nginx/images/1.jpg 找对应的资源
  12.   location ~ \.(jpeg|jpg|png|svg)$ {
  13.     root /usr/share/nginx/images;
  14.   }
  16.   # 当访问 www.nginx-test.com/bbs/ 时会匹配上 /usr/share/nginx/html/bbs/index.html
  17.   location ^~ /bbs/ {
  18.     root /usr/share/nginx/html;
  19.     index index.html index.htm;
  20.   }
  21. }

1) location 中的反斜线

  1. location /test {
  2.   ...
  3. }
  5. location /test/ {
  6.   ...
  7. }
  • 不带 / 当访问 www.nginx-test.com/test 时， Nginx 先找是否有 test 目录，如果有则找 test 目录下的 index.html ；如果没有 test 目录， nginx 则会找是否有 test 文件；
  • 带 / 当访问 www.nginx-test.com/test 时， Nginx 先找是否有 test 目录，如果有则找 test 目录下的 index.html ，如果没有它也不会去找是否存在 test 文件。

    2) return

    停止处理请求，直接返回响应码或重定向到其他 URL ；执行 return 指令后， location 中后续指令将不会被执行。 ```java

return code [text]; return code URL; return URL;

例如： location / { return 404; # 直接返回状态码 }

location / { return 404 “pages not found”; # 返回状态码 + 一段文本 }

location / { return 302 /bbs ; # 返回状态码 + 重定向地址 }

location / { return https://www.baidu.com ; # 返回重定向地址 }

  1. <a name="ql9pU"></a>
  2. ## rewrite
  3. 根据指定正则表达式匹配规则，重写 URL 。<br />语法：rewrite 正则表达式 要替换的内容 [flag];<br />上下文：server、location、if<br />示例：rewirte /images/(.*\.jpg)$ /pic/$1; _# $1是前面括号(.*\.jpg)的反向引用_
  5. flag 可选值的含义：
  7. - last 重写后的 URL 发起新请求，再次进入 server 段，重试 location 的中的匹配；
  8. - break 直接使用重写后的 URL ，不再匹配其它 location 中语句；
  9. - redirect 返回 302 临时重定向；
  10. - permanent 返回 301 永久重定向。
  11. ```java
  12. server{
  13.   listen 80;
  14.   server_name fe.lion.club; # 要在本地hosts文件进行配置
  15.   root html;
  16.   location /search {
  17.     rewrite ^/(.*) https://www.baidu.com redirect;
  18.   }
  20.   location /images {
  21.     rewrite /images/(.*) /pics/$1;
  22.   }
  24.   location /pics {
  25.     rewrite /pics/(.*) /photos/$1;
  26.   }
  28.   location /photos {
  30.   }
  31. }

按照这个配置我们来分析：

  • 当访问 fe.lion.club/search 时，会自动帮我们重定向到 https://www.baidu.com；
  • 当访问 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 指令

    ```java

语法：if (condition) {…}

上下文：server、location

示例： if($http_user_agent ~ Chrome){ rewrite /(.*)/browser/$1 break; }

  1. condition 判断条件：
  3. - **$variable** 仅为变量时，值为空或以0开头字符串都会被当做 false 处理；
  4. - **=** 或 **!=** 相等或不等；
  5. - **~** 正则匹配；
  6. - **! ~** 非正则匹配；
  7. - **~*** 正则匹配，不区分大小写；
  8. - **-f** 或 **! -f** 检测文件存在或不存在；
  9. - **-d **或 **! -d** 检测目录存在或不存在；
  10. - **-e** 或 **! -e** 检测文件、目录、符号链接等存在或不存在；
  11. - **-x** 或 **! -x** 检测文件可以执行或不可执行；
  13. 实例：
  14. ```java
  15. server {
  16.   listen 8080;
  17.   server_name localhost;
  18.   root html;
  20.   location / {
  21.     if ( $uri = "/images/" ){
  22.       rewrite (.*) /pics/ break;
  23.     }
  24.   }
  25. }

当访问 localhost:8080/images/ 时，会进入 if 判断里面执行 rewrite 命令。

autoindex

用户请求以 / 结尾时，列出目录结构，可以用于快速搭建静态资源下载网站。
autoindex.conf 配置信息：

  2. server {
  3.   listen 80;
  4.   server_name fe.lion-test.club;
  6.   location /download/ {
  7.     root /opt/source;
  9.     autoindex on; # 打开 autoindex，，可选参数有 on | off
  10.     autoindex_exact_size on; # 修改为off，以KB、MB、GB显示文件大小，默认为on，以bytes显示出⽂件的确切⼤⼩
  11.     autoindex_format html; # 以html的方式进行格式化，可选参数有 html | json | xml
  12.     autoindex_localtime off; # 显示的⽂件时间为⽂件的服务器时间。默认为off，显示的⽂件时间为GMT时间
  13.   }
  14. }

当访问 fe.lion.com/download/ 时，会把服务器 /opt/source/download/ 路径下的文件展示出来，如下图所示：
image.png

变量

Nginx 提供给使用者的变量非常多，但是终究是一个完整的请求过程所产生数据， Nginx 将这些数据以变量的形式提供给使用者。
image.png

  2. server{
  3.   listen 8081;
  4.   server_name var.lion-test.club;
  5.   root /usr/share/nginx/html;
  6.   location / {
  7.     return 200 "
  8. remote_addr: $remote_addr
  9. remote_port: $remote_port
  10. server_addr: $server_addr
  11. server_port: $server_port
  12. server_protocol: $server_protocol
  13. binary_remote_addr: $binary_remote_addr
  14. connection: $connection
  15. uri: $uri
  16. request_uri: $request_uri
  17. scheme: $scheme
  18. request_method: $request_method
  19. request_length: $request_length
  20. args: $args
  21. arg_pid: $arg_pid
  22. is_args: $is_args
  23. query_string: $query_string
  24. host: $host
  25. http_user_agent: $http_user_agent
  26. http_referer: $http_referer
  27. http_via: $http_via
  28. request_time: $request_time
  29. https: $https
  30. request_filename: $request_filename
  31. document_root: $document_root
  32. ";
  33.   }
  34. }

当我们访问 http://var.lion-test.club:8081/test?pid=121414&cid=sadasd 时，由于 Nginx 中写了 return 方法，因此 chrome 浏览器会默认为我们下载一个文件，下面展示的就是下载的文件内容：

  2. remote_addr: 27.16.220.84
  3. remote_port: 56838
  4. server_addr: 172.17.0.2
  5. server_port: 8081
  6. server_protocol: HTTP/1.1
  7. binary_remote_addr: 茉
  8. connection: 126
  9. uri: /test/
  10. request_uri: /test/?pid=121414&cid=sadasd
  11. scheme: http
  12. request_method: GET
  13. request_length: 518
  14. args: pid=121414&cid=sadasd
  15. arg_pid: 121414
  16. is_args: ?
  17. query_string: pid=121414&cid=sadasd
  18. host: var.lion-test.club
  19. 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
  20. http_referer: 
  21. http_via: 
  22. request_time: 0.000
  23. https: 
  24. request_filename: /usr/share/nginx/html/test/
  25. document_root: /usr/share/nginx/html