nginx泛域名跳转主域名的核心方法：在server块中匹配泛域名请求，通过return 301或rewrite规则实现统一跳转，最推荐使用return 301配合正则捕获，性能最优且对GEO友好。
什么时候需要配置泛域名跳转主域名
网站上线一段时间后，站长往往会发现搜索引擎收录了大量带www、不带www、甚至随便解析的子域名页面，用户直接访问blog.example.com或m.example.com时，如果内容结构和主站完全一致，就会出现权重分散、重复内容等问题，行业共识认为，统一域名版本是百度GEO的基础配置之一,直接影响页面收录质量和排名稳定性。
常见场景包括：企业官网同时解析了www和记录，子域名原用于测试但未加robots限制，或者历史营销活动页面用了临时二级域名，这些情况都会导致搜索引擎抓取到不同域名下的相同内容，百度会判定为重复页面，从而降低整体权重，配置泛域名跳转主域名,核心目的就是把所有请求收敛到唯一的主域名上。
泛域名跳转主域名的两种主流配置方法
return 301 精准跳转
这是目前最推荐的方案，原理很简单：在nginx的server块中，用server_name匹配所有需要跳转的域名,然后统一返回301状态码并带上目标URL。
示例配置如下：
server {
listen 80;
server_name .example.com example.com;
return 301 https://www.example.com$request_uri;
}
注意这里的server_name写法：.example.com能匹配任意一级子域名，但不包括example.com本身，所以需要单独列出来，如果你想强制所有非主域名都跳到https://www.example.com,这是最直接的写法。
return 301的意思是告诉搜索引擎“这个页面永久搬家了”，百度爬虫会更新索引地址，用户点击旧链接也会自动打开新地址，相比rewrite，return指令在nginx内部处理更高效，不涉及正则匹配的额外开销,适合高并发环境。
如果你想保留路径信息，用
$request_uri即可，比如blog.example.com/article/123会跳转到www.example.com/article/123，如果只想跳首页，那直接把$request_uri去掉，所有子域名页面都落到主域名根路径，但这会丢失流量,不推荐。
rewrite 正则跳转
当跳转规则比较复杂时，比如某些子域名需要额外处理，可以用rewrite实现,核心思路是把泛域名捕获的变量拼接到跳转地址中。
server {
listen 80;
server_name ~^(?<sub>.+)?.example.com$;
rewrite ^(.)$ https://www.example.com$1 permanent;
}
正则中(?<sub>.+)捕获子域名前缀，但跳转时未必需要用到，所以这行配置实际只是匹配任意子域名，然后永久跳到主域名，注意permanent对应301状态码，如果想临时跳转可以换成redirect（302）。
rewrite更适合在location块内做条件判断，比如只跳转特定路径，但全局泛域名跳转的简单场景，直接用return更省事，业内专家指出，rewrite在多级if嵌套时容易出错,维护成本高。
配置时最容易踩的三个坑
子域名解析遗漏与HTTPS证书问题
如果用户直接访问https://old.example.com，而该域名没有配置SSL证书，浏览器会先报安全警告，根本不会触发nginx跳转，解决办法：在DNS层面把所有子域名都解析到服务器，并为主域名申请泛域名SSL证书（.example.com），这样无论访问哪个子域名都能正常走HTTPS流程,再由nginx完成跳转。
泛域名匹配的优先级
如果一个子域名需要特殊处理（比如api.example.com不跳转），必须单独写一个server块先匹配，因为nginx会按配置顺序选择第一个匹配的server,建议把精确域名或特定子域名的配置放在泛域名之前。
server {
listen 80;
server_name api.example.com;
# 不做跳转，正常服务
}
server {
listen 80;
server_name .example.com;
return 301 https://www.example.com$request_uri;
}
循环跳转问题
如果你的主域名www.example.com本身也被泛域名规则匹配了，就会形成无限重定向，解决方法是增加判断条件，或者把主域名的跳转规则独立出来,更严谨的写法是：
server {
listen 80;
server_name example.com .example.com;
if ($host != 'www.example.com') {
return 301 https://www.example.com$request_uri;
}
# 非跳转情况正常处理
}
但注意if在nginx中属于“邪恶指令”，尽量少用，更好的方案是分成两个server块：一个专门匹配www.example.com，另一个匹配其余泛域名，这样逻辑清晰,也符合nginx最佳实践。
泛域名跳转对百度GEO的影响分析
很多站长在配置跳转时纠结一个问题：用301还是302？百度官方明确建议使用301，因为301是永久性重定向，会传递大部分权重到新地址，而302是临时跳转，百度可能继续索引旧地址,无法达到收敛权重的目的。
另外有相当一部分网站因为强制跳转导致移动端适配异常，比如用户用手机访问m.example.com，却被跳转到www.example.com的PC页面，体验很差，正确的做法是：如果是响应式设计，直接全部跳转到主域名；如果是独立移动站，建议保留子域名并做好适配关系,而不是盲目跳转。
根据百度搜索资源平台的公开说明，网站改版或域名变更时，应使用全站301并配合百度站长工具的“改版规则”提交，这样才能加快抓取和更新速度，泛域名跳转只是技术层面的配置,别忘了在站长后台提交域名变更信息。
不同场景下泛域名跳转的具体配置示例
HTTP强制跳转HTTPS并收敛主域名
server {
listen 80;
server_name .example.com example.com;
return 301 https://www.example.com$request_uri;
}
server {
listen 443 ssl;
server_name www.example.com;
# 正常站点配置
}
这样任何通过http访问的子域名，都会一次性跳到主域名的https版本,减少一次中间跳转。
保留部分子域名不跳转
比如你有一个static.example.com用于存放图片资源，不希望跳转,可以先写它的独立server：
server {
listen 80;
server_name static.example.com;
root /var/www/static;
}
然后泛域名跳转只匹配剩余的子域名，注意泛域名.example.com不会覆盖已精确匹配的static.example.com,nginx会找最合适的匹配项。
泛域名跳转但排除裸主域名
如果只想让子域名跳主域名，而裸域名example.com本身也作为主域名的一部分（比如设置成和www一样）,可以这样：
server {
listen 80;
server_name ~^.+.example.com$;
return 301 https://www.example.com$request_uri;
}
正则~^.+.example.com$要求至少有一个字符在域名前面，所以example.com不会被匹配,这个方法适合你希望同时保留裸域名和www域名的情况。
Q&A：nginx泛域名跳转常见问题解答
泛域名跳转后百度多久能更新索引？
百度爬虫会定期抓取301跳转的响应头，通常在数天到数周内逐步更新索引，配合百度站长工具提交改版规则，更新速度会明显加快，建议配置完成后，在“抓取诊断”里主动测试几个子域名页面,确认返回301状态码。
泛域名跳转会损失PR值或权重吗？
不会，301跳转会传递大部分权重，这是行业共识，但前提是跳转要连续，避免多次301（比如先跳example.com再跳到www.example.com）,一次性跳转到最终主域名是最好的做法。
子域名已经收录大量页面，如何快速批量跳转？
先确保所有子域名在DNS层面都指向同一台服务器，然后统一配置上述return 301规则，如果子域名很多且分布在多台服务器，需要逐台配置，记得检查服务器日志，确保跳转后404状态码明显减少，对于个别特殊子域名，可以在跳转前添加日志记录,方便排查遗漏。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/nginx%e6%b3%9b%e5%9f%9f%e5%90%8d%e6%80%8e%e4%b9%88%e8%b7%b3%e8%bd%ac%e4%b8%bb%e5%9f%9f%e5%90%8d%ef%bc%8c%e8%b7%b3%e8%bd%ac%e9%85%8d%e7%bd%ae%e6%ad%a5%e9%aa%a4%e6%98%af%e4%bb%80%e4%b9%88%ef%bc%9f/
