在 nginx 中,配合 proxy_pass 动态传递 host 的核心做法是:在 server 块中使用 server_name 匹配域名,并在 location 块中设置 proxy_set_header host $host;。这样 nginx 会将客户端请求中的原始 host 头转发给后端服务,确保后端能识别当前访问的域名。

如何配置 server_name 和 proxy_pass 实现基础反向代理
要实现基础的反向代理,需要在 server 块中定义 server_name 以指定该虚拟主机处理的域名,并在 location 块中使用 proxy_pass 指向后端服务器地址。默认情况下,Nginx 不会自动修改 Host 头,因此必须显式使用 proxy_set_header 指令来传递原始的 Host 值。

server {
listen 80;
server_name example.com www.example.com;
location / {
proxy_pass http://backend_server;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
上述配置中,$host 变量代表客户端请求中的 Host 头。当请求到达 Nginx 时,Nginx 会根据 server_name 匹配到对应的 server 块,然后将请求转发给 http://backend_server,同时保留原始的 Host 信息。后端服务可以通过检查 Host 头来判断请求来自哪个域名。
多域名环境下如何动态传递不同的 Host 头
当 Nginx 需要处理多个域名并分别转发到不同的后端服务时,可以为每个域名配置独立的 server 块,或者在一个 server 块中使用 if 或 map 指令来动态设置 Host 头。推荐使用 map 指令来实现更灵活和高效的动态 Host 传递。

map $host $backend_host {
default $host;
api.example.com backend_api;
www.example.com backend_web;
}
server {
listen 80;
server_name example.com www.example.com api.example.com;
location / {
proxy_pass http://$backend_host;
proxy_set_header Host $host;
}
}
在上述配置中,map 指令根据 $host 的值动态设置 $backend_host 变量。例如,当请求的 Host 为 api.example.com 时,$backend_host 会被设置为 backend_api,然后 proxy_pass 将请求转发到 http://backend_api。这种方式允许根据不同的域名动态选择后端服务,同时保持 Host 头的原始值传递给后端。
如果后端服务依赖 Host 头进行路由,如何确保正确传递?
如果后端服务依赖 Host 头进行路由,必须确保 Nginx 正确传递了原始的 Host 头。可以通过在后端服务中打印或记录 Host 头来验证是否正确传递。此外,还需要注意后端服务是否对 Host 头进行了额外的处理或校验。
# 在后端服务中打印 Host 头(以 Python Flask 为例)
from flask import Flask, request
app = Flask(__name__)
@app.route('/')
def index():
host = request.headers.get('Host')
return f'Received Host: {host}'
if __name__ == '__main__':
app.run(host='0.0.0.0', port=5000)
通过上述 Python Flask 示例,可以验证 Nginx 是否正确传递了 Host 头。当请求到达后端服务时,Flask 会读取 Host 头并将其返回给客户端。如果返回的 Host 头与客户端请求中的 Host 一致,则说明 Nginx 配置正确。


















