宝塔面板中域名301跳转必须在站点配置文件（如example.com.conf）的server块开头、root指令前用return 301实现，禁用rewrite；HTTP跳HTTPS及www与非www互跳均需独立server块，避免if判断和多余指令，改后需保存并重载Nginx。
宝塔面板里加 301 跳转，别去改 nginx.conf 全局文件
直接改全局配置容易被宝塔下次更新或重载覆盖，而且一错全站挂。所有域名级跳转必须在站点配置里做——进「网站」→ 找目标站点 →「设置」→「配置文件」，改的就是那个 xxx.conf（比如 example.com.conf）。
常见错误是把跳转规则写在 server 块外面，或者塞进 location / 里，结果 404 或跳转不生效。正确位置是紧贴在 server 块开头、root 指令之前。
- 只对当前站点生效，不影响其他域名
- 宝塔重载 Nginx 时会自动校验该配置语法，出错会报红提示
- 不要用
rewrite+permanent做主域名跳转，优先用return 301，更轻、更明确
HTTP 自动跳 HTTPS，用 return 301 而不是 rewrite
很多用户抄网上教程用 rewrite ^(.*)$ https://$host$1 permanent;，这在宝塔里容易和 SSL 模块冲突，尤其开了「强制 HTTPS」开关后，可能触发双重跳转或循环重定向（浏览器报 ERR_TOO_MANY_REDIRECTS）。
真正稳的做法是开两个 server 块：一个监听 80 端口，只干一件事——return 301 https://$host$request_uri;；另一个监听 443，跑实际业务。宝塔新建站点时默认已生成这两个块，你只需确认 80 块里没多余指令。
-
$request_uri保留原始路径和参数，比$1更可靠 - 如果用了 CDN（如 Cloudflare），确保「强制 HTTPS」开关关掉，否则 CDN 和 Nginx 双重跳转
- 检查浏览器开发者工具 Network 标签页，看跳转响应头是否含
Location: https://...且状态码是 301
www 和非 www 域名互跳，必须分两个 server 块写
想让 www.example.com 跳到 example.com，不能只在一个 server 里用 if ($host = 'www.example.com') 判断——Nginx 官方明确不推荐在 server 块里用 if 做 host 跳转，有缓存和匹配顺序问题。
标准做法是起两个独立 server 块，各自绑定不同 server_name，然后用 return 301 单向跳转。例如：
server {
listen 80;
server_name www.example.com;
return 301 https://example.com$request_uri;
}
server {
listen 80;
server_name example.com;
# 这里放正常 80 站点逻辑，或直接 return 301 https://...
}
- HTTPS 版本同理，也要配两个
server块，分别监听 443，server_name对应 www 和非 www - 别试图用一个
server块通过正则匹配两种 host，维护性和可读性差，宝塔后台也不方便管理 - 改完要点「保存」再点「重载 Nginx」，光保存不重载，规则不生效
跳转后静态资源 404？检查 root 和 location 是否被继承错
最常被忽略的坑：你在跳转用的 server 块里误加了 root 或 location，导致 Nginx 尝试找文件而不是发跳转响应。301 是响应动作，不是文件路由，它不需要 root，也不该有 location /。
典型症状：访问 http://www.example.com/logo.png 返回 404 而不是跳转，说明这个请求进了带 root 的 server 块，而不是纯跳转块。
- 跳转专用
server块里，只留listen、server_name、return三行，其余全删 - SSL 证书路径、日志路径这些继承自主配置，不用重复写
- 用
nginx -t手动验证配置（宝塔后台「安全」→「终端」里执行），比等浏览器报错快得多
宝塔改一次跳转规则，背后牵扯的是 Nginx 的 server 匹配逻辑、SSL 握手时机、CDN 缓存策略三层东西，漏掉任意一层都可能让跳转失效或变 302。最稳妥的动作永远是：少写、写准、每次只动一个 server 块，改完立刻 nginx -t 验证。
