宝塔设置域名301重定向教程

宝塔免费版虽不提供图形化301重定向功能，但完全可通过手动编辑Nginx配置文件精准实现——只需在server块顶层添加一行return 301指令（务必携带$request_uri），避开易出错的rewrite和反向代理，再通过curl -I严格验证响应头，即可安全、高效、跨版本地完成域名规范化跳转，尤其适用于HTTPS站点和CDN环境，真正把控制权握在自己手中。

宝塔面板里找不到“301重定向”入口？先确认你用的是企业版

免费版宝塔面板不提供图形化「301重定向」功能，点网站设置里的「重定向」选项卡是灰色的。这不是你操作错了，是权限限制。企业版才开放该功能，但其实——不用升级也能做，而且更可控。

用 Nginx 配置文件手动加 rewrite 规则（推荐）

直接改站点配置最稳定，不受面板版本限制，还能精确控制匹配逻辑和返回状态码。关键点在于：必须用 return 301，不能用 rewrite（后者默认是 302），且要放在 server 块顶层，避免被 location 覆盖。

• 进入宝塔 → 网站 → 找到目标站点 → 「设置」→ 「配置文件」
• 在第一个 server 块（监听 80 端口那个）里，紧贴 server { 开头下方加入：

if ($host = 'www.example.com') {
    return 301 https://example.com$request_uri;
}

把 www.example.com 和 example.com 换成你的实际域名。注意：$request_uri 必须带上，否则路径参数会丢失。

• 如果主站已启用 HTTPS，建议同时在 443 的 server 块里也加一条，防止用户直接访问 https://www 时没跳转
• 改完点「保存」，再点「重载配置」，不要只重启 Nginx —— 重载更安全，不影响已有连接

为什么不用「反向代理」或「URL 重写」功能？

宝塔的「反向代理」本质是 proxy_pass，属于服务端转发，浏览器地址栏不变，不是重定向；而「URL 重写」功能（在伪静态里）底层调用的是 rewrite 指令，默认返回 302，即使加 permanent 参数，在某些 Nginx 版本中仍可能被忽略或与 HTTPS 混用出错。

• rewrite ^/(.*)$ https://example.com/$1 permanent; 看似可行，但实测在宝塔自动生成的 HTTPS 配置中容易触发循环重定向
• 用 return 301 是原子操作，Nginx 不会再往下匹配 location，性能更好，语义也更明确
• 如果站点启用了 CDN，确保 CDN 没有缓存 302 响应——曾经有用户反馈 Cloudflare 缓存了旧的 302，导致 301 始终不生效

验证是否真的返回 301，而不是 302 或 200

别只靠浏览器地址栏跳转来判断。真实生效要看响应头里的 Status 字段。最简单方法是用 curl：

curl -I http://www.example.com

输出里必须看到 HTTP/2 301 或 HTTP/1.1 301 Moved Permanently。如果看到 302 Found，说明配置没生效或被其他规则覆盖了。

• 检查有没有多个 if 块冲突，Nginx 中 if 是邪恶的，但单条 host 判断目前仍是安全的用法
• 确认 DNS 解析正常，且 www 和主域名都指向同一台服务器 IP，否则请求根本到不了 Nginx
• 如果用了 Let's Encrypt 泛域名证书，www 子域本身是合法的，不会因证书问题导致跳转失败

重定向这事，看着简单，但多一层 HTTPS、CDN 或缓存，就多一个失效点。动手前先 curl，改完立刻 curl，别信眼睛看到的跳转。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~