3 步把老 BT 数据无损搬进 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
换客户端最崩溃的瞬间:新工具一打开,多年下载的种子全没了,保存路径也全乱了。别慌,BT 客户端迁移没那么玄乎——qui 的迁移链路可以简化成 3 步:打包、传输、验收。
一张图看懂:迁移到底走几步
先给你一张地图,上路就不慌了:
- 打包:把老客户端里的种子文件、恢复状态、配置备份成「行李箱」;
- 传输:通过 qui 的 Web 界面或命令行,把箱子接进来;
- 验收:对着清单逐项验货,再触发一次备份兜底。
动手前装好 qui 就行,一行命令的事:
git clone https://gitcode.com/GitHub_Trending/qui3/qui动手前,先盘点你的数据「家当」
要搬的东西就三类:种子文件(.torrent,身份)、恢复状态(fastresume,进度/已下载的分块)、配置(保存路径、限速等偏好)。三者齐了,才算真·无损。
各主流客户端的家当都藏在哪,一张表给你盘清楚:
| 客户端 | 种子文件位置 | 恢复状态 | 配置文件 | 导出入口 |
|---|---|---|---|---|
| qBittorrent | ~/.local/share/qBittorrent/BT_backup/ | 同在 BT_backup(.fastresume) | ~/.config/qBittorrent/qBittorrent.conf | 备份与恢复(BT_backup 即完整备份) |
| uTorrent | 手动「保存种子」导出到任意目录 | 无独立状态文件 | Windows 下AppData\Roaming\uTorrent\uTorrent.settings | 勾选种子 → 右键保存 |
| Transmission | 默认~/data/torrents/ | ~/data/torrents/resume/ | ~/data/settings.json | 直接整目录复制 |
| rTorrent | ~/.sessions/(.torrent + .rtorrent) | 同目录 .rtorrent 状态文件 | ~/.config/rtorrent.conf | 直接整目录复制 |
| Deluge | deluge state 目录 | ~/.config/deluge/state/ | ~/.config/deluge/deluge.conf | 直接整目录复制 |
一句话强调:迁移开始前,先把原客户端整个数据目录原样复制一份——这是你唯一的后悔药。
把老数据打包带走
按数据形态打包,比按客户端记步骤省心。
种子文件
- 找到上表中对应客户端的种子目录;
- 整体压缩成 zip 或 tar.gz(qui 导入时认这两种格式);
- 客户端差异:qBittorrent 直接压
BT_backup目录;uTorrent 没有统一目录,先手动全选导出再压;Transmission/rTorrent/Deluge 整目录复制即可。
配置文件与恢复状态
- 把配置文件和状态目录一并压缩(Transmission 的
resume/、rTorrent 的.rtorrent文件别漏); - 客户端差异:qui 的命令行迁移器直接读 Deluge / rTorrent / Transmission 的原生状态目录,无需手动拆包,压缩一份留底即可;
- 两个压缩包一起存到安全位置,你的「行李箱」就备好了。
把数据接进 qui
图形界面导入:点点点完成
普通用户走这条路最稳:
- 打开 qui 的 Web 界面,进入对应实例的Backups(备份与恢复)页面;
- 在导入区选择你压好的种子/备份归档(支持 zip、tar.gz 等格式),上传;
- 界面会展示导入结果,等待进度条走完即可。
只想补几个种子的话,用种子页顶部的添加对话框直接拖入 .torrent 文件也行。
命令行导入:给批量和自动化场景
种子库在千级以上、或者你就想一劳永逸,CLI 是正解。以 Transmission 为例,qui 自带migrate子命令,会自动备份源数据并连恢复状态一起搬:
qui migrate transmission \ --source-dir ~/data \ --qbit-dir ~/.local/share/qBittorrent/BT_backup第一次执行建议加--dry-run空跑确认无误。两种方式怎么选:图形界面适合手动、小规模导入;命令行适合大批量、可重复执行的迁移。更多参数见迁移器源码。
搬完之后的「验货」清单
搬家收工前,一项项勾掉再走:
- 种子状态:正常 = 数量、进度、做种状态和老客户端基本一致;异常 = 打开种子列表逐一比对,实例掉线会显示在实例错误提示里。
- 文件路径:正常 = 无「找不到文件」类报错;异常 = 选中受影响种子执行重新检查文件,或批量修改保存路径指向新位置。
- tracker 列表:正常 = 各种子 tracker 列无成片失效图标;异常 = 用 reannounce 功能批量重播,让失效 tracker 恢复。
- 关键设置:正常 = 默认保存路径、限速、连接数符合预期;异常 = 进实例设置对照老客户端逐项核对。
- 留一份保险:在 Backups 页面手动触发一次备份,给新家上把锁。
踩过的坑,都在这
现象:导入后一堆种子提示找不到文件原因:保存路径在新系统变了(老盘符/挂载点没了)解法:别慌着重新下载,先重新检查文件,再统一把保存路径改到新位置
现象:进度归零,好像从头重新下载原因:只拷了 .torrent,恢复状态(fastresume)没跟上,等于只有身份证没有行李解法:用qui migrate从 Deluge/rTorrent/Transmission 的状态目录导入,qBittorrent 用户把 BT_backup 整个带过去
现象:大种子库导入慢得想摔键盘原因:Web 界面逐条处理且前端持续刷新,开销叠加解法:切命令行批量导入,关掉实时刷新,必要时分批进行
新家安顿好,再住出点花样
迁完别急着关浏览器,qui 的几个进阶能力值得顺手开启:
- 多实例管理:设置 → 实例,把家里/服务器的多台 qBittorrent 全挂进来,一个面板管全部;
- 交叉播种(Cross Seed):Cross Seed 页面配置规则,已完成的种子自动去别的 tracker 找同资源补种,做种效率翻倍;
- 自动化(Automations):Automations 页面写条件-动作规则,比如完成即暂停、按 tracker 打标签,以后不用手动盯。
回到开头那个最怕的瞬间:数据丢了吗?没有。打包时整目录留底、传输时先 dry-run 再实跑、验收时对照清单逐项打勾,你的种子库就原封不动地住进了新家。按这份指南走,迁移比你想象的快——安顿好之后,去把交叉播种和自动化点亮,才是 qui 真正好用的开始。遇到具体问题,可查看官方文档或在社区 Discord 里提问。
【免费下载链接】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
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考