Nginx 反向代理与负载均衡配置实战:从入门到生产可用
一、先分清两个概念:正向代理与反向代理
正向代理站在客户端一边,替客户端去访问目标服务器,服务器不知道真正的客户端是谁;反向代理站在服务端一边,替后端服务器接收请求,客户端不知道真正提供服务的是哪台机器。
日常开发里我们接触的 Nginx 绝大多数时候扮演的是反向代理:用户只看到 Nginx 的 80 或 443 端口,后面真实的应用服务、端口和数量都被隐藏起来。这样做至少有三个好处:第一,后端可以随时扩容、替换而不影响入口地址;第二,可以在代理层统一处理负载均衡、限流、缓存和安全策略;第三,出了问题只需要看代理层的日志和指标,排查路径更集中。
二、一个最小可用的反向代理
下面是一份能直接跑起来的最小配置,监听 80 端口,把请求转发到本机的 8080 端口应用:
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
其中三个 proxy_set_header 值得单独说明:默认情况下后端收到请求时 Host 是上游地址,拿不到用户真实的域名;X-Real-IP 把客户端真实 IP 传给后端;X-Forwarded-For 则记录整条转发链路上的 IP,方便后端做日志和限流。如果漏掉这几行,后端看到的客户端 IP 永远是 Nginx 本机的地址,访问日志和风控都会失真。
三、负载均衡:把流量分给多台后端
一台后端扛不住流量时,可以用 upstream 把多台后端组成一个池子:
upstream backend {
server 10.0.0.1:8080 weight=3;
server 10.0.0.2:8080 weight=2;
server 10.0.0.3:8080 weight=1;
}
server {
listen 80;
location / {
proxy_pass http://backend;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
Nginx 提供了几种开箱即用的分配策略:
- 轮询(默认):请求按顺序依次分给每台后端,适合各节点配置相近的场景。
- 加权轮询:通过 weight 给性能更好的机器分配更多请求,上面的例子中三台机器按 3:2:1 的比例分流。
- ip_hash:根据客户端 IP 的哈希值固定分配到同一台后端,适合后端保存了会话状态、又没有做集中式会话存储的过渡方案。
- least_conn:把请求发给当前连接数最少的后端,适合各请求处理耗时差异较大的场景。
选择策略时先看业务特征:无状态服务用轮询或加权轮询就够了;有状态会话优先考虑集中式会话存储,实在不行再用 ip_hash 兜底。
四、健康检查与故障转移
后端挂了还继续把请求发过去,只会让用户看到 502。Nginx 可以用 max_fails 和 fail_timeout 做被动健康检查:
upstream backend {
server 10.0.0.1:8080 max_fails=3 fail_timeout=30s;
server 10.0.0.2:8080 max_fails=3 fail_timeout=30s;
}
含义是 30 秒内连续失败 3 次就把该节点标记为不可用,30 秒后再试一次。配合 proxy_next_upstream,某一台后端返回错误时 Nginx 会自动换一台重试:
location / {
proxy_pass http://backend;
proxy_next_upstream error timeout http_502 http_503;
}
需要注意,被动检查发现故障的前提是已经有真实请求打到了故障节点上;对可用性要求更高的场景,可以用主动健康检查或者在代理前面再加一层探测。
五、动静分离:让 Nginx 直接返回静态资源
图片、样式和脚本这类静态文件没必要每次都打到应用服务上。可以在 Nginx 层直接返回,并顺手加上缓存头:
server {
listen 80;
location /static/ {
alias /var/www/static/;
expires 7d;
add_header Cache-Control "public";
}
location / {
proxy_pass http://backend;
}
}
动静分离之后,应用服务器只需要处理真正的业务请求,整体吞吐量往往能提升一个量级。静态资源更新时记得处理缓存失效,文件名加哈希是最省心的做法。
六、生产环境必须注意的几件事
第一是超时。默认的代理超时在某些场景下偏长,后端 hang 住会拖垮整个入口,建议按接口特征显式设置:
location / {
proxy_pass http://backend;
proxy_connect_timeout 5s;
proxy_send_timeout 60s;
proxy_read_timeout 60s;
}
第二是请求体大小。上传文件时如果后端报 413,多数是 client_max_body_size 限制太小,按需调大:
client_max_body_size 50m;
第三是 WebSocket。代理 WebSocket 应用时必须显式透传 Upgrade 头,否则握手会失败:
location /ws/ {
proxy_pass http://backend;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
第四是改配置的流程。每次修改后先执行 nginx -t 检查语法,通过后再用 nginx -s reload 平滑重载,避免直接重启造成连接中断。
七、常见问题排查
- 502 Bad Gateway:先看后端进程是否存活、端口是否在监听,再看 Nginx 错误日志里 upstream 的具体报错,多数是后端挂了或者连接被防火墙拦截。
- 后端拿不到真实 IP:检查 proxy_set_header 是否配全,链路上有多个代理时还要确认 X-Forwarded-For 的传递没有被某一层截断。
- 静态资源 404:location 与 alias 或 root 的拼接规则容易写错,alias 结尾的斜杠和 location 结尾的斜杠要对应起来。
- 配置改了不生效:确认改的是 Nginx 实际加载的配置文件,执行 reload 后再验证;容器化部署时要确认配置文件已经挂载进容器。
八、总结
反向代理和负载均衡是 Nginx 最常用、性价比最高的两项能力。最小配置十几行就能跑起来,但要做到生产可用,还需要在超时、健康检查、动静分离和日志监控上多下功夫。建议先按本文的顺序把最小配置、upstream、故障转移和静态资源四步走通,再根据业务特点逐步加上限流、缓存和安全策略,这样每一步的风险都是可控的。
- 点赞
- 收藏
- 关注作者
评论(0)