KSWEB 数据库备份与恢复 SQL 导出导入操作手册

什么时候需要备份

• 从虚拟主机迁移到 KSWEB（或反向）
• WordPress / Joomla 小版本升级前
• 改 CMS 配置或插件前先存一份快照
• 长期挂机前，定期自动备份（配合 Cron 计划任务）

从其他服务器导出

在原来的虚拟主机（宝塔、cPanel、phpMyAdmin 任意一个）：

1. 登录 phpMyAdmin
2. 选中要迁移的数据库
3. 点"导出"标签
4. 格式选 SQL，压缩选 gzip（.sql.gz）
5. 下载到本地电脑

在 KSWEB 上导入

方式一：phpMyAdmin / Adminer 界面

1. KSWEB 打开 MySQL
2. TOOLS 标签页打开 phpMyAdmin
3. 新建一个空数据库（排序规则 utf8mb4_unicode_ci）
4. 进入数据库，点"导入"
5. 选择刚才下载的 .sql.gz 文件
6. 执行

注意：如果文件超过几 MB，手机浏览器上传可能超时。用方式二更可靠。

方式二：FTP 上传后本机导入

1. 用 FTP 客户端（FileZilla、WinSCP、手机上的 FTP 客户端）把 .sql.gz 上传到手机存储根目录
2. 在 KSWEB 内置编辑器里打开一个临时 PHP 脚本，执行 gunzip 解压然后导入——或者直接在 shell 里跑
3. 导入完成后删除临时文件

方式三：CMS 自带迁移工具

很多 CMS 有自带的迁移/备份插件：

• WordPress 用 All-in-One WP Migration 或 Duplicator
• Joomla 用 Akeeba Backup

直接在 CMS 后台导出整站（文件 + 数据库打包成一个 .jpa 或 .wpress 文件），上传到 KSWEB 的 htdocs 后用安装向导恢复，比手动导 SQL 更稳。

恢复失败怎么办

• 字符集不匹配 — 看原数据库用的什么字符集（utf8、utf8mb4、gbk），导入时调整目标库排序规则
• 外键约束错误 — 导出时勾选了"外键检查"，导入时先 SET FOREIGN_KEY_CHECKS=0; 再导
• SQL 语法版本差异 — MySQL 5.6 导出的 SQL 在 5.7 上一般没问题，MariaDB 也基本兼容

自动备份

KSWEB PRO 版有 Cron 计划任务功能，配合 mysqldump 命令可以实现定时自动备份。典型的每天凌晨 3 点跑一次：

0 3 * * * /data/data/ru.kslabs.ksweb/files/mysql/bin/mysqldump -u root 数据库名 > /sdcard/backup/db-$(date +\%F).sql

Cron 限制和写法注意事项见 Cron 计划任务。