单个 server 块可绑定多个域名实现共用后端:server_name 用空格分隔各域名,需 dns 解析至 nginx ip;proxy_pass 指向统一 upstream,透传 host 头;差异化处理用 map 和 if(仅限 header/log/return);https 必须使用覆盖所有域名的 san 证书。

用一个 server 块让多个域名共用同一套后端服务,关键在于“入口收敛 + 域名识别 + 统一转发”,不需要为每个域名重复写配置。
单个 server 块绑定多个域名
在 server_name 后用空格并列所有目标域名,Nginx 会将 Host 头匹配其中任一的请求都路由进来:
- 写法必须是空格分隔,例如:
server_name a.example.com b.example.com api.test.org; - 逗号、引号、换行都会导致语法错误,Nginx 不识别
- DNS 需把所有这些域名解析到这台 Nginx 的 IP,否则请求进不来
- 如果只配了这一个
server块,即使server_name写得不全,未匹配的请求也会默认落到它身上(除非有其他default_server)
统一转发,透传原始信息
所有域名共用同一后端地址,proxy_pass 直接写死,不随域名变化:
- 推荐指向已定义的
upstream,比如:proxy_pass http://backend_cluster; - 加上
proxy_set_header Host $host;,让后端能拿到用户实际访问的域名 - 路径重写、额外 Header(如
X-Service-Name)也只需配置一次,全局生效
按需做轻量级差异化处理
后端相同,但不同域名可能需要不同日志、响应头或跳转逻辑,可用变量和简单指令实现:
- 用
map提前定义标识变量,例如:map $host $is_api { api.test.org 1; default 0; },再配合access_log ... if=$is_api; - 对特定域名加响应头:
if ($host = "b.example.com") { add_header X-Env "staging"; } - 注意:避免在
if中使用proxy_pass,易出错;差异化尽量控制在 header、log、return 等轻量操作
HTTPS 场景必须用 SAN 证书
所有域名都要能通过 TLS 层验证,否则浏览器直接报证书错误:
- 证书必须包含
server_name中列出的全部域名(即多域名 SAN 证书) -
listen 443 ssl;必须带ssl参数,否则 SNI 不生效 - 客户端需支持 SNI(现代浏览器和工具都支持,老系统需确认)
- 证书问题与 Nginx 配置无关——只要域名不在 SAN 列表里,哪怕配置完全正确,也会被拦截











