主域名重定向到子域名应使用独立server块配合return 301指令,监听80端口、server_name设为shturl.cc,返回https://bbs.shturl.cc$request_uri;路径级跳转需用location ^~ /bbs或if判断;配置后须nginx -t校验、-s reload生效,并用curl验证响应头。

主域名重定向到子域名,比如 shturl.cc → bbs.shturl.cc,关键在于用独立的 server 块监听主域名,并用 return 301 直接跳转,避免 rewrite 规则嵌套或冲突。
用 return 指令做精准跳转(推荐)
这是最稳妥的方式,不走正则、不进 location 匹配,性能好且行为确定:
- 新建一个只监听 80 端口、
server_name设为shturl.cc(不含 www 或其他变体)的 server 块 - 里面只写一行:
return 301 https://bbs.shturl.cc$request_uri; - 如果子域名只支持 HTTPS,就写死
https://;若不确定协议,可用$scheme://,但需确保主站也配了对应协议 -
$request_uri会完整保留路径和查询参数,例如shturl.cc/bbs/user?id=123→bbs.shturl.cc/bbs/user?id=123
路径级跳转:/bbs 开头统一导流
如果只是想把主域名下所有 /bbs/xxx 请求导到子域名,而其他路径仍留在主站,就不能用全局 return,得用 if 或 location:
- 在主域名的 server 块里加判断:
if ($request_uri ~ ^/bbs(/|$)) { return 301 https://bbs.shturl.cc$request_uri; } - 或者更安全地用 location:
location ^~ /bbs { return 301 https://bbs.shturl.cc$request_uri; } - 注意
^~表示前缀匹配优先,比正则快;^~ /bbs能覆盖/bbs和/bbs/xxx,但不会误伤/bbs2
配置后必须验证和 reload
改完别直接 reload,先检查再测试:
- 执行
nginx -t确认语法无误 - 执行
nginx -s reload生效配置 - 用 curl 验证:
curl -I http://shturl.cc/bbs/test,看响应头是否含301 Moved Permanently和正确的Location - 浏览器访问时清缓存——301 会被长期记住,测试阶段可临时换成
return 302验证逻辑
常见踩坑点
容易出问题的地方往往不在写法本身,而在上下文:
- 别把 return 写在 listen 443 ssl 的 server 块里——HTTP 请求根本进不去那个块
- 多个域名共用一个 server_name 时,
$host不可靠,建议硬编码目标域名,如https://bbs.shturl.cc - 如果用了 CDN 或反向代理,且真实请求头带
X-Forwarded-Proto,仅靠 listen 80 可能不够,需额外判断协议 - 宝塔用户务必在「网站 → 设置 → 配置文件」里改,别动
/usr/local/nginx/conf/nginx.conf,否则下次更新会被覆盖











