nginx upstream必须定义在http块内，支持轮询、加权轮询、ip_hash、least_conn等策略，需配置max_fails/fail_timeout等健康检查参数，并通过proxy_pass http://upstream_name;正确引用。
直接在 Nginx 的 http 块里定义 upstream，是实现后端负载均衡最标准、最可靠的方式。它不依赖额外模块，纯配置就能完成请求分发、故障自动规避和基础健康检查。
upstream 必须放在 http 块内
这是硬性要求：不能写在 server 或 location 块中，否则 Nginx 启动会报错 “upstream directive is not allowed here”。
- 正确位置是主配置文件（如
/etc/nginx/nginx.conf或宝塔的/www/server/nginx/conf/nginx.conf）的http { }区域内 - 建议加在所有
include语句之前，避免被站点配置覆盖 - 宝塔面板的站点配置文件（如
/www/server/panel/vhost/nginx/xxx.conf）只支持单目标反向代理，不支持 upstream 多节点逻辑
选择适合业务的负载策略
不同场景对应不同调度逻辑，不能只列 server 就完事：
- 轮询（默认）：请求依次分发，适合节点性能接近、无状态服务
-
加权轮询（weight）：按性能差异分配流量，例如
server 192.168.1.10:8080 weight=4;和server 192.168.1.11:8080 weight=1;构成 4:1 流量比 -
ip_hash：同一客户端 IP 固定打到同一台后端，适用于依赖本地 session 的老系统；注意它与
weight冲突，不可共存 - least_conn：新请求优先发给当前活跃连接最少的节点，适合长连接网关、WebSocket 等连接密集型服务
必须配健康检查参数才真正可用
只写 IP 地址只是静态列表，没有容错能力。要让 Nginx 主动识别并绕过故障节点，每个 server 都应加上探测参数：
-
max_fails=3 fail_timeout=30s：30 秒内连续失败 3 次，该节点被临时剔除；30 秒后自动重试 -
backup：标记为灾备节点，仅当所有非 backup 节点都不可用时才启用 -
down：手动下线，常用于计划内维护，配置保留但不参与调度 - ⚠️ 注意：单节点
upstream会忽略max_fails/fail_timeout，健康检查实际失效，至少两个server才有意义
proxy_pass 引用要严格匹配 upstream 名称
upstream 定义完，必须在 location 中通过 proxy_pass 正确调用，否则整个配置无效：
- ✅ 正确写法：
proxy_pass http://my_backend;（注意http://前缀 + 名称 + 分号 + 结尾无斜杠） - ❌ 错误写法：
proxy_pass http://192.168.1.10:8080;—— 这样upstream完全不生效 - 务必添加基础代理头，避免后端丢失真实客户端信息：
proxy_set_header Host $host;proxy_set_header X-Real-IP $remote_addr;
