如何利用Nginx虚拟主机实现基于域名的后端Upstream转发-Nginx-PHP中文网

Nginx通过server块按域名匹配+upstream定义后端集群实现基于域名的反向代理；upstream统一管理负载均衡（weight、健康检查、keepalive），server块用server_name匹配域名并proxy_pass转发，HTTPS需配置证书及协议一致性。

如何利用nginx虚拟主机实现基于域名的后端upstream转发

通过 Nginx 的 server 块匹配域名 + upstream 定义后端集群，即可实现基于域名的反向代理转发。核心在于将不同域名请求路由到对应 upstream，而非硬编码 IP 或端口。

配置 upstream 模块定义后端服务组

在 http 块中统一声明 upstream，便于复用和管理：

upstream api_backend {
    server 192.168.1.10:8080 weight=3;
    server 192.168.1.11:8080 max_fails=2 fail_timeout=30s;
    keepalive 32;
}
<p>upstream web_backend {
server 192.168.1.20:3000;
server 192.168.1.21:3000 backup;
}</p>

weight 控制负载权重，适合性能不均的节点
max_fails / fail_timeout 启用被动健康检查，自动摘除异常节点
keepalive 复用连接，减少后端握手开销（需配合 proxy_http_version 1.1 和 Connection header）

用 server 块按 host 匹配域名并转发

每个 server 块监听 80/443 端口，用 server_name 精确或通配匹配域名：

server {
    listen 80;
    server_name api.example.com;
    location / {
        proxy_pass http://api_backend;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}
<p>server {
listen 80;
server_name www.example.com *.example.com;
location / {
proxy_pass <a href="https://www.php.cn/link/ae77ae50016d01f6c9d504e8194b9615">https://www.php.cn/link/ae77ae50016d01f6c9d504e8194b9615</a>;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}</p>

server_name 支持精确匹配、通配符（*.example.com）、正则（~^www\d+\.example\.com$）
proxy_pass 后不带 URI 路径（如 /api/），否则会截断原始 location 路径
务必设置 Host header，避免后端依赖原始 host 判断租户或路由

HTTPS 场景下补充 SSL 配置

若启用 HTTPS，需在 server 块中加载证书，并保持 proxy_pass 协议与后端一致：

server {
    listen 443 ssl http2;
    server_name api.example.com;
    ssl_certificate /etc/nginx/ssl/api.example.com.pem;
    ssl_certificate_key /etc/nginx/ssl/api.example.com.key;
<pre class="brush:php;toolbar:false;">location / {
    proxy_pass https://api_backend;  # 后端也走 HTTPS 时用 https://
    proxy_ssl_verify off;           # 自签名证书可临时关闭校验（生产慎用）
    proxy_set_header Host $host;
    ...
}

}