Ngnix 已经广泛应用于 J-one 和 Jdos 的环境部署上，本文对 Ngnix 的常用的配置和基本功能进行讲解，适合 Ngnix 入门学习。

1 核心配置

找到 Nginx 安装目录下的 conf 目录下 nginx.conf 文件，Ngnix 的基本功能配置是由它提供的。

1.1 配置文件结构

Nginx 的配置文件(conf/nginx.conf)整体上分为如下几个部分：

配置层级图如下所示。

1.2 配置文件示例

一个比较全的配置文件示例如下。

1. # 以下是全局段配置
   

2. #user administrator administrators; #配置用户或者组，默认为nobody nobody。
   

3. #worker_processes 2; #设置进程数，默认为1
   

4. #pid /nginx/pid/nginx.pid; #指定nginx进程运行文件存放地址
   

5. error_log log/error.log debug; #制定日志路径，级别：debug|info|notice|warn|error|crit|alert|emerg
   

6. # events段配置信息
   

7. events {
   

8. accept_mutex on; #设置网路连接序列化，防止惊群现象发生，默认为on
   

9. multi_accept on; #设置一个进程是否同时接受多个网络连接，默认为off
   

10. #use epoll; #事件驱动模型，select|poll|kqueue|epoll|resig|/dev/poll|eventport
    

11. worker_connections 1024; #最大连接数，默认为512
    

12. }
    

13. # http、配置请求信息
    

14. http {
    

15. include mime.types; #文件扩展名与文件类型映射表
    

16. default_type application/octet-stream; #默认文件类型，默认为text/plain
    

17. #access_log off; #取消服务日志
    

18. log_format myFormat '$remote_addr–$remote_user [$time_local] $request $status $body_bytes_sent $http_referer $http_user_agent $http_x_forwarded_for'; #自定义格式
    

19. access_log log/access.log myFormat; #combined为日志格式的默认值
    

20. sendfile on; #允许sendfile方式传输文件，默认为off，可以在http块，server块，location块。
    

21. sendfile_max_chunk 100k; #每个进程每次调用传输数量不能大于设定的值，默认为0，即不设上限。
    

22. keepalive_timeout 65; #连接超时时间，默认为75s，可以在http，server，location块。
    

23. upstream mysvr {
    

24. server 127.0.0.1:7878;
    

25. server 192.168.10.121:3333 backup; #热备
    

26. }
    

27. error_page 404 https://www.baidu.com; #错误页
    

28. # 第一个Server区块开始，表示一个独立的虚拟主机站点
    

29. server {
    

30. keepalive_requests 120; #单连接请求上限次数。
    

31. listen 4545; #监听端口
    

32. server_name 127.0.0.1; #监听地址
    

33. location ~*^.+$ { #请求的url过滤，正则匹配，~为区分大小写，~*为不区分大小写。
    

34. #root path; #根目录
    

35. #index vv.txt; #设置默认页
    

36. proxy_pass http://mysvr; #请求转向mysvr 定义的服务器列表
    

37. deny 127.0.0.1; #拒绝的ip
    

38. allow 172.18.5.54; #允许的ip
    

39. }
    

40. }
    

41. }
    

1.3 locat 路径映射讲解

1.3.1 格式：

location [ = | ~ | ~| !~ | !~| @ ] uri {…}

1.3.2 解释：

= 表示精确匹配，如果找到，立即停止搜索并立即处理此请求。

~ 表示执行一个正则匹配，区分大小写匹配

~_表示执行一个正则匹配，不区分大小写匹配

!~ 区分大小写不匹配

!~_不区分大小写不匹配

^~ 即表示只匹配普通字符（空格）。使用前缀匹配，^表示“非”，即不查询正则表达式。如果匹配成功，则不再匹配其他 location。

@ 指定一个命名的 location，一般只用于内部重定向请求。例如 error_page, try_files

uri 是待匹配的请求字符串，可以不包含正则表达式，也可以包含正则表达式；

1.3.3 优先级和示例：

[不加] < [~/~*] < [^~] < [=]

示例如下：

1. location = / {
   

2. # 精确匹配/，主机名后面不能带任何字符串 /
   

3. # 只匹配http://abc.com
   

4. # http://abc.com [匹配成功]
   

5. # http://abc.com/index [匹配失败]
   

6. }
   

7. location ^~ /img/ {
   

8. #以 /img/ 开头的请求，都会匹配上
   

9. #http://abc.com/img/a.jpg [成功]
   

10. #http://abc.com/img/b.mp4 [成功]
    

11. }
    

12. location ~* /Example/ {
    

13. # 则会忽略 uri 部分的大小写
    

14. #http://abc.com/test/Example/ [匹配成功]
    

15. #http://abc.com/example/ [匹配成功]
    

16. }
    

17. location /documents {
    

18. # 如果有正则表达式可以匹配，则优先匹配正则表达式。
    

19. #http://abc.com/documentsabc [匹配成功]
    

20. }
    

21. location / {
    

22. #http://abc.com/abc [匹配成功]
    

23. }
    

2 反向代理

2.1 反向代理概念：

反向代理(Reverse Proxy)是指以代理服务器来接受 internet 上的连接请求，然后将请求转发给内部网络上的服务器，并将从服务器上得到的结果返回给 internet 上请求连接的客户端。真实的服务器不能直接被外部网络访问，所以需要一台代理服务器，而代理服务器能被外部网络访问的同时又跟真实服务器在同一个网络环境，当然也可能是同一台服务器，端口不同而已。

反向代理通过 proxy_pass 指令来实现。

2.2 反向代理示例：

1. server {
   

2. listen 80;
   

3. server_name localhost;
   

4. location / {
   

5. proxy_pass http://localhost:8081;
   

6. proxy_set_header Host $host:$server_port;#为请求头添加Host字段，用于指定请求服务器的域名/IP地址和端口号。
   

7. # 设置用户ip地址
   

8. proxy_set_header X-Forwarded-For $remote_addr;#为请求头添加XFF字段，值为客户端的IP地址。
   

9. # 当请求服务器出错去寻找其他服务器
   

10. proxy_next_upstream error timeout invalid_header http_500 http_502 http_503;
    

11. }
    

当我们访问 localhost 的时候，ngnix 就将我们的请求转到 localhost:8081 了

3 负载均衡

3.1 负载均衡概念：

当有 2 台或以上服务器时，代理服务器根据规则将请求分发到指定的服务器上处理。

3.2 负载均衡策略及示例：

Nginx 目前支持多种负载均衡策略，这里讲解常用的 6 种。

3.2.1RR(round robin :轮询 默认)：

每个请求按时间顺序逐一分配到不同的后端服务器，也就是说第一次请求分配到第一台服务器上，第二次请求分配到第二台服务器上，如果只有两台服务器，第三次请求继续分配到第一台上，这样循环轮询下去，也就是服务器接收请求的比例是 1:1， 如果后端服务器 down 掉，能自动剔除。轮询是默认配置，不需要太多的配置

同一个项目分别使用 8081 和 8082 端口启动项目

1. upstream web_servers {
   

2. server localhost:8081;
   

3. server localhost:8082;
   

4. }
   

5. server {
   

6. listen 80;
   

7. server_name localhost;
   

8. #access_log logs/host.access.log main;
   

9. location / {
   

10. proxy_pass http://web_servers;
    

11. proxy_set_header Host $host:$server_port;
    

12. }
    

13. }
    

3.2.2 热备：

假设有 2 台服务器，当一台服务器发生事故时，才启用第二台服务器给提供服务。服务器处理请求的顺序：AAAAAA 突然 A 挂了，服务器处理请求的顺序：BBBBBBBBBBBBBB…..

1. upstream web_servers {
   

2. server 127.0.0.1:7878;
   

3. server 192.168.10.121:3333 backup; #热备
   

4. }
   

3.2.3 权重

跟据配置的权重的大小而分发给不同服务器不同数量的请求。如果不设置，则默认为 1。下面服务器的请求顺序为：ABBABBABBABBABB….。

1. upstream web_servers {
   

2. server localhost:8081 weight=1;
   

3. server localhost:8082 weight=2;
   

4. }
   

3.2.4 ip_hash

这样每个 ip 地址固定访问一个后端服务器，可以解决 session 的问题。

1. upstream test {
   

2. ip_hash;
   

3. server localhost:8080;
   

4. server localhost:8081;
   

5. }
   

3.2.5 fair(第三方)

按后端服务器的响应时间来分配请求，响应时间短的优先分配。这个配置是为了更快的给用户响应。

1. upstream backend {
   

2. fair;
   

3. server localhost:8080;
   

4. server localhost:8081;
   

5. }
   

3.2.6 url_hash(第三方)

按访问 url 的 hash 结果来分配请求，使每个 url 定向到同一个后端服务器，后端服务器为缓存时比较有效。在 upstream 中加入 hash 语句，hash_method 是使用的 hash 算法

1. upstream backend {
   

2. hash_method crc32;
   

3. hash $request_uri;
   

4. server localhost:8080;
   

5. server localhost:8081;
   

6. }
   

以上 6 种负载均衡各自适用不同情况下单独或者混合使用，可以根据实际情况选择使用，fair 和 url_hash 需要安装第三方模块才能使用。

4 动静分离：

4.1 动静分离概念：

动静分离是指在 web 服务器架构中，将静态页面与动态页面或者静态内容接口和动态内容接口分开不同系统访问的架构设计方法，进而提升整个服务访问性能和可维护性。

4.2 动静分离示例：

1. upstream web_servers {
   

2. server localhost:8081;
   

3. server localhost:8082;
   

4. }
   

5. server {
   

6. listen 80;
   

7. server_name localhost;
   

8. set $doc_root /usr/local/var/www;
   

9. location ~* \.(gif|jpg|jpeg|png|bmp|ico|swf|css|js)$ {
   

10. root $doc_root/img;
    

11. }
    

12. location / {
    

13. proxy_pass http://web_servers;
    

14. proxy_set_header Host $host:$server_port;
    

15. }
    

16. error_page 500 502 503 504 /50x.html; #出现 500 502 503 504错误时走内部跳转
    

17. location = /50x.html {
    

18. root $doc_root;
    

19. }
    

20. }
    

结果：访问http://localhost/test.jpg时直接返回/usr/local/var/www/img 路径下的图片.

访问http://localhost/index.html就会访问后端服务器(tomcat 等)

5 其他常用的指令：

5.1.return 指令

返回 http 状态码和可选的第二个参数可以是重定向的 URL

1. return code [text];
   

2. return code URL;
   

3. return URL;
   

4. 例如：
   

5. location / {
   

6. return 404; # 直接返回状态码
   

7. }
   

8. location / {
   

9. return 404 "pages not found"; # 返回状态码 + 一段文本
   

10. }
    

11. location / {
    

12. return 302 /bbs ; # 返回状态码 + 重定向地址
    

13. }
    

14. location / {
    

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

16. }
    

5.2 rewrite 指令

重写 URI 请求 rewrite，通过使用 rewrite 指令在请求处理期间多次修改请求 URI，该指令具有一个可选参数和两个必需参数。

第一个(必需)参数是请求 URI 必须匹配的正则表达式。

第二个参数是用于替换匹配 URI 的 URI。

可选的第三个参数重写策略

• last 重写后的 URL 发起新请求，再次进入 server 段，重试 location 的中的匹配；

• break 直接使用重写后的 URL ，不再匹配其它 location 中语句；

• redirect 返回 302 临时重定向；

• permanent 返回 301 永久重定向；

1. location /users/ {
   

2. rewrite ^/users/(.*)$ /show?user=$1 break;
   

3. }
   

5.3 error_page 指令

使用 error_page 指令，您可以配置 NGINX 返回自定义页面以及错误代码，替换响应中的其他错误代码，或将浏览器重定向到其他 URI。在以下示例中，error_page 指令指定要返回 404 页面错误代码的页面(/404.html)。

1. server{
   

2. error_page 500 502 503 504 /50x.html;
   

3. location =/50x.html{
   

4. root html;
   

5. }
   

6. }
   

5.4 日志

访问日志：需要开启压缩 gzip on; 否则不生成日志文件，打开 log_format、access_log 注释

1. log_format main '$remote_addr - $remote_user [$time_local] "$request" '
   

2. '$status $body_bytes_sent "$http_referer" '
   

3. '"$http_user_agent" "$http_x_forwarded_for"';
   

4. access_log /usr/local/etc/nginx/logs/host.access.log main;
   

5. gzip on
   

5.5 deny 、allow 指令

1. #禁止访问某个目录
   

2. location / {
   

3. allow 192.168.0.0;
   

4. allow 127.0.0.1;
   

5. deny all;
   

6. #这段配置值允许192.168.0./24网段和127.0.0.1的请求，其他来源IP全部拒绝。
   

7. }
   

5.6 内置变量

nginx 的配置文件中可以使用的内置变量以美元符 $开始。其中，大部分预定义的变量的值由客户端发送携带。

args ：#这个变量等于请求行中的参数，同query_string

$content_length ：请求头中的 Content-length 字段。

$content_type ：请求头中的 Content-Type 字段。

$document_root ：当前请求在 root 指令中指定的值。

$host ：请求行的主机名，为空则为请求头字段 Host 中的主机名，再为空则与请求匹配的 server_name

$http_user_agent ：客户端 agent 信息

$http_cookie ：客户端 cookie 信息

$limit_rate ：这个变量可以限制连接速率。

$request_method ：客户端请求的动作，通常为 GET 或 POST。

$remote_addr ：客户端的 IP 地址。

$remote_port ：客户端的端口。

$remote_user ：已经经过 Auth Basic Module 验证的用户名。

$request_filename ：当前请求的文件路径，由 root 或 alias 指令与 URI 请求生成。

$scheme ：HTTP 方法（如 http，https）。

$server_protocol ：请求使用的协议，通常是 HTTP/1.0 或 HTTP/1.1。

$server_addr ：服务器地址，在完成一次系统调用后可以确定这个值。

$server_name ：服务器名称。

$server_port ：请求到达服务器的端口号。

$request_uri ：包含请求参数的原始 URI，不包含主机名，如：”/foo/bar.php?arg=baz”。

$uri：不带请求参数的当前URI，$uri 不包含主机名，如”/foo/bar.html”。

$documen{t}_{u}ri：与$uri 相同

6 总结

Ngnix 是一款高性能反向代理服务器，学习它非常有必要，本文讲解了 Ngnix 核心配置，介绍了反向代理，负载均衡，动静分离三大功能，最后扩展了一些常用的指令。本文介绍了 Ngnix 的基础用法，后续的 Ngnix 内核以及原理部分有待研究。

作者：京东物流 殷世杰

来源：京东云开发者社区 自猿其说 Tech 转载请注明来源