GopherInk 的独立维护工具仓库。当前提供 gopherink-migrate,用于把 Typecho 数据整理为 GopherInk 可直接读取的数据。
项目仓库:github.com/Chocola-X/GopherInk-Tools
版本 0.1.0 实现第一阶段的 Typecho 精简迁移:
- 输入 Typecho SQLite 数据库文件。
- 输入由 MariaDB/MySQL 导出的 SQL dump。
- 自动识别 Typecho 表前缀,也可手动指定。
- 输出 GopherInk Schema v1 SQLite 数据库。
- 默认输出到程序当前工作目录的
gopherink-import.db。 - 输出采用临时文件和完整性检查,成功后才替换目标文件。
- 生成附件文件搬迁清单,并同步改写正文中的 Typecho 本地附件 URL。
MySQL/MariaDB 和 PostgreSQL 目标数据库写入尚未在第一阶段启用。输入解析与迁移映射已经分层,后续可以复用当前 Typecho 解析结果增加数据库目标适配器。
需要 Go 1.25 或根目录 go.mod 指定的兼容版本。SQLite 驱动依赖 CGO 和 C 编译器。
go build -o gopherink-migrate ./cmd/gopherink-migrateTypecho SQLite:
./gopherink-migrate typecho --input /path/to/typecho.dbMariaDB/MySQL dump:
./gopherink-migrate typecho \
--input /path/to/typecho_backup.sql \
--output ./gopherink-import.db默认根据 .db、.sqlite、.sqlite3 或 .sql 扩展名判断输入格式。也可以明确指定:
./gopherink-migrate typecho \
--input backup.data \
--format mysql-dump \
--prefix typecho_查看完整参数:
./gopherink-migrate -help
./gopherink-migrate typecho -helpTypecho 可能使用 MD5、phpass 等密码格式,GopherInk 使用 bcrypt。只有哈希而没有明文密码时,无法安全地把旧哈希直接转换为 bcrypt。
迁移时可以从标准输入设置所有 Typecho 管理员的新密码:
printf 'replace-with-a-strong-password\n' | \
./gopherink-migrate typecho \
--input typecho.db \
--admin-password-stdin也支持 --admin-password,但明文可能出现在 Shell 历史和进程列表中,不建议用于生产数据。
没有明确设置新密码的用户会写入随机 bcrypt 密码并锁定登录。迁移后使用 GopherInk 命令重置:
./gopherink user list
./gopherink user reset-password --id 1数据库尚未放到默认位置时,可以通过启动环境指向迁移结果:
GOPHERINK_DB_DRIVER=sqlite3 \
GOPHERINK_DB_DSN=/path/to/gopherink-import.db \
./gopherink user reset-password --id 1非管理员用户不会共享迁移时设置的管理员密码,需要按需分别重置。
迁移器只读取 Typecho 七张官方核心表:
| Typecho 表 | GopherInk 目标 | 处理 |
|---|---|---|
contents |
gb_contents / gb_revisions |
文章、页面、草稿、编辑草稿、修订和附件 |
users |
gb_users |
ID、资料和角色;密码按上节处理 |
comments |
gb_comments |
评论、回复层级、审核状态、IP 和客户端信息 |
metas |
gb_metas |
仅分类和标签 |
relationships |
gb_relationships |
仅保留有效内容与分类标签关系 |
options |
gb_options |
仅映射 Typecho 官方站点、阅读和评论设置 |
fields |
不导入 | 当前精简模式统计后跳过 |
以下数据不会导入:
- 插件自行创建的表,例如访问日志、点赞和友情链接表。
contents中由插件追加的views、likes等非官方列。plugin:*、theme:*、路由缓存和插件注册信息等选项。- Typecho 自定义字段值。自定义字段本身是官方扩展机制,但无法可靠判断字段来自用户、主题还是插件,因此第一阶段统一跳过。
- 非 Typecho 官方内容类型和分类类型。
SQL dump 使用流式扫描。未选中的插件 INSERT 只检查语句边界,不缓存值,因此大型访问日志不会整体载入内存。
- 保留 Typecho 的
cid、coid、mid和uid,避免评论、附件与分类关系断开。 - 文章和页面的
slugId使用原 Typechocid,自定义 slug 保持不变。 post_draft/page_draft转换为 GopherInk 草稿。- 已发布内容的编辑草稿通过
draftOf关联原内容,并与原内容共享slugId。 - 同一已发布内容存在多个异常草稿时,仅保留修改时间最新的一份。
- Typecho
revision进入gb_revisions。 publish、private、hidden、waiting等状态按 GopherInk 可识别状态保留。- 评论数、分类数和标签数在导入后根据实际关系重新计算,不直接信任旧缓存计数。
- Typecho Markdown 标记
<!--markdown-->会保留,GopherInk 可以直接识别。
数据库只包含附件元数据,不包含实际文件。迁移器会把 Typecho PHP 序列化附件信息转换为 GopherInk JSON,并生成:
gopherink-import-attachments.json
清单中的每项包含:
source_path:Typecho 上传目录内的原路径。target_path:相对于 GopherInk 上传根目录的新路径。url:迁移后正文使用的公开 URL。
目录映射:
文章附件 uploads/posts/<cid>/<filename>
独立页面附件 uploads/pages/<cid>/<filename>
孤立附件 uploads/unattached/typecho-<attachment-cid>/<filename>
需要根据清单复制实际文件。例如:
Typecho: /var/www/typecho/usr/uploads/2024/03/390370132.png
GopherInk: /srv/gopherink/uploads/posts/6/390370132.png
迁移器只改写能够与 Typecho 附件记录对应的 URL,不会盲目替换文章示例代码或说明文字中的 /usr/uploads/。
- 输出数据库和附件清单权限为
0600。 - 目标数据库存在时默认拒绝执行。
--force明确允许覆盖。- 数据先写入同目录临时文件。
- 事务提交后执行
PRAGMA integrity_check和VACUUM。 - 输入数据库只读打开,不会修改原 Typecho 数据。
正式迁移前仍应备份 Typecho 数据库、上传目录和 GopherInk 数据目录。完成后检查首页、固定链接、评论层级、附件路径和管理员登录,再切换生产流量。