Nginx 学习总结（5） —— 反向代理

这是 Nginx 学习总结的第五篇，上一篇介绍到了 Nginx 学习总结（4）—— Rewrite 模块，这一篇会对 反向代理 相关知识做一些总结。

什么是代理？代理通常用于在多个服务器之间分配负载，无缝地显示来自不同网站的内容，或通过除 HTTP 以外的协议将请求处理传递给应用程序服务器。

代理请求

当 Nginx 代理请求时，它会将请求发送到指定的代理服务器，获取响应并将其发送回客户端。允许将请求代理到 HTTP 服务器（另一个 Nginx 服务器或任何其他服务器），或使用一个特定的协议到非 HTTP 服务器（它可以运行特定框架开发的应用程序，如 PHP 或 Python），支持的协议包括 FastCGI、uwsgi、SCGI 和 memcached。

如果想将一个请求传递（反向代理）给 HTTP 代理服务器，需要在 Location 模块中指定 proxy_pass 指令，例如：

location /some/path/ {
    proxy_pass http://www.example.com;
}

# 发送如下请求
# curl 127.0.0.1:80/some/path/
# 该请求会传递到 www.example.com 服务器中处理

传递地址可以指定为域名或 IP 地址，使用 IP 地址时应当指定一个端口：

location ~ \.php {
    proxy_pass http://127.0.0.1:8080;
}

如果想将一个请求传递（反向代理）给非 HTTP 代理服务器，应当合理选择使用如下指令：

• fastcgi_pass 将请求传递给 FastCGI 服务器；
• uwsgi_pass 将请求传递给 uwsgi_pass 服务器；
• scgi_pass 将请求传递给 SCGI 服务器；
• memcached_pass 将请求传递给 memcached 服务器。

location ~ \.php$ {
    root           /usr/share/nginx/html;
    fastcgi_pass   127.0.0.1:9000;
    fastcgi_index  index.php;
    fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
    include        fastcgi_params;
}

需要注意的是，传递地址后面是否带有 /，转发的 URL 是不同的：

location ^~ /static/ { 
    proxy_pass http://www.test.com; # 传递地址后面不加 "/"，转发地址将包含匹配参数
}
# 发送如下请求
# curl http://localhost/static/index.html
# 转发到 http://www.test.com/static/index.html

location ^~ /static/ { 
    proxy_pass http://www.test.com/; # 传递地址后面带有 "/"，转发地址将不包含匹配参数
}
# 发送如下请求
# curl http://localhost/static/index.html
# 转发到 http://www.test.com/index.html

传递请求头

默认情况下， Nginx 会重新定义请求头：Host 设置为 $proxy_host 变量的值；Connection 设置为 close；其他空字符串的头字段会被移除。通过 proxy_set_header 指令可以改变请求头字段的值。该指令可以在 location 块或更高级的块中指定，比如 server 或 http。我们来看一个传递请求头的应用：

location /some/path/ {
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For  $proxy_add_x_forwarded_for; # 后端的Web服务器可以通过X-Forwarded-For获取用户真实IP
    proxy_set_header Accept-Encoding "";  
    proxy_pass http://localhost:8000;
}

配置缓冲区

默认情况下， Nginx 缓冲来自代理服务器的响应。响应存储在内部缓冲区中，在接收到整个响应之前不会发送给客户端。缓冲有助于优化慢速客户端的性能，因为如果响应是从 Nginx 同步传递到客户端，可能会浪费代理服务器的时间。启用缓冲后，Nginx 允许代理服务器快速处理响应，而 Nginx 在客户端需要下载它们时，将尽可能多的缓存响应内容。

是否启用缓冲使用 proxy_buffering 指令，默认是开启的。proxy_buffers 指令控制分配给请求的缓冲区的大小和数量，来自代理服务器的响应的第一部分存储在一个单独的缓冲区中，其大小由 proxy_buffer_size 指令设置：

location /some/path/ {
    proxy_buffers 16 4k;
    proxy_buffer_size 2k;
    proxy_pass http://localhost:8000;
}

如果缓冲被禁用，则在从代理服务器接收到响应的同时将响应同步发送到客户端。对于需要尽快开始接收响应的快速交互式客户端来说，这种行为可能是需要的：

location /some/path/ {
    proxy_buffering off;
    proxy_pass http://localhost:8000;
}

参考文章：

1. NGINX Reverse Proxy
2. proxy_pass 的小说明
3. Module ngx_http_proxy_module