企业官网建设流程全解析

用 qui 迁移命令 3 步搬完你的种子库

【免费下载链接】quiA fast, single-binary qBittorrent web UI: manage multiple instances, automate torrent workflows, and cross-seed across trackers.项目地址: https://gitcode.com/GitHub_Trending/qui3/qui

如果你正打算从 Deluge、rTorrent 或 Transmission 切到 qBittorrent,最关心的肯定是:积累多年的种子库能不能原样带走。qui 内置的qui migrate迁移命令就是为此设计的——它不是导出一堆.torrent文件,而是把每个种子的下载状态一并搬进 qBittorrent,迁移后不用从零重新配置。

先弄清 qui 迁移命令到底搬了什么

qui 本身不是下载客户端,而是 qBittorrent 的 Web UI。所谓 qui 迁移,实际是把其他客户端的种子导入 qBittorrent 的BT_backup会话目录,由 qBittorrent 下次启动时恢复整个库。搬过去的不只是种子元数据:保存路径、tracker、上传/下载量、加入与完成时间、做种时长、暂停状态、单文件选择都会保留;已完成的种子以"已校验"状态到达,省去耗时的 recheck。

✅ 三个来源客户端的支持版本与--source-dir指向:

各客户端保留字段的具体差异,见 Client Migration 文档。

迁移前的 3 个准备动作

流程很短:停旧客户端 → 跑命令 → 启 qBittorrent。准备阶段注意三件事:

1. 正常停止来源客户端。三个客户端都只在正常退出时把 resume 状态写回磁盘,强杀进程会让状态文件残缺,丢的是下载进度信息。
2. 同时停掉 qBittorrent。命令写入的是BT_backup,而 qBittorrent 只在启动时读取它,一边写一边读最容易出乱子。
3. 确认两个目录。一个是来源客户端的状态目录(--source-dir),一个是 qBittorrent 的BT_backup(--qbit-dir;Linux 常见为~/.local/share/qBittorrent/BT_backup,Windows 为%LOCALAPPDATA%\qBittorrent\BT_backup)。

💡 不传--skip-backup时,qui 会先把源目录与目标目录打包归档到qbt_backup/再动手,出错也有回滚的余地。

一条命令,从预演到正式执行

先别直接跑正式导入,加--dry-run预演一遍:这个模式只打印统计、不写磁盘,你可以核对"会导入多少、跳过多少"是否符合预期。

./qui migrate transmission \ --source-dir ~/.config/transmission-daemon \ --qbit-dir ~/.local/share/qBittorrent/BT_backup \ --dry-run

数字对得上,去掉--dry-run再跑一遍即完成导入。换其他客户端时,只改第一个参数和--source-dir:

./qui migrate deluge --source-dir ~/.config/deluge/state \ --qbit-dir ~/.local/share/qBittorrent/BT_backup

./qui migrate rtorrent --source-dir ~/.sessions \ --qbit-dir ~/.local/share/qBittorrent/BT_backup

两个值得记住的行为:其一,可重跑——目标里已存在的种子会直接跳过,之后补迁新完成的种子随时再执行;其二,只搬"已完成"的种子(指你选中的文件全部下完),仍在下载中的会被跳过并留下警告,避免把错误的分片状态带过去。

迁移后必做的 3 项确认

启动 qBittorrent,打开 qui 网页端,先在左侧 Tags 区用migrated标签过滤——所有导入的种子都带这个标签,一筛就能看到整批。然后按顺序确认:

1. 数量与状态:完成/做种数与旧客户端对得上;暂停状态符合预期(Deluge 1.3.x 因退出时会把全库标记暂停,无法保留,导入后全部为运行中;2.x 无此问题)。
2. 保存路径:路径按原样写入,确认新环境在原位置读得到数据。跨机器或跨容器迁移时保持挂载布局一致,否则会出现成片"文件缺失"。
3. 标签映射:Deluge 与 ruTorrent 的标签变成 qBittorrent 的 category,Transmission 的标签变成 tag。首次启动时 qBittorrent 会为每个标签打一条"配置文件中缺失"的警告,属于一次性恢复日志,可忽略。

踩坑时的 3 个排查方向

⚠️ 迁移后的问题基本集中在三类:

• 大量种子提示"文件缺失":多数是路径没对齐。命令只是把保存路径原样写入 qBittorrent,要么修正路径,要么把数据放回原位置,别怀疑迁移本身。
• 导入数量比预期少:看命令日志,"已存在被跳过"与"未完成不导入"都是正常行为;未完成种子等下完再跑一次即可。
• BitTorrent v2 种子不见了:导入器不支持 v2 种子(merkle 树数据无法经此路径传递,qBittorrent 也会拒绝),会直接跳过。

完整参数参考见 CLI Commands 文档,--skip-backup、--dry-run等都在其中。

迁移完成后的进阶玩法

种子库稳定之后,qui 的多实例管理才开始发挥作用:在 Instances 页面把多个 qBittorrent 实例接入同一套界面,用 Automations 配置基于做种时长、磁盘空间等条件的自动规则,再用 Cross-Seed 把相同内容自动铺到其他 tracker。

把第一个实例接进 qui,就是你旧种子库新生活的开始。

【免费下载链接】quiA fast, single-binary qBittorrent web UI: manage multiple instances, automate torrent workflows, and cross-seed across trackers.项目地址: https://gitcode.com/GitHub_Trending/qui3/qui