一、环境准备与核心工具安装

在进行Z-BlogPHP站点迁移或采集之前，必须确保新旧服务器环境一致，且已准备好必要的插件。Z-BlogPHP对PHP版本要求较高，建议使用PHP 7.4或PHP 8.0/8.1环境。以下操作均基于Z-BlogPHP 1.7版本进行演示。

1. 核心插件下载

我们需要两个核心插件：一个用于全站数据备份与还原，另一个用于接收采集数据。请直接访问Z-Blog应用中心下载：

• 数据迁移插件：搜索“BackupRebuild”（备份与重建），这是官方推荐的备份插件，支持全站文件与数据库打包。
• 采集接口插件：搜索“Z-Blog API发布”或“PostApi”，用于对接采集器。

2. 服务器权限设置

在操作前，请务必检查服务器目录权限，确保Web服务器（如Nginx或Apache）对以下目录拥有读写权限：

• zb_users/cache/ (缓存目录)
• zb_users/upload/ (附件目录)
• zb_users/data/ (配置文件目录)
• zb_users/plugin/ (插件目录)

在Linux服务器下，执行以下命令一键设置权限：

chown -R www:www /path/to/your/zblog
chmod -R 755 /path/to/your/zblog
chmod -R 777 /path/to/your/zblog/zb_users/cache
chmod -R 777 /path/to/your/zblog/zb_users/upload
chmod -R 777 /path/to/your/zblog/zb_users/data

二、Z-Blog全站数据迁移实操步骤

本章节讲解如何将A站点的完整数据（文章、评论、配置、附件）迁移至B站点。

1. 旧站数据打包备份

登录旧站点后台，进入“插件管理”中心，找到已安装的“BackupRebuild”插件并点击进入。

操作步骤：

• 在插件配置页中，勾选“备份附件”和“备份主题与插件”选项。这能确保迁移后样式和功能完全一致。
• 点击“开始备份”按钮。系统会自动在zb_users/cache目录下生成一个以时间戳命名的.zip或.bak文件。
• 备份完成后，页面会显示下载链接。请直接点击下载该备份文件到本地。

注意：如果数据量较大（超过2GB），建议直接在服务器端使用tar命令打包整个站点目录，并通过SCP或FTP传输，避免因PHP执行超时导致备份文件损坏。

2. 新站环境部署与还原

在新服务器上，先安装一个全新且版本号一致的Z-BlogPHP程序。不要覆盖安装，必须先通过官方安装包跑一遍安装流程，建立好数据库连接。

还原操作：

• 将步骤1中下载的备份文件上传到新站点的zb_users/cache目录下。
• 登录新站点后台，进入“插件管理”，安装并启用“BackupRebuild”插件。
• 进入插件页面，系统会自动检测到cache目录下的备份文件。
• 点击“还原”按钮。系统会解压文件并导入数据库。

3. 修复配置与伪静态

还原完成后，前台和后台可能会出现404错误或样式错乱，这是因为域名和路径发生了变化。

修复配置文件：

使用FTP或编辑器打开新站点的zb_users/c_option.php文件，找到以下配置项并修改为新服务器的实际信息：

// 修改为新站点域名，末尾不要加斜杠
$zbp->option['ZC_BLOG_HOST'] = 'https://www.newdomain.com';
// 修改为新站点物理路径
$zbp->option['ZC_BLOG_PATH'] = '/www/wwwroot/www.newdomain.com/';

修改保存后，登录后台，进入“网站设置”管理页面，点击“提交”一次，以刷新缓存。

重建索引：

在后台左侧菜单找到“网站设置”，在底部点击“重新建立索引”。此步骤会刷新所有文章的静态链接，至关重要。

三、第三方数据采集至Z-Blog实操

本章节使用“火车头采集器”配合“Z-Blog API发布”插件，实现将外部网页数据自动发布到Z-Blog。

1. 安装并配置API插件

在Z-Blog后台应用中心安装“Z-Blog API发布”插件。安装成功后，在插件管理页找到该插件并进行配置。

配置参数：

• 登录用户名：输入Z-Blog后台的管理员账号。
• 登录密码：输入Z-Blog后台的管理员密码（或插件生成的专用API密钥）。
• 发布状态：选择“审核通过”或“草稿”，建议测试时选“草稿”。
• 保存配置并启用插件。

插件启用后，会生成一个API接口地址，通常格式为：https://你的域名/zb_users/plugin/post_api/api.php。请记录此地址。

2. 配置火车头采集器Web发布模块

打开火车头采集器（Locoloy），切换到“Web发布配置”标签页，新建一个Web发布模块。

基本设置：

• 接口地址：填入上一步获取的API地址。
• 编码方式：选择UTF-8。
• 登录方式：选择“POST方式”。

参数映射设置（关键步骤）：

点击“参数列表”，添加以下参数。这些参数名必须与Z-Blog API插件要求的字段完全一致：

参数名	对应标签	说明
username	固定值	填入你的管理员账号
password	固定值	填入你的管理员密码
title	[标签:标题]	文章标题
content	[标签:内容]	文章正文，支持HTML
tag	[标签:关键词]	文章标签，用逗号分隔
cate_id	固定值	目标分类ID（1为未分类）

3. 编写采集规则与测试发布

在火车头中新建任务，配置目标网站的列表页规则和内容页规则。

内容页获取示例：

• 标题规则：

  [标题]

• 正文规则：
  [内容]

测试发布：

规则配置完毕后，在“采集”选项卡中选择“Web发布调试”。勾选一条数据，选择刚才配置的Web发布模块，点击“开始测试”。

观察返回结果。如果返回{"success":true}或类似的成功标识，说明配置正确。如果返回403或password error，请检查API插件中的用户名密码是否正确，以及服务器IP是否被防火墙拦截。

四、常见问题与解决方案

在实操过程中，可能会遇到以下技术障碍，请按方案排查。

1. 迁移后图片无法显示

原因：附件路径配置错误或附件文件夹未完全复制。

解决：检查zb_users/upload目录是否存在。如果使用了附件云存储插件，请在新站后台重新配置该插件的AccessKey等信息。

2. 采集发布后文章内容为空

原因：火车头标签未正确匹配，或内容中包含了干扰字符导致API过滤失败。

解决：在火车头“调试”窗口查看发送的POST数据包。确认content字段是否有值。如果目标网站内容是JS加载，请使用“浏览器模拟”方式采集。

3. 迁移后台登录提示密码错误

原因：数据库版本不兼容导致密码Hash验证失败。

解决：在zb_users/data目录下找到settings.ini或直接操作数据库，将管理员密码重置。推荐安装“密码重置”插件，在应用中心下载后上传启用，根据提示在浏览器访问特定URL即可重置为123456。

4. 采集时出现乱码

原因：目标网站编码与Z-Blog（UTF-8）不一致。

解决：在火车头任务的“属性”设置中，将“网页编码”设置为“GB2312”或“GBK”（针对老站），并勾选“自动转码”或“始终UTF-8”。