香港服务器用Nginx做负载均衡,后端健康检查与故障切换怎么配置
在香港入口服务器上部署 Nginx 负载均衡时,后端故障切换主要依赖两部分:一是通过 max_fails 和 fail_timeout 对后端请求失败进行被动健康判断,二是通过 proxy_next_upstream 在当前后端连接失败时把请求转发到其他可用节点。两台后端都正常时可以采用主主分担;其中一台不可用时,Nginx 会暂时避开故障节点。

需要注意,开源版 Nginx 默认没有内置周期性主动探测功能。也就是说,后端没有请求时,Nginx 不会主动访问 /health 或 /ready。如果业务必须在接收用户请求前就发现后端异常,应使用 NGINX Plus 的主动健康检查,或由外部监控系统配合服务摘除机制完成。下面以 Ubuntu 22.04/24.04、三台同区域服务器和开源版 Nginx 为例,完成一次可验证、可回滚的部署。
围绕香港入口、后端应用与数据库分层部署,A5数据提供香港物理服务器资源,覆盖入门建站、Xeon Gold及AMD EPYC等配置,并配备SSD或NVMe存储与不同内存规格,可为Nginx负载均衡架构中的入口节点、应用节点和数据服务提供硬件基础。结合CN2或国际带宽方案,能够适配企业网站、业务后台、接口服务及多任务运行等场景。
一、准备条件
1. 规划服务器角色
示例环境如下,地址仅用于说明配置格式:
| 角色 | 示例地址 | 服务端口 | 用途 |
|---|---|---|---|
| 香港入口服务器 | 10.0.1.10 | 80、443 | 接收客户端请求并转发 |
| 后端节点 A | 10.0.1.11 | 8080 | 主后端 |
| 后端节点 B | 10.0.1.12 | 8080 | 主后端 |
| 后端节点 C | 10.0.1.13 | 8080 | 可选备用后端 |
生产环境优先使用同一云厂商或同一网络内的私有地址。如果后端只能通过公网地址访问,应在云防火墙和服务器防火墙中仅允许香港入口服务器的出口地址访问后端端口,不要直接向公网开放 8080。
本文假设业务域名为 app.example.com,DNS 的 A 记录最终指向香港入口服务器。后端应用已经监听在 0.0.0.0:8080,并提供一个能够反映服务状态的 /ready 接口。
2. 确认系统、端口和后端服务
在入口服务器执行:
cat /etc/os-release
uname -m
ss -lntp
确认系统为 Debian/Ubuntu 系列,并确认 80、443 没有被其他程序占用。随后从入口服务器直接访问后端:
curl -i --max-time 3 http://10.0.1.11:8080/ready
curl -i --max-time 3 http://10.0.1.12:8080/ready
正常情况下应返回类似结果:
HTTP/1.1 200 OK
Content-Type: application/json
{"status":"ready"}
如果 /ready 返回 200,但应用实际无法连接数据库、缓存或关键依赖,Nginx 仍会认为该节点可以接收请求。因此,后端的就绪接口应当检查真正影响请求处理的关键依赖,且检查逻辑不能过重。
3. 确认防火墙范围
入口服务器至少需要允许客户端访问 80 或 443,后端服务器只允许入口服务器访问 8080。以 UFW 为例,规则应根据实际管理地址调整:
sudo ufw status verbose
入口服务器可按需放行:
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
后端服务器应限制来源:
sudo ufw allow from 10.0.1.10 to any port 8080 proto tcp
执行防火墙变更前,确认当前 SSH 会话不会被规则切断,并准备云平台控制台或带外管理入口。不要直接执行会清空现有规则的命令;若规则配置错误,应从云防火墙或控制台恢复原有 SSH 访问规则。
二、安装并备份 Nginx 配置
在香港入口服务器执行:
sudo apt update
sudo apt install -y nginx
sudo nginx -v
sudo systemctl enable --now nginx
sudo systemctl status nginx --no-pager
预期可以看到 Nginx 版本以及:
Active: active (running)
确认默认配置能够通过检查:
sudo nginx -t
预期结果:
syntax is ok
test is successful
首次修改前备份整个配置目录:
BACKUP_DIR="/etc/nginx.backup.$(date +%F-%H%M%S)"
sudo cp -a /etc/nginx "$BACKUP_DIR"
echo "$BACKUP_DIR"
保存命令输出的备份路径,后续回滚时需要使用。配置文件备份完成后,不建议直接覆盖 nginx.conf,优先新增独立的业务配置文件,便于定位和恢复。
三、配置后端池与被动健康检查
1. 创建负载均衡配置
创建配置文件:
sudo nano /etc/nginx/conf.d/hk-app-lb.conf
写入以下内容:
log_format upstream_timing
'$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'request_time=$request_time '
'upstream_addr=$upstream_addr '
'upstream_status=$upstream_status '
'upstream_response_time=$upstream_response_time '
'host=$host';
upstream hk_app_backend {
least_conn;
server 10.0.1.11:8080 weight=1 max_fails=3 fail_timeout=10s;
server 10.0.1.12:8080 weight=1 max_fails=3 fail_timeout=10s;
keepalive 32;
}
server {
listen 80;
listen [::]:80;
server_name app.example.com;
access_log /var/log/nginx/hk_app_access.log upstream_timing;
error_log /var/log/nginx/hk_app_error.log warn;
location = /lb-health {
default_type text/plain;
return 200 "lb ok\n";
}
location / {
proxy_pass http://hk_app_backend;
proxy_http_version 1.1;
proxy_set_header Connection "";
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 X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Host $host;
proxy_set_header X-Forwarded-Port $server_port;
proxy_connect_timeout 2s;
proxy_send_timeout 30s;
proxy_read_timeout 30s;
proxy_next_upstream error timeout invalid_header http_502 http_503 http_504;
proxy_next_upstream_tries 2;
proxy_next_upstream_timeout 5s;
}
}
如果系统的 /etc/nginx/nginx.conf 没有包含 /etc/nginx/conf.d/*.conf,上述文件不会生效。可用以下命令确认完整配置:
sudo nginx -T | grep -n "hk_app_backend"
能够看到 upstream hk_app_backend,说明文件已经被加载。若没有输出,应检查 nginx.conf 中的 include 配置,或将文件放入发行版实际启用的 sites-enabled 目录。
2. 参数作用和故障判定
本例中的关键参数如下:
| 参数 | 示例值 | 作用 |
|---|---|---|
max_fails | 3 | 在一个失败统计周期内,达到该次数后暂时避开节点 |
fail_timeout | 10s | 失败统计窗口,同时也是暂时避开节点的时间 |
proxy_next_upstream | 多种错误 | 当前后端连接失败时允许换下一个后端 |
proxy_next_upstream_tries | 2 | 一次请求最多尝试两个后端 |
proxy_next_upstream_timeout | 5s | 一次请求用于后端切换的总时间上限 |
least_conn | 无参数 | 优先选择当前连接数较少的后端 |
keepalive | 32 | Nginx 到后端保持的空闲连接数量 |
max_fails=3 fail_timeout=10s 并不表示后端每 10 秒都会被主动探测。它的含义是:在实际请求发生时,如果同一后端连续出现连接错误、超时或无效响应,达到失败条件后,Nginx 会暂时停止向该节点分配请求;经过 fail_timeout 后再尝试恢复。
proxy_next_upstream 负责一次请求内的切换。例如后端 A 连接超时,Nginx 可以在限定时间内改向后端 B。这里没有加入 http_500,是为了避免把应用自身的业务异常误判为节点故障。若确实要对 500 自动重试,只应针对幂等请求,并评估请求是否可能被后端执行后才断开连接。
特别是支付、下单、写入数据库等 POST 请求,不建议无条件增加:
proxy_next_upstream ... non_idempotent;
因为请求可能已经在后端执行成功,只是响应返回前连接中断,重试可能造成重复提交。
3. 配置可选备用节点
如果有第三台服务器,希望只有当 A、B 两个主后端都不可用时才使用 C,可以在 upstream 中增加:
upstream hk_app_backend {
least_conn;
server 10.0.1.11:8080 weight=1 max_fails=3 fail_timeout=10s;
server 10.0.1.12:8080 weight=1 max_fails=3 fail_timeout=10s;
server 10.0.1.13:8080 backup max_fails=2 fail_timeout=15s;
keepalive 32;
}
backup 节点不是常规流量节点。只有非 backup 节点都不可用时,它才会接收请求。备用节点的应用版本、环境变量、数据库权限和静态资源必须与主节点兼容,否则虽然网络层切换成功,业务仍可能返回错误。
四、启用 HTTPS 入口
如果客户端通过 HTTPS 访问,应先准备与 app.example.com 匹配的证书和私钥。证书文件例如:
/etc/nginx/tls/app.example.com.crt
/etc/nginx/tls/app.example.com.key
私钥只允许 Nginx 进程读取,并在修改权限前确认文件路径和归属正确:
sudo chown root:root /etc/nginx/tls/app.example.com.key
sudo chmod 600 /etc/nginx/tls/app.example.com.key
只有证书文件已经存在时,才添加 443 配置:
server {
listen 443 ssl http2;
listen [::]:443 ssl http2;
server_name app.example.com;
ssl_certificate /etc/nginx/tls/app.example.com.crt;
ssl_certificate_key /etc/nginx/tls/app.example.com.key;
access_log /var/log/nginx/hk_app_access.log upstream_timing;
error_log /var/log/nginx/hk_app_error.log warn;
location = /lb-health {
default_type text/plain;
return 200 "lb ok\n";
}
location / {
proxy_pass http://hk_app_backend;
proxy_http_version 1.1;
proxy_set_header Connection "";
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 X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Host $host;
proxy_set_header X-Forwarded-Port $server_port;
proxy_connect_timeout 2s;
proxy_send_timeout 30s;
proxy_read_timeout 30s;
proxy_next_upstream error timeout invalid_header http_502 http_503 http_504;
proxy_next_upstream_tries 2;
proxy_next_upstream_timeout 5s;
}
}
如果需要把 HTTP 重定向到 HTTPS,可将原来的 80 端口业务配置改为:
server {
listen 80;
listen [::]:80;
server_name app.example.com;
return 301 https://$host$request_uri;
}
证书即将到期时,应先替换证书文件,再执行配置检查和优雅重载。证书路径错误会导致 nginx -t 失败,不能在检查失败时执行 reload。
五、检查配置并启动转发
修改完成后先检查语法:
sudo nginx -t
只有看到以下结果才继续:
syntax is ok
test is successful
然后使用平滑重载:
sudo systemctl reload nginx
sudo systemctl is-active nginx
预期输出:
active
配置变更通常使用 reload,不要在没有必要时执行 restart。reload 会让新配置接收新请求,旧 worker 在处理完已有连接后退出,能够减少配置发布对现有请求的影响。
六、逐项验证负载均衡和故障切换
1. 验证入口服务器自身
从客户端或入口服务器访问:
curl -i --max-time 5 -H 'Host: app.example.com' http://127.0.0.1/lb-health
预期返回:
HTTP/1.1 200 OK
lb ok
这个接口只能证明 Nginx 入口进程正在工作,不能证明后端应用可用。
2. 验证后端转发
从入口服务器执行:
curl -i --max-time 5 -H 'Host: app.example.com' http://127.0.0.1/
如果业务域名已经解析到入口服务器,也可以从外部客户端执行:
curl -i --max-time 5 https://app.example.com/
同时查看访问日志:
sudo tail -f /var/log/nginx/hk_app_access.log
示例日志可能类似:
request_time=0.024 upstream_addr=10.0.1.11:8080 upstream_status=200 upstream_response_time=0.023
下一次请求也可能显示:
request_time=0.031 upstream_addr=10.0.1.12:8080 upstream_status=200 upstream_response_time=0.030
日志中的 upstream_addr 可以确认请求实际去了哪个后端;如果一次请求先后尝试了多个节点,字段中可能出现多个地址。
3. 执行单节点故障测试
故障测试应在业务低峰期进行,并提前确认后端服务名称。以停止后端 A 的应用服务为例:
sudo systemctl stop myapp
myapp 只是示例服务名,不能直接假定所有系统都使用这个名称。停止前要确认影响范围仅为后端 A,并记录当前服务状态。
从客户端连续发起新请求:

for i in $(seq 1 10); do
curl -sS -o /dev/null \
-w "status=%{http_code} time=%{time_total}\n" \
--max-time 8 \
-H 'Host: app.example.com' \
http://入口服务器地址/
sleep 1
done
预期结果是大多数请求仍返回 200,访问日志中的 upstream_addr 逐步只出现后端 B。因为配置设置了失败次数阈值,故障节点在最初几次请求中可能先被尝试,再由 proxy_next_upstream 切换到 B。
恢复后端 A:
sudo systemctl start myapp
sudo systemctl status myapp --no-pager
等待超过 fail_timeout,再检查后端 A 的直接访问:
curl -i --max-time 3 http://10.0.1.11:8080/ready
返回 200 后,再通过入口访问业务。后端恢复并不代表所有历史连接立即重新分配,新的请求会根据连接数和失败状态逐步使用恢复节点。
4. 验证全节点不可用时的结果
在确认不会影响真实业务的测试环境中,暂时停止所有后端服务。入口请求通常会返回 502 或 504,具体取决于连接建立和超时发生的位置。此时错误日志可能出现:
connect() failed (111: Connection refused) while connecting to upstream
upstream timed out while connecting to upstream
这个结果说明 Nginx 没有伪造成功响应,也没有无限重试。恢复至少一个后端后,重新执行入口请求,服务应在失败节点状态重新评估后恢复。
七、开源版 Nginx 的健康检查边界
两种健康检查方式的差异如下:
| 检查方式 | 开源版 Nginx | 触发方式 | 适合场景 | 主要限制 |
|---|---|---|---|---|
| 被动检查 | 支持 | 真实请求失败后统计 | 普通 Web、API 服务 | 无流量时不会主动发现故障 |
| 主动检查 | 默认不支持 | 按间隔访问健康接口 | 需要提前摘除异常节点的业务 | 通常需要 NGINX Plus 或外部协调机制 |
如果需要主动检查,可在 NGINX Plus 中使用类似配置:
upstream hk_app_backend {
zone hk_app_backend 64k;
server 10.0.1.11:8080;
server 10.0.1.12:8080;
}
server {
listen 443 ssl http2;
server_name app.example.com;
location / {
health_check uri=/ready interval=5s fails=3 passes=2;
proxy_pass http://hk_app_backend;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
health_check 是 NGINX Plus 的配置能力,不能直接复制到普通开源版 Nginx,否则会在 nginx -t 时出现未知指令错误。对于开源版,如果使用外部检测脚本,脚本还必须能够安全地更新上游状态并触发配置重载;仅仅定时执行 curl /ready,并不会自动让 Nginx 停止使用故障节点。
八、常见异常处理
1. nginx -t 提示 unknown directive
先查看版本和完整配置:
nginx -v
sudo nginx -T
如果错误指向 health_check,通常是把 NGINX Plus 配置放到了开源版 Nginx。应删除该指令,改用本文的被动检查配置,或使用适配当前版本的主动检查方案。
2. 入口返回 502 或 504
按由外到内的顺序检查:

sudo systemctl status nginx --no-pager
sudo ss -lntp | grep ':80\|:443'
curl -i --max-time 3 http://10.0.1.11:8080/ready
curl -i --max-time 3 http://10.0.1.12:8080/ready
sudo tail -n 100 /var/log/nginx/hk_app_error.log
判断方式如下:
- 后端直接访问也失败:检查后端服务、监听地址、应用日志和后端防火墙。
- 后端直接访问成功,但入口访问失败:检查入口到后端的网络策略、路由和端口。
- 入口和后端都正常,但只有部分 URL 失败:检查应用路径、请求头、超时配置和业务依赖。
- 所有请求都转到同一节点:检查另一节点是否被标记为失败、
upstream地址是否写错,以及访问日志中的upstream_addr。
3. 后端返回 500,但没有切换
这是本例的预期行为。500 通常代表应用已经收到请求并产生业务错误,不一定说明节点已经失效。若强制对 500 重试,必须确认请求幂等、不会重复写入,并单独评估 proxy_next_upstream http_500 的风险。
4. 切换后登录状态或购物车丢失
Nginx 只负责转发,不会自动同步后端内存中的 Session。多后端部署时,应将 Session、任务状态和必要缓存放到共享存储,或在应用层实现可恢复机制。临时使用 ip_hash 可以提高同一客户端命中同一节点的概率,但会受到 NAT、移动网络和节点故障的影响,不能替代共享状态设计。
九、回滚操作
如果 nginx -t 失败,不要执行 reload,直接修正配置即可。若新配置已经加载且出现异常,可恢复之前的备份。
先确认备份目录:
ls -ld /etc/nginx.backup.*
假设需要恢复的目录为:
/etc/nginx.backup.2025-01-01-120000
恢复前再次确认当前服务和影响范围,然后执行:
sudo cp -a /etc/nginx.backup.2025-01-01-120000/nginx.conf /etc/nginx/nginx.conf
sudo rm -f /etc/nginx/conf.d/hk-app-lb.conf
sudo nginx -t
sudo systemctl reload nginx
如果备份中还包含原有的业务配置,应按实际文件逐个恢复,不要为了回滚直接删除整个 /etc/nginx 目录。删除配置会影响其他虚拟主机、证书和日志设置。
如果只是本次新增文件导致问题,也可以保留备份文件,先禁用该配置:
sudo mv /etc/nginx/conf.d/hk-app-lb.conf \
/etc/nginx/conf.d/hk-app-lb.conf.disabled
sudo nginx -t
sudo systemctl reload nginx
回滚后检查:
curl -i --max-time 5 -H 'Host: app.example.com' http://127.0.0.1/lb-health
sudo systemctl is-active nginx
sudo tail -n 50 /var/log/nginx/error.log
验收与回滚检查项
上线前逐项确认:
- [ ] 入口服务器可以直接访问每台后端的
/ready。 - [ ] 后端
8080只允许入口服务器访问。 - [ ]
nginx -t返回syntax is ok和test is successful。 - [ ] 入口服务器的 80/443 端口可访问,域名解析指向正确地址。
- [ ] 访问日志能够记录
upstream_addr、upstream_status和响应时间。 - [ ] 单独停止后端 A 后,入口请求可以切换到后端 B。
- [ ] 恢复后端 A,并确认它在失败窗口结束后重新接收请求。
- [ ] 明确 POST、支付、下单等非幂等请求不会被无条件重复发送。
- [ ] 若启用 HTTPS,证书、私钥路径和续期流程均已验证。
- [ ] 已记录 Nginx 配置备份目录和回滚命令。
- [ ] 已确认入口服务器本身不是未处理的单点故障;后端切换不能替代入口层高可用。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5698.html



