如何在宝塔面板安装中配置负载均衡_利用Nginx反向代理-php教程-PHP中文网

宝塔面板实现负载均衡必须手动在nginx.conf的http块内配置upstream，proxy_pass指向其名称且不加斜杠，重载配置而非重启，并补全proxy_set_header和proxy_next_upstream等关键指令。

如何在宝塔面板安装中配置负载均衡_利用nginx反向代理

宝塔面板默认不提供负载均衡功能，仅靠「反向代理」快捷配置页点几下，proxy_pass 指向单个 IP 就完事了——这根本不是负载均衡，只是单点转发。真要分发流量到多台后端，必须手动写 upstream 块，并确保它被 Nginx 主配置加载，否则配置无效。

upstream 必须放在 nginx.conf 的 http 块里

很多人直接在站点配置文件（如 /www/server/panel/vhost/nginx/xxx.conf）的 server 块里加 upstream，Nginx 启动时会报错：nginx: [emerg] "upstream" directive is not allowed here。

正确位置是主配置文件 /www/server/nginx/conf/nginx.conf 中的 http { } 块内，通常插在 include 语句之前或之后：

http {
    upstream my_backend {
        server 192.168.1.10:3000 weight=2;
        server 192.168.1.11:3000 weight=1;
        server 127.0.0.1:8081 backup;
    }

    include /www/server/panel/vhost/nginx/*.conf;
    ...
}

不能塞进任何 server 或 location 块里，Nginx 语法不认
每行 server 结尾不要加 /，否则路径拼接出错，后端收不到完整 URI
如果用 backup 标记备用节点，它只在其他节点全挂时才启用，不参与常规轮询

proxy_pass 必须指向 upstream 名称，且不带结尾斜杠

在站点配置的 location 块中，proxy_pass 要写成 http://my_backend;，而不是 http://192.168.1.10:3000; 或 http://my_backend/;。

结尾斜杠会触发路径重写逻辑：请求 /api/user 会被改成 /user 发给后端，导致 404。

若需保留原始路径前缀（比如只代理 /api/ 下的请求），才用带斜杠的写法：location /api/ { proxy_pass http://my_backend/; }
宝塔「反向代理」界面填目标 URL 时，也必须填 http://my_backend（不加斜杠），否则它自动生成的配置会出错
改完务必点「重载配置」，不是「重启」——重启可能中断连接，重载能平滑生效

必须补全 proxy_set_header，否则后端拿不到真实信息

宝塔自动生成的反向代理规则默认不设 Host 和 X-Real-IP，后端收到的 Host 可能是 my_backend 这种 upstream 名，Remote-Addr 全是 Nginx 本机 IP，日志、限流、CORS、HTTPS 跳转全乱套。

Nginx Reverse Proxy

配置 Nginx 反向代理，实现域名绑定。用户说“绑定域名”“配置 Nginx”“反向代理”时触发，将域名绑定到指定 IP:端口。

下载

在 location 块中 proxy_pass 上方，加上这几行：

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;

$host 不是 $http_host——前者只取域名，后者可能带端口或为空，容易导致后端路由失败
若后端是 Node.js（Express/Koa），需显式设 app.set('trust proxy', true) 才解析 X-Forwarded-For
这些 header 不能重复写，检查宝塔已生成的规则是否已有部分，避免冲突

健康检查不能只靠 max_fails，得配 proxy_next_upstream

免费版 Nginx 没有主动健康检查，max_fails 和 fail_timeout 只对连接拒绝或超时生效，对后端进程崩溃但端口仍监听的情况完全无感——请求照打，用户看到满屏 502 Bad Gateway。

必须在 location 块中加故障转移策略：

proxy_next_upstream error timeout http_500 http_502 http_503 http_504;
proxy_next_upstream_tries 3;
proxy_next_upstream_timeout 3s;

proxy_next_upstream 是关键：遇到指定错误就自动试下一个节点，而不是把错误甩给用户
proxy_next_upstream_tries 限制最多重试几次，避免卡死在某个挂掉的节点上
别信宝塔「启用连接池」选项——那只是开 keepalive 复用 TCP 连接，和故障转移无关

最容易被忽略的是：所有后端节点必须真实可达，且服务监听的是 0.0.0.0:port 而非 127.0.0.1:port；防火墙、安全组、宝塔自带防火墙都得放行对应端口；改完配置后不重载、只保存，upstream 就永远不生效。