Nginx配置upstream含路径时报invalid host in upstream错误的解决办法

安全阿岳

2026-8-7

Nginx负载均衡带路径配置的错误修复方案

错误原因

你遇到的"invalid host in upstream"错误，是因为Nginx的upstream模块中，server指令只能指定后端的主机（域名/IP）和端口，不能直接附带URI路径——你原来的配置把/path1这类路径写在server地址后面，违反了语法规则。

可行配置方案

方案一：结合upstream + map模块（支持负载均衡策略）

这种方式保留upstream的负载均衡能力（比如权重、健康检查），用map模块绑定主机对应的路径：

先定义仅包含主机的upstream：

upstream backend_hosts {
    server domain1.com;
    server domain2.com weight=2; # 可添加权重、端口等配置
    server domain3.com max_fails=3 fail_timeout=30s;
}

用map模块匹配每个后端主机对应的路径：

map $upstream_addr $backend_path {
    domain1.com:443 /path1;
    domain2.com:443 /path/path2;
    domain3.com:443 /path3; # 注意修正原配置中的拼写错误pah3
}

在location中拼接主机和路径：

location / {
    proxy_pass https://backend_hosts$backend_path;
    proxy_ssl_trusted_certificate /etc/nginx/sslcerts/backend.server.pem;
    proxy_ssl_verify off;
    # 传递正确的Host头给后端服务器
    proxy_set_header Host $upstream_addr;
}

方案二：用split_clients直接分配到带路径的后端（适合简单比例分配）

如果不需要复杂的负载均衡策略，可直接用split_clients按比例把流量分发到完整的带路径后端地址：

split_clients $request_uri $backend_dest {
    33% https://domain1.com/path1;
    33% https://domain2.com/path/path2;
    * https://domain3.com/path3;
}

location / {
    proxy_pass $backend_dest;
    proxy_ssl_trusted_certificate /etc/nginx/sslcerts/backend.server.pem;
    proxy_ssl_verify off;
}