ZBlogCMS 如何设置 301 重定向

学完这篇，你能在 ZBlogCMS（ZBlogPHP）里通过插件或服务器规则，把旧域名、旧链接永久重定向到新地址，并验证 301 是否真正生效。

第一步：备份网站并确认 ZBlog 版本

这一步要拿到两个结果：一份可回滚的备份，以及你当前 ZBlogPHP 的准确版本号，方便后面选兼容的插件或规则。

先登录 ZBlog 后台，地址通常是 http://你的域名/admin/，输入用户名和密码。登录后看后台左下角或「首页」仪表盘，会显示类似 ZBlogPHP 1.7.3 的版本号。同时用宝塔面板、FTP 或主机商文件管理器，把网站根目录整个打包下载，再通过 phpMyAdmin 导出数据库。

注意：改重定向之前必须备份。规则写错会导致首页或后台直接打不开，有备份才能快速还原。

第二步：用插件设置 301 重定向（推荐新手）

这一步在 ZBlog 后台安装并配置一个 301 插件，完成后旧地址访问会自动跳到新地址。

在 ZBlog 后台顶部菜单点「应用中心」→「插件管理」→「从应用中心安装」。在搜索框输入 301，找到名为「301重定向」的插件，确认它支持你当前 ZBlogPHP 版本，点「安装」。安装完成后回到「插件管理」列表，点该插件右侧的「启用」，再点「设置」。

进入设置页后添加规则：源地址填旧域名或旧路径，例如 old.com 或 /old-post/；目标地址填新域名或新路径，例如 https://new.com 或 https://new.com/new-post/；重定向类型选「301 永久重定向」。保存后立即用浏览器无痕窗口访问旧地址测试。

注意：插件规则通常按从上到下匹配，具体路径规则要放在泛域名规则前面，否则可能被提前拦截。

第三步：手动修改服务器规则（Apache / Nginx）

如果插件不兼容，或者你想在服务器层面统一处理，这一步直接改伪静态配置，完成后所有请求由服务器执行 301。

Apache 环境：用宝塔面板「文件」进入网站根目录，编辑 .htaccess 文件，在 RewriteEngine On 下方加入：

RewriteCond %{HTTP_HOST} ^old\.com$ [NC]
RewriteRule ^(.*)$ https://new.com/$1 [R=301,L]

Nginx 环境：宝塔面板「网站」→ 找到对应站点 →「设置」→「配置文件」，在 server { } 块内加入：

if ($host = 'old.com') {
    rewrite ^/(.*)$ https://new.com/$1 permanent;
}

保存后，Apache 一般即时生效；Nginx 需要在宝塔面板点「重载配置」，或 SSH 执行 nginx -t && systemctl reload nginx。nginx -t 显示 syntax is ok 才算配置正确。

注意：Nginx 的 if 不要乱套在 location 里；改完先测试再重载，否则可能整站 502。

第四步：验证 301 是否生效

这一步确认重定向返回的是 301 状态码，而不是 302 或 404。在电脑终端执行：

curl -I http://old.com

返回结果里出现 HTTP/1.1 301 Moved Permanently 和 Location: https://new.com/... 就成功了。也可以打开浏览器无痕窗口，输入旧地址，看是否自动跳到新地址。

注意：浏览器会缓存 301，普通窗口测试可能看到旧结果，务必用无痕模式或换设备验证。

小结

• 改 301 前先备份文件和数据库，确认 ZBlogPHP 版本。
• 新手优先用「应用中心」→「插件管理」安装 301 重定向插件，规则注意顺序。
• 手动改 Apache 的 .htaccess 或 Nginx 的 server 块，改完先测试再重载。
• 用 curl -I 或无痕浏览器验证，必须看到 301 和正确的 Location。
• 301 会被浏览器缓存，测试时避开普通窗口。