在 nginx 中实现多域名自动跳转,核心做法是在 server 块中使用 if ($host) 判断当前请求的域名,并配合 return 301 指令将流量重定向到目标地址。通过为每个域名编写独立的配置段或在一个 server 中利用正则匹配,可以确保访问不同域名的用户被精准引导至对应的服务或协议。

如何根据域名区分不同的跳转目标
当需要处理多个域名且跳转目标不一致时,最稳妥的方式是为每个域名分配独立的 server 块,或者在一个 server 块中通过 server_name 和 if 条件进行分流。Nginx 会优先匹配 server_name,因此我们可以利用这一特性,将不同域名的请求路由到特定的逻辑分支。

server {
listen 80;
server_name example.com www.example.com;
# 如果主机头不是预期的,跳转到主域名
if ($host != 'example.com') {
return 301 http://example.com$request_uri;
}
location / {
proxy_pass http://backend_app;
}
}
server {
listen 80;
server_name api.example.org;
# API 域名直接指向 API 服务,不做额外跳转
location / {
proxy_pass http://api_backend;
}
}
上述配置展示了两个域名的处理逻辑。第一个 server 块处理 example.com 及其子域名,若检测到 $host 不等于主域名,则执行 301 永久重定向。第二个 server 块专门处理 api.example.org,将其直接代理给后端 API 服务。这种结构清晰地将不同域名的流量隔离,避免了复杂的条件判断冲突。
如何实现 HTTP 到 HTTPS 的统一强制跳转
在多域名场景下,通常还需要统一安全策略,即强制所有域名从 HTTP 跳转到 HTTPS。这可以通过在每个 server 块的开头添加一个通用的跳转规则来实现,或者使用 map 指令结合 return 来优化性能。对于大多数场景,直接在监听 80 端口的 server 中判断协议并跳转是最直观的做法。

server {
listen 80;
server_name domain1.com domain2.com;
# 强制跳转到 HTTPS
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
server_name domain1.com domain2.com;
ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;
location / {
proxy_pass http://app_server;
}
}
在这个示例中,监听 80 端口的 server 块捕获了所有未加密的请求。无论用户访问的是 domain1.com 还是 domain2.com,只要协议是 HTTP,Nginx 就会立即返回 301 状态码,并将 $host(当前域名)和 $request_uri(原始请求路径)拼接到新的 HTTPS URL 中。随后的 443 端口 server 块则负责处理实际的 SSL 终止和业务逻辑。这种方式确保了所有域名的安全性一致,且无需为每个域名单独编写跳转逻辑。
当请求头包含非标准端口时跳转行为如何
在实际应用中,有时用户可能会在域名后显式指定端口(如 http://example.com:8080)。此时 $host 变量会包含端口号,导致简单的域名匹配失效。为了正确处理这种情况,需要使用 $server_port 和 $host 的组合判断,或者在跳转时显式重置端口。
server {
listen 80;
server_name example.com;
# 检查是否是非标准端口或非 HTTP 协议
if ($scheme != 'https' || $server_port != 443) {
# 强制跳转到标准 HTTPS 端口
return 301 https://$host$request_uri;
}
location / {
proxy_pass http://backend;
}
}
这段代码增加了对端口号的校验。如果用户访问的是非 443 端口,或者协议不是 HTTPS,Nginx 都会触发跳转。这里的 $host 在跳转时会保留原始域名,但因为是跳转到 HTTPS 默认端口,浏览器会自动省略端口号,从而实现标准化的 URL 规范。这种做法避免了因端口差异导致的循环跳转或证书不匹配错误。











