关于nginx:Nginx常用配置及和基本功能讲解-京东云技术团队

作者：京东物流殷世杰

Nginx 曾经广泛应用于 J -one 和 Jdos 的环境部署上，本文对 Nginx 的罕用的配置和基本功能进行解说，适宜 Nginx 入门学习。

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

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

区域	职责
全局块	配置和 Nginx 运行相干的全局配置
events 块	配置和网络链接相干的配置
http 块	配置代理、缓存、日志记录、虚拟主机等配置
server 块	配置虚拟主机的相干参数，一个 http 快中能够有多个 server 块
location 块	配置申请的路由，以及各种页面的解决状况

配置层级图如下所示。

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

# 以下是全局段配置
#user administrator administrators;  #配置用户或者组，默认为 nobody nobody。#worker_processes 2;  #设置过程数，默认为 1
#pid /nginx/pid/nginx.pid; #指定 nginx 过程运行文件寄存地址
error_log log/error.log debug;  #制订日志门路，级别：debug|info|notice|warn|error|crit|alert|emerg
# events 段配置信息
events {
    accept_mutex on;   #设置网路连贯序列化，避免惊群景象产生，默认为 on
    multi_accept on;  #设置一个过程是否同时承受多个网络连接，默认为 off
    #use epoll;      #事件驱动模型，select|poll|kqueue|epoll|resig|/dev/poll|eventport
    worker_connections  1024;    #最大连接数，默认为 512
}
# http、配置申请信息
http {
    include       mime.types;   #文件扩展名与文件类型映射表
    default_type  application/octet-stream; #默认文件类型，默认为 text/plain
    #access_log off; #勾销服务日志    
    log_format myFormat '$remote_addr–$remote_user [$time_local] $request $status $body_bytes_sent $http_referer $http_user_agent $http_x_forwarded_for'; #自定义格局
    access_log log/access.log myFormat;  #combined 为日志格局的默认值
    sendfile on;   #容许 sendfile 形式传输文件，默认为 off，能够在 http 块，server 块，location 块。sendfile_max_chunk 100k;  #每个过程每次调用传输数量不能大于设定的值，默认为 0，即不设下限。keepalive_timeout 65;  #连贯超时工夫，默认为 75s，能够在 http，server，location 块。upstream mysvr {   
      server 127.0.0.1:7878;
      server 192.168.10.121:3333 backup;  #热备
    }
    error_page 404 https://www.baidu.com; #谬误页
    # 第一个 Server 区块开始，示意一个独立的虚拟主机站点
    server {
        keepalive_requests 120; #单连贯申请下限次数。listen       4545;   #监听端口
        server_name  127.0.0.1;   #监听地址       
        location  ~*^.+$ {       #申请的 url 过滤，正则匹配，~ 为辨别大小写，~* 为不辨别大小写。#root path;  #根目录
           #index vv.txt;  #设置默认页
           proxy_pass  http://mysvr;  #申请转向 mysvr 定义的服务器列表
           deny 127.0.0.1;  #回绝的 ip
           allow 172.18.5.54; #容许的 ip           
        } 
    }
}

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

= 示意准确匹配，如果找到，立刻进行搜寻并立刻解决此申请。

~ 示意执行一个正则匹配，辨别大小写匹配

~* 示意执行一个正则匹配，不辨别大小写匹配

!~ 辨别大小写不匹配

!~* 不辨别大小写不匹配

^~ 即示意只匹配一般字符（空格）。应用前缀匹配，^ 示意“非”，即不查问正则表达式。如果匹配胜利，则不再匹配其余 location。

@ 指定一个命名的 location，个别只用于外部重定向申请。例如 error\_page, try\_files

uri 是待匹配的申请字符串，能够不蕴含正则表达式，也能够蕴含正则表达式；

[不加] < [~/~*] < [^~] < [=]
示例如下：

location = / {
    # 准确匹配 /，主机名前面不能带任何字符串 /
    # 只匹配 http://abc.com
    # http://abc.com [匹配胜利]
    # http://abc.com/index [匹配失败]
}
location ^~ /img/ {
      #以 /img/ 结尾的申请，都会匹配上
    #http://abc.com/img/a.jpg   [胜利]
    #http://abc.com/img/b.mp4  [胜利]
    }
location ~* /Example/ {
  # 则会疏忽 uri 局部的大小写
  #http://abc.com/test/Example/ [匹配胜利]
  #http://abc.com/example/ [匹配胜利]
}
location /documents {
    # 如果有正则表达式能够匹配，则优先匹配正则表达式。#http://abc.com/documentsabc [匹配胜利]
}
location / {#http://abc.com/abc [匹配胜利]
}

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

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

server {
    listen       80;
    server_name  localhost;


    location / {
         proxy_pass http://localhost:8081;
         proxy_set_header Host $host:$server_port;# 为申请头增加 Host 字段，用于指定申请服务器的域名 /IP 地址和端口号。# 设置用户 ip 地址
         proxy_set_header X-Forwarded-For $remote_addr;# 为申请头增加 XFF 字段，值为客户端的 IP 地址。# 当申请服务器出错去寻找其余服务器
         proxy_next_upstream error timeout invalid_header http_500 http_502 http_503;

当咱们拜访 localhost 的时候，ngnix 就将咱们的申请转到 localhost:8081 了

当有 2 台或以上服务器时，代理服务器依据规定将申请散发到指定的服务器上解决。

Nginx 目前反对多种负载平衡策略，这里解说罕用的 6 种。

每个申请按工夫程序逐个调配到不同的后端服务器，也就是说第一次申请调配到第一台服务器上，第二次申请调配到第二台服务器上，如果只有两台服务器，第三次申请持续调配到第一台上，这样循环轮询上来，也就是服务器接管申请的比例是 1:1，如果后端服务器 down 掉，能主动剔除。轮询是默认配置，不须要太多的配置

同一个我的项目别离应用 8081 和 8082 端口启动我的项目

upstream web_servers {
   server localhost:8081;
   server localhost:8082;
}




server {
    listen       80;
    server_name  localhost;
    #access_log  logs/host.access.log  main;
    location / {
        proxy_pass http://web_servers;
        proxy_set_header Host $host:$server_port;
    }

假如有 2 台服务器，当一台服务器产生事变时，才启用第二台服务器给提供服务。服务器解决申请的程序：AAAAAA 忽然 A 挂了，服务器解决申请的程序：BBBBBBBBBBBBBB…..

upstream web_servers {
      server 127.0.0.1:7878; 
      server 192.168.10.121:3333 backup;  #热备     
    }

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

upstream web_servers {
    server localhost:8081 weight=1;
    server localhost:8082 weight=2;
}

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

upstream test {
    ip_hash;
    server localhost:8080;
    server localhost:8081;
}

按后端服务器的响应工夫来调配申请，响应工夫短的优先调配。这个配置是为了更快的给用户响应。

upstream backend {
    fair;
    server localhost:8080;
    server localhost:8081;
}

按拜访 url 的 hash 后果来调配申请，使每个 url 定向到同一个后端服务器，后端服务器为缓存时比拟无效。在 upstream 中退出 hash 语句，hash_method 是应用的 hash 算法

upstream backend {
    hash_method crc32;
    hash $request_uri;
    server localhost:8080;
    server localhost:8081;
}

以上 6 种负载平衡各自实用不同状况下独自或者混合应用，能够依据理论状况抉择应用，fair 和 url_hash 须要装置第三方模块能力应用。

动静拆散是指在 web 服务器架构中，将动态页面与动静页面或者动态内容接口和动静内容接口离开不同零碎拜访的架构设计办法，进而晋升整个服务拜访性能和可维护性。

upstream web_servers {
       server localhost:8081;
       server localhost:8082;
}
server {
    listen       80;
    server_name  localhost;
    set $doc_root /usr/local/var/www;


    location ~* \.(gif|jpg|jpeg|png|bmp|ico|swf|css|js)$ {root $doc_root/img;}
    location / {
        proxy_pass http://web_servers;
        proxy_set_header Host $host:$server_port;
    }
    error_page 500 502 503 504  /50x.html;  #呈现 500 502 503 504 谬误时走外部跳转
    location = /50x.html {root $doc_root;}
 }

后果：拜访 http://localhost/test.jpg 时间接返回 /usr/local/var/www/img 门路下的图片.

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

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

return code ;
return code URL;
return URL;
例如：location / {return 404; # 间接返回状态码}
location / {return 404 "pages not found"; # 返回状态码 + 一段文本}
location / {return 302 /bbs ; # 返回状态码 + 重定向地址}
location / {return https://www.baidu.com ; # 返回重定向地址}

重写 URI 申请 rewrite，通过应用 rewrite 指令在申请解决期间屡次批改申请 URI，该指令具备一个可选参数和两个必须参数。

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

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

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

last 重写后的 URL 发动新申请，再次进入 server 段，重试 location 的中的匹配；
break 间接应用重写后的 URL，不再匹配其它 location 中语句；
redirect 返回 302 长期重定向；
permanent 返回 301 永恒重定向；

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

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

    server{
        error_page 500 502 503 504 /50x.html;
        location =/50x.html{root html;}
    }

拜访日志：须要开启压缩 gzip on; 否则不生成日志文件，关上 log\_format、access\_log 正文

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  /usr/local/etc/nginx/logs/host.access.log  main;




gzip

# 禁止拜访某个目录
location / {
    allow 192.168.0.0;
    allow 127.0.0.1;
    deny all;
#这段配置值容许 192.168.0./24 网段和 127.0.0.1 的申请，其余起源 IP 全副回绝。}

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”。
$document_uri：与 $uri 雷同

Ngnix 是一款高性能反向代理服务器，学习它十分有必要，本文解说了 Ngnix 外围配置，介绍了反向代理，负载平衡，动静拆散三大性能，最初扩大了一些罕用的指令。本文介绍了 Ngnix 的根底用法，后续的 Ngnix 内核以及原理局部有待钻研。

关于nginx:Nginx常用配置及和基本功能讲解-京东云技术团队

1 外围配置

1.2 配置文件示例

1.3 locat 门路映射解说

1.3.1 格局：

1.3.2 解释：

1.3.3 优先级和示例：

2 反向代理

2.1 反向代理概念：

2.2 反向代理示例：

3 负载平衡

3.1 负载平衡概念：

3.2 负载平衡策略及示例：

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

3.2.2 热备：

3.2.3 权重

3.2.4 ip_hash

3.2.5 fair(第三方)

3.2.6 url_hash(第三方)

4 动静拆散：

4.1 动静拆散概念：

4.2 动静拆散示例：

5 其余罕用的指令：

5.1.return 指令

5.2 rewrite 指令

5.3 error_page 指令

5.4 日志

5.5 deny、allow 指令

5.6 内置变量

6 总结