nginx怎么设置才能让所有泛域名都301跳转主域名？

在Web服务器管理中,将所有未明确配置的子域名（泛域名）统一跳转到主域名是一项常见且重要的需求，这不仅有助于品牌形象的统一，还能有效整合SEO权重，防止分散，并提升网站的安全性，Nginx作为高性能的Web服务器，提供了极其灵活和高效的方式来实现这一功能，本文将详细介绍如何配置Nginx实现泛域名跳转主域名，并探讨其背后的原理与最佳实践。

核心原理：Nginx Server_Name 指令

要实现泛域名跳转,首先需要理解Nginx的server_name指令，该指令用于指定虚拟主机的域名，Nginx通过它来匹配请求头中的Host字段，从而决定使用哪个server块来处理请求。

server_name指令支持多种匹配方式，其中最关键的就是通配符匹配，我们可以使用星号（）作为通配符来匹配一系列子域名。*.example.com可以匹配blog.example.com、shop.example.com等任何以.example.com结尾的域名，但不能匹配example.com本身。

为了捕获所有指向该服务器IP但未被其他server块明确处理的请求，包括各种子域名，我们可以使用一个特殊的“捕获所有”名称：下划线（_）。server_name _;是一个无效的名称，它永远不会与任何真实的Host头匹配，因此它被用作一个默认的“兜底”选项，通常与default_server参数配合使用。

配置步骤详解

实现泛域名跳转的推荐做法是创建一个独立的、专门用于重定向的server块，并将其置于主站点配置之前，这样可以确保逻辑清晰，避免与主站点的配置产生冲突。

创建重定向配置文件

在Nginx的配置目录下（如/etc/nginx/conf.d/），创建一个新的配置文件，例如wildcard-redirect.conf，将重定向逻辑独立存放，便于管理。

编写重定向规则

在wildcard-redirect.conf文件中，添加以下内容，这里以将所有HTTP和HTTPS的泛域名请求跳转到https://www.example.com为例。

server {
    listen 80;
    listen 443 ssl;
    # 使用下划线捕获所有未被其他server块匹配的Host
    server_name _.example.com;
    # 如果需要处理HTTPS的泛域名请求，必须配置通配符SSL证书
    # ssl_certificate /path/to/your/wildcard.crt;
    # ssl_certificate_key /path/to/your/wildcard.key;
    # ssl_protocols TLSv1.2 TLSv1.3;
    # ssl_ciphers '...';
    # 执行301永久重定向
    # $scheme 自动获取原始请求的协议（http或https）
    # $request_uri 保留请求的路径和参数，保证用户体验
    return 301 $scheme://www.example.com$request_uri;
}

理解关键指令

上方的配置涉及几个核心指令,下表对其进行了解释：

使用return 301指令比rewrite指令效率更高，语法也更简洁，是现代Nginx配置中实现重定向的首选。

完整示例与最佳实践

假设你的主站点配置在/etc/nginx/conf.d/main-site.conf中，其server_name为www.example.com和example.com，你的配置文件结构应该如下：

1. /etc/nginx/conf.d/wildcard-redirect.conf (用于泛域名跳转)

   server {
       listen 80;
       listen 443 ssl;
       server_name _.example.com;
       # ... SSL证书配置 ...
       return 301 $scheme://www.example.com$request_uri;
   }

2. /etc/nginx/conf.d/main-site.conf (主站点)

   server {
       listen 80;
       listen 443 ssl;
       server_name example.com www.example.com;
       # ... SSL证书配置 ...
       # ... 网站根目录、PHP处理等配置 ...
   }

关于HTTPS的特别说明：如果要对HTTPS的泛域名请求进行重定向，Nginx在建立SSL连接时就需要证书，你必须为*.example.com申请一张通配符SSL证书，并在重定向的server块中正确配置它，否则，用户访问https://abc.example.com时会遇到证书错误，重定向无法正常进行。

配置完成后,使用nginx -t命令测试配置文件语法是否正确，确认无误后，执行nginx -s reload或systemctl reload nginx使配置生效。

相关问答FAQs

Q1: 301重定向和302重定向有什么区别？在泛域名跳转中应该使用哪一个？

A: 301和302都是HTTP重定向状态码，但它们的含义完全不同。

• 301 (Moved Permanently)：表示请求的资源已经“永久”地移动到了新的URL，搜索引擎（如Google）看到301状态码后，会认为原URL已失效，并将大部分“权重”和“链接价值”传递给新的目标URL，这对于SEO至关重要。
• 302 (Found / Moved Temporarily)：表示请求的资源“临时”地移动到了新的URL，搜索引擎会认为这只是暂时性的跳转，会继续索引和保留原URL的权重。

在泛域名跳转主域名的场景中,我们的目标是永久性地整合所有流量到主域名，因此必须使用301重定向，这能确保所有子域名的SEO价值都集中到主域名上，避免权重分散。

Q2: 我已经按照配置操作，但泛域名跳转没有生效，可能是什么原因？

A: 如果重定向不生效，可以从以下几个方面进行排查：

1. Nginx配置错误：首先使用nginx -t命令检查Nginx配置文件是否存在语法错误，如果有错误，Nginx会拒绝重载配置。
2. 未重载Nginx：修改配置文件后，必须执行重载命令（如systemctl reload nginx）才能让新配置生效，仅仅保存文件是不够的。
3. DNS解析问题：确保你测试的泛域名（如test.example.com）已经正确解析到了你的Nginx服务器的IP地址，可以使用ping或dig命令来验证。
4. 浏览器缓存：浏览器可能会缓存之前的重定向结果或DNS记录，尝试清除浏览器缓存、开启无痕模式访问，或者使用curl -I命令行工具直接测试，以排除缓存干扰。
5. HTTPS证书问题：如果你在测试HTTPS的泛域名，请确认已在重定向的server块中正确配置了有效的通配符SSL证书，证书错误会导致连接在Nginx处理重定向规则之前就失败了。