proxy_pass 本身不提供健康监测，必须配合 upstream 块及 max_fails、fail_timeout、proxy_next_upstream 等指令协同工作才能实现被动健康检查；直连 IP 则无法启用该机制。
proxy_pass 本身不直接提供健康监测功能，它只是将请求转发给后端服务。真正的健康监测依赖于 upstream 块配合其他指令共同实现。单纯在 location 中写 proxy_pass http://backend;，没有 upstream 定义和配套配置，是无法触发任何健康检查的。
关键点在于：健康监测不是 proxy_pass 的能力，而是整个反向代理链路中 upstream + proxy 指令协同工作的结果。
proxy_pass 必须指向一个 upstream 名称才能启用健康检查
只有当 proxy_pass 后跟的是 upstream 块定义的名称（如 http://backend），后续在 upstream 或 location 中配置的健康检查机制才生效：
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;
}
server {
location / {
proxy_pass http://backend; # ← 必须这样引用 upstream 才能联动健康策略
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}如果写成 proxy_pass http://10.0.0.1:8080;（直连 IP），Nginx 就不会应用 upstream 级别的失败计数、自动剔除等逻辑，也就谈不上健康监测。
健康监测靠三类机制协同工作
Nginx 实现后端健康监测主要靠以下组合，缺一不可：
安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。
-
被动检查（默认启用）
依靠proxy_next_upstream和超时类指令，在真实请求过程中识别异常：-
proxy_connect_timeout：建连超时（如后端宕机，连不上） -
proxy_read_timeout：读响应超时（如后端卡死，不返回） -
proxy_next_upstream error timeout http_502 http_503 http_504：指定哪些错误码或状况下重试下一节点
-
-
主动检查（需显式配置）
需要upstream块 +health_check指令（仅 Nginx Plus 或开源版搭配第三方模块如nginx_upstream_check_module）：upstream backend { server 10.0.0.1:8080; server 10.0.0.2:8080; # 开源版需额外编译模块才支持此语法 # health_check interval=5s fails=2 passes=2 uri=/health; } -
服务器级容错参数（upstream 内配置）
控制单个节点被标记为“不可用”的条件：-
max_fails=3：连续失败 3 次即标记为 down -
fail_timeout=30s：标记为 down 后，30 秒内不再发请求；之后尝试恢复
-
常见误区与注意事项
proxy_pass路径结尾带斜杠/会影响后端路径拼接，但不影响健康检查逻辑
✅proxy_pass http://backend;（推荐，路径由 location 决定）
❌proxy_pass http://backend/;（会剥离 location 路径，易导致后端收不到完整 URI）proxy_set_header Host $host和X-Forwarded-For不参与健康检查，但影响后端日志和路由判断，建议始终配置开源 Nginx 默认不支持
health_check指令（那是 Nginx Plus 商业版特性），如需主动探测，得自行编译nginx_upstream_check_module模块并使用其check指令健康状态只在有流量时更新（被动检查）或按固定周期发起（主动检查），空闲节点不会持续探测
简单可用的最小健康感知配置（开源版）
upstream myapp {
server 192.168.1.10:3000 max_fails=2 fail_timeout=15s;
server 192.168.1.11:3000 max_fails=2 fail_timeout=15s;
}
server {
location / {
proxy_pass http://myapp;
proxy_connect_timeout 5s;
proxy_send_timeout 10s;
proxy_read_timeout 10s;
proxy_next_upstream error timeout http_502 http_503 http_504;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}这个配置能在任意后端返回 502/503/504 或连接/读取超时时，自动将本次请求转给另一台服务器，并在连续失败 2 次后暂时屏蔽故障节点 15 秒。
不复杂但容易忽略。
