Ghost博客SQLite迁移MySQL完整指南：备份、配置与数据恢复

迁移目标与核心逻辑

Ghost默认使用轻量级的SQLite数据库，适合个人站点。当访问量提升或需要更复杂的查询支持时，切换到MySQL是常见选择。整个过程遵循“先备份、换配置、再导入”的逻辑，确保数据不丢失且服务平滑过渡。

准备条件

在开始操作前，请确认以下环境就绪：

• 已安装并运行正常的 MySQL 数据库实例。
• 拥有 Ghost 站点的 root 权限服务器访问权。
• 掌握基本的命令行操作能力。

详细操作步骤

第1步：全量数据导出备份

目的：确保在切换数据库前，所有文章、设置和用户信息都有完整存档，防止不可逆的数据损失。

入口：登录 Ghost 后台界面。

动作：进入 /ghost/debug/ 调试面板。

找到数据库备份选项，点击蓝色的 EXPORT 按钮。系统将生成一个包含全站数据的 JSON 文件（默认名为 GhostData.json）并下载到本地保存。

第2步：修改数据库配置适配 MySQL

目的：告知 Ghost 程序停止读写 SQLite 文件，转而通过特定协议连接 MySQL 服务。

入口：服务器终端中 Ghost 安装目录下的 config.production.js 文件。

动作：编辑该文件，定位到 database 节点。将原有的 SQLite 配置替换为以下结构，并根据实际情况填入你的 MySQL 主机地址、用户名、密码及新建的空数据库名：

module.exports = {
  production: {
    database: {
      client: 'mysql',
      connection: {
        host : 'localhost',
        user : 'your_user',
        password : 'your_password',
        database : 'your_database_name',
        charset : 'utf8'
      },
      debug: false
    }
  }
};

注意：如果 Ghost 是通过 PM2 等进程管理器运行的，此步骤通常涉及重启服务以使配置生效。

第3步：初始化新数据库并导入数据

目的：利用空白的 MySQL 环境创建表结构，并将备份中的数据回填。

动作：

1. 完成上述配置修改后，重启 Ghost 服务。此时访问网站可能会显示异常，因为 MySQL 库为空。
2. 回到 /ghost/setup/ 或登录界面。由于没有现有管理员账号，系统通常会引导你进行初始设置，或者你可以尝试使用之前在 SQLite 中设置的凭据（若未成功则需创建一个临时超级管理员账号）。
3. 再次进入 /ghost/debug/ 页面。
4. 点击 IMPORT 按钮，上传第一步下载好的 GhostData.json 文件。

验证与排错

判断标准：导入完成后，刷新前台网页，检查文章标题、内容图片是否显示正常，后台设置页是否能正确加载原有配置。

常见异常：

• 连接失败：检查 config.js 中的 MySQL 用户名密码是否正确，并确保远程服务器防火墙放行了 MySQL 端口。
• 导入报错：通常是因为版本兼容性问题，确保 Ghost 版本较新，且 JSON 数据格式完整。

简要总结

通过以上步骤，我们成功将 Ghost 的底层存储介质由 SQLite 变更为 MySQL。这一过程不仅保留了全部历史数据，还提升了系统的扩展性能力。以上就是 Ghost从SQLite迁移到MySQL数据库的详细内容，更多关于Ghost建站优化的资料请关注本站其它相关文章！