Nginx反代配置详解

共计 6567 个字符，预计需要花费 17 分钟才能阅读完成。

一、ngx_http_proxy_module 模块

ngx_http_proxy_module 模块可根据用户请求的 uri 传递至后端服务器，实现反向代理

命令：

1.proxy_pass

    设置一个代理服务器的地址，协议，和一个可选的 URI 的位置应该映射。作为一个协议，“HTTP”或“https”可以指定。地址可以被指定为一个域名或 IP 地址，和一个可选的端口

语法：proxy_pass URL;

可用的上下文：location, if in location, limit_except

注意：proxy_pass 后面的路径不带 uri 时，其会将 location 的 uri 传递给后端主机；proxy_pass 后面的路径是一个 uri 时，其会将 location 的 uri 替换为 proxy_pass 的 uri；如果 location 定义其 uri 时使用了正则表达式的模式，则 proxy_pass 之后必须不能使用 uri; 用户请求时传递的 uri 将直接附加代理到的服务的之后；

2.proxy_set_header

设定发往后端主机的请求报文的请求首部的值

语法：proxy_set_header FIELD VALUE;

可用的上下文：http, server, location

示例：

proxy_set_header X-Real-IP  $remote_addr;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

3、proxy_cache_path

定义可用于 proxy 功能的缓存

语法：proxy_cache_path path [levels=levels] [use_temp_path=on|off] keys_zone=name:size [inactive=time] [max_size=size] [manager_files=number] [manager_sleep=time] [manager_threshold=time] [loader_files=number] [loader_sleep=time] [loader_threshold=time] [purger=on|off] [purger_files=number] [purger_sleep=time] [purger_threshold=time];

可用上下文：http

示例：

proxy_cache_path /var/cache/nginx/proxy_cache levels=1:1:1 keys_zone=pxycache:20m max_size=1g;

4、proxy_cache

指明要调用的缓存，或关闭缓存机制

语法：proxy_cache ZONE | off;

可用上下文：http, server, location

5、proxy_cache_key

缓存中用于“键”的内容；

语法：proxy_cache_key STRING;

默认值：proxy_cache_key $scheme$proxy_host$request_uri;

可用上下文：http, server, location

6、proxy_cache_valid

定义对特定响应码的响应内容的缓存时长；

语法：proxy_cache_valid [code …] time;

可用上下文：http, server, location

示例：

    定义在 http{…}当中

    proxy_cache_path /var/cache/nginx/proxy_cache levels=1:1:1 keys_zone=pxycache:20m max_size=1g;

    定义在需要调用缓存功能的配置段，例如 server{…}

    proxy_cache pxycache;

proxy_cache_key $request_uri;

proxy_cache_valid 200 302 301 1h;

proxy_cache_valid any 1m;

7、proxy_cache_use_stale

    不确定缓存的响应可以用代理服务器的通信过程中出现错误时，使用该指令的参数匹配的 proxy_next_upstream 指令的参数

语法：proxy_cache_use_stale error | timeout | invalid_header | updating | http_500 | http_502 | http_503 | http_504 | http_403 | http_404 | off …;

可用上下文：http, server, location

8、proxy_cache_methods

    如果客户端请求方法在这个指令中列出，那么响应将被缓存。“获取”和“头”的方法总是添加到列表中，虽然建议明确指定它们。又见 proxy_no_cache 指令。

语法：proxy_cache_methods GET | HEAD | POST …;

可用上下文：http, server, location

9、proxy_hide_header

    隐藏所定义的首部，用户不可见

语法：proxy_hide_header FIELD;

可用上下文：http, server, location

10、proxy_connect_timeout

    定义了用于建立与代理服务器连接超时，这个超时通常不能超过 75 秒。

语法：proxy_connect_timeout time;

可用上下文：http, server, location

11、proxy_buffers

    集数和用于从代理服务器读取响应缓冲区的大小，为一个单一的连接。默认情况下，缓冲区大小等于一个内存页,4K 或 8K

语法：proxy_buffers NUMBER SIZE;

可用上下文：http, server, location 

二、ngx_http_headers_module 模块

    ngx_http_headers_module 模块允许添加“过期”和“缓存控制头字段，和任意的领域，一个响应头。向由代理服务器响应给客户端的响应报文添加自定义首部，或修改指定首部的值；

命令：

1、add_header

    添加自定义首部；

语法：add_header name value [always];

可用上下文：http, server, location, if in location

示例：

    add_header X-Via  $server_addr;

    add_header X-Accel $server_name;

2、expires

    用于定义 Expire 或 Cache-Control 首部的值；

语法：expires [modified] time;

可用上下文：http, server, location, if in location

三、ngx_http_upstream_module 模块 

    ngx_http_upstream_module 模块用于定义服务器可以通过 proxy_pass，fastcgi_pass，uwsgi_pass，scgi_pass 参照组，和 memcached_pass 指令。

命令：

1、upstream

    定义一组服务器。服务器可以在不同的端口上监听。此外，服务器监听 TCP 和 Unix 域套接字可以混合。

语法：upstream name {…}

可用上下文：http

示例：

upstream httpdsrvs {

    server …

    server…

    …

}

2、server

    在 upstream 上下文中 server 成员，以及相关的参数；Context:upstream

语法：server address [parameters];

可用上下文：upstream

address 表示格式：

    unix:/PATH/TO/SOME_SOCK_FILE

    IP[:PORT]

    HOSTNAME[:PORT]

parameters：

   (1) weight=number

        权重，默认为 1；

    (2)max_fails=number

        失败尝试最大次数；超出此处指定的次数时，server 将被标记为不可用；

    (3)fail_timeout=time

        设置将服务器标记为不可用状态的超时时长；

    (4)max_conns

        当前的服务器的最大并发连接数；

    (5)backup

        将服务器标记为“备用”，即所有服务器均不可用时此服务器才启用；

    (6)down

        标记为“不可用”；

3、least_conn;

    最少连接调度算法，当 server 拥有不同的权重时其为 wlc，适用于长连接服务

4、ip_hash;

    源地址 hash 调度方法；

5、hash

    基于指定的 key 的 hash 表来实现对请求的调度，此处的 key 可以直接文本、变量或二者的组合；

    作用：将请求分类，同一类请求将发往同一个 upstream server；

语法：hash key [consistent];

示例：

    hash $request_uri consistent;

    hash $remote_addr;

6、keepalive

    为每个 worker 进程保留的空闲的长连接数量；连接参数设置 KeepAlive 闲置的最大连接数上游服务器保存在每个工作进程缓存。当这个数字被超过时，最近使用的连接被关闭。

四、ngx_stream_core_module 模块

    模拟反代基于 tcp 或 udp 的服务连接，即工作于传输层的反代或调度器；

命令：

1、stream

    定义 stream 相关的服务

可用上下文：main

示例：

stream {

    upstream sshsrvs {

server 192.168.22.2:22; 

server 192.168.22.3:22; 

least_conn;

}

server {

listen 10.1.0.6:22022;

proxy_pass sshsrvs;

}

} 

2、listen

    监听端口

可用上下文：server

语法：listen address:port [ssl] [udp] [proxy_protocol] [backlog=number] [bind] [ipv6only=on|off] [reuseport] [so_keepalive=on|off|[keepidle]:[keepintvl]:[keepcnt]]; 

反代配置实例：

实验目的：

    将用户的请求分别调度至后端 RS 服务器

在两台 RS 服务器上面先配置好 web 服务：

反代服务器配置：

在 http 段中添加以下配置：

server 段中的配置：

测试：

动静分离配置实例：

实验目的：

    将不同的资源分别分发至不同服务器组，以实现动静分离机制

Nginx Reverse 的配置：

在 http 段中添加以下配置：

server 段中的配置：

测试静态资源访问：

访问静态资源

再次访问可调度至 RS2 静态资源服务器

测试动态资源访问：

访问动态资源

再次访问可调度至 RS2 动态资源服务器

测试图片资源访问：

访问图片资源

再次访问可调度至 RS2 图片资源服务器

下面关于 Nginx 的文章您也可能喜欢，不妨参考下：

CentOS 7.2 下编译安装 PHP7.0.10+MySQL5.7.14+Nginx1.10.1  http://www.linuxidc.com/Linux/2016-09/134804.htm

Nginx 实现集群的负载均衡配置过程详解 http://www.linuxidc.com/Linux/2017-02/140549.htm

Nginx 高级应用 – 负载均衡与 rewrite 规则  http://www.linuxidc.com/Linux/2017-02/140476.htm

CentOS 6.4 安装配置 Nginx+Pcre+php-fpm http://www.linuxidc.com/Linux/2013-08/88984.htm

CentOS 6.8 下源码安装 Nginx 1.11.10  http://www.linuxidc.com/Linux/2017-03/141908.htm

CentOS 7 编译安装 Nginx1.10.2 脚本启动失败解决思路 http://www.linuxidc.com/Linux/2017-01/139794.htm

Nginx 简单实现网站的负载均衡  http://www.linuxidc.com/Linux/2017-02/140351.htm

Nginx 的详细介绍：请点这里
Nginx 的下载地址：请点这里

本文永久更新链接地址：http://www.linuxidc.com/Linux/2017-03/142233.htm