Skip to content

About

GopherInk配套工具,用于从其他CMS导入数据,导出数据等

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

Repository files navigation

GopherInk Tools

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-migrate

基本用法

Typecho SQLite:

./gopherink-migrate typecho --input /path/to/typecho.db

MariaDB/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 -help

管理员密码

Typecho 可能使用 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 使用原 Typecho cid,自定义 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 数据目录。完成后检查首页、固定链接、评论层级、附件路径和管理员登录,再切换生产流量。

许可证

AGPL-3.0

About

GopherInk配套工具,用于从其他CMS导入数据,导出数据等

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages