nginx中配置upstream权重负载均衡的核心是为每个server设置weight参数，按比例分发请求以适配性能差异；需在http块内定义upstream、proxy_pass必须用http://+名称格式，并建议搭配max_fails和fail_timeout提升容错性。
在 Nginx 中配置 Upstream 的权重分配负载均衡，核心是为每个后端 server 设置 weight 参数，让请求按比例分发到性能不同的机器上。它不是额外开启的策略，而是对默认轮询（WRR）的精细化控制。
在 http 块中定义带权重的 upstream
必须把 upstream 块写在 http{} 内、所有 server{} 外。每行 server 后紧跟 weight=整数，数值越大，分得请求越多：
- 权重只在当前 upstream 组内生效，不跨组比较
- 默认 weight=1，不写即视为 1
- 比如
weight=3和weight=1，实际请求占比约为 75% : 25%
示例：
upstream app_cluster {server 10.0.1.10:8080 weight=3;
server 10.0.1.11:8080 weight=2;
server 10.0.1.12:8080 weight=1;
}
在 server 块中正确引用 upstream
用 proxy_pass 指向 upstream 名称时，必须带 http:// 协议前缀，且不能写具体 IP 或域名：
- ✅ 正确：
proxy_pass http://app_cluster; - ❌ 错误：
proxy_pass http://10.0.1.10:8080;（权重完全失效） - ❌ 错误：
proxy_pass app_cluster;（缺少协议头，Nginx 启动失败）
同时建议加上基础代理头，确保后端能拿到真实客户端信息：
location / {proxy_pass http://app_cluster;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
搭配容错参数提升稳定性
仅设 weight 不足以应对临时故障。每个 server 应同步配置健康检查参数：
-
max_fails=2：连续失败 2 次，标记该节点为不可用 -
fail_timeout=30s：30 秒内不向该节点转发请求；超时后自动重试 - 两个参数必须成对出现，单位只能是秒（如
30s），不能写30ms或30m
增强版示例：
upstream app_cluster {server 10.0.1.10:8080 weight=3 max_fails=2 fail_timeout=30s;
server 10.0.1.11:8080 weight=2 max_fails=2 fail_timeout=30s;
server 10.0.1.12:8080 weight=1 max_fails=2 fail_timeout=30s;
}
验证与生效
改完配置后不能直接重启，需走标准流程：
- 运行
sudo nginx -t检查语法。看到syntax is ok和test is successful才算通过 - 执行
sudo systemctl reload nginx热加载配置（不中断服务） - 观察访问日志确认分发效果：
tail -f /var/log/nginx/access.log | awk '{print $3}' | sort | uniq -c，应大致符合权重比
