Nginx 中配置后端心跳感知集群节点的存活状态-Nginx-PHP中文网

nginx 不支持集群节点间心跳同步，仅能主动探测后端服务健康状态；需通过主动检查模块、语义化健康接口、状态暴露与真实流量反馈四层机制实现可靠感知。

nginx 中配置后端心跳感知集群节点的存活状态

Nginx 本身不自带“集群节点间心跳同步”能力，它无法让多个 Nginx 实例互相感知、共享状态或自动协调。所谓“后端心跳感知”，实际是指 Nginx 主动探测其 upstream 中的业务后端（如 Java 应用、Node.js 服务等）是否存活且可用，而非 Nginx 节点之间的心跳。要实现可靠的状态感知，需分层配置：主动探测 + 语义判断 + 状态暴露 + 动态响应。

一、启用主动健康检查，避免被动等待失败
Nginx 原生 max_fails/fail_timeout 是被动机制——得先发请求、失败5次才下线，会浪费流量和延迟。推荐使用 nginx_upstream_check_module（Tengine 内置，或为 Nginx 手动编译集成）做主动探测：

在 upstream 块中添加 check 指令，例如：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

upstream backend_api {
    server 10.0.1.10:8080;
    server 10.0.1.11:8080;
    check interval=3 rise=2 fall=3 timeout=1 type=http;
    check_http_send "GET /health HTTP/1.1\r\nHost: api.example.com\r\nConnection: close\r\n\r\n";
    check_http_expect_alive http_2xx;
    default_down on;  # 启动时默认标记为 down，等探测通过再上线
}

关键参数说明：
- interval=3：每3秒探测一次
- rise=2：连续2次成功才标记为 up，防抖动
- fall=3：连续3次失败才标记为 down，防误判
- timeout=1：单次探测超时设为1秒，避免阻塞
- check_http_expect_alive http_2xx：只认 2xx 响应为健康，明确拒绝 503/404 等“假活”状态

二、让探测结果反映真实业务能力
仅看 HTTP 状态码远远不够。后端 /health 接口应返回结构化 JSON，并检查关键字段：

示例响应：

{ "status": "UP", "db": "UP", "diskFree": 1258291200 }

若使用 OpenResty，可用 lua-resty-http + cjson 在 log_by_lua_block 中解析响应体，提取 status 或 db 字段；
避免探测路径被 WAF 拦截——将 /health 加入白名单，或改用 type=tcp 作为兜底（只验端口连通性）；
不要用 HEAD 请求替代 GET，某些框架的健康端点对方法敏感，HEAD 可能绕过实际检查逻辑。

三、暴露可读、可采、可联动的状态视图
探测结果必须能被运维查看、监控系统采集、告警平台触发：

添加状态页 location：

location /status {
    check_status json;  # 输出 JSON 格式，含 IP、状态、失败次数、最后响应时间等
    allow 192.168.10.0/24;  # 限制内网访问
    deny all;
}

对接 Prometheus：用 nginx-module-vts 或自定义 Lua exporter 抓取 upstream 指标，如 upstream_response_time、upstream_status 分布；
设置告警规则，例如：“单节点 5 分钟内 5xx 错误率 >5%” 或 “节点连续 3 次探测返回 DOWN”；
日志中记录 $upstream_addr $upstream_response_time $upstream_status，便于事后定位拐点。

四、结合真实流量反馈，补全被动观测维度
主动探测再勤快，也覆盖不了所有接口路径和并发压力场景。真实请求是最终验证：

开启容错重试：

proxy_next_upstream error timeout http_502 http_503 http_504;
proxy_next_upstream_tries 3;

在 log_format 中打标节点级表现，例如：

log_format detailed '$remote_addr - $upstream_addr [$time_local] '
                     '"$request" $status $body_bytes_sent '
                     '$upstream_response_time $upstream_status';

若用 OpenResty，可在 log_by_lua_block 中统计各节点的 P95 延迟、5xx 比率，写入 shared_dict，供 balancer_by_lua_block 动态降权或跳过。

不复杂但容易忽略。