企业官网建设流程全解析

qui迁移指南：从Deluge等客户端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

换BT客户端（BitTorrent下载工具）最疼的不是装软件，而是数据要推倒重来：几千个种子重新添加、重新校验一遍文件，做种时长清零，前功尽弃。qui（一个基于qBittorrent的Web管理面板）自带qui migrate迁移命令，能把 Deluge、rTorrent、Transmission 的种子库连同下载状态整个搬进 qBittorrent——下载好的文件原地不动，种了五年的时长也一分不少地带过来。

迁移会带走哪些数据

qui migrate读取旧客户端的会话文件（记录下载进度、路径、统计的状态文件），转换成 qBittorrent 原生格式：

所有导入的种子都会带上migrated标签，之后一个筛选器就能捞出整批。⚠️ 只有完全下载完的种子才会被导入，进行中的会被跳过并在日志里逐条警告。

前置条件自查

• 装好 qui，qui命令能在终端跑（下载预编译二进制，或克隆源码后make build）
• 旧客户端正常退出（三个客户端都在正常关机时才刷新会话文件，直接杀进程会留下残缺状态）
• 停掉 qBittorrent（迁移写入的是 qBittorrent 的会话目录BT_backup，它只在启动时读取）
• 下载好的数据仍在原路径

💡 这条命令对旧客户端只读不写：只读会话文件、只复制.torrent。反悔了？停掉 qBittorrent、重启旧客户端即可切回，数据一个字节都没被改过。

核心操作三步走

第一步：先用 --dry-run 预览

加--dry-run（只预演、不落盘）先跑一遍，末尾会打印 "would import X of Y torrents"，确认数量符合预期：

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

第二步：正式迁移

把--dry-run去掉就是正式导入。以 Deluge 为例：

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

rTorrent 和 Transmission 只需换首参和--source-dir，例如：

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

⚠️ 默认会先把源目录和已有的BT_backup各打包成.tar.gz存到当前目录的qbt_backup/，确认安全再写——这是内置的后悔药，--skip-backup可跳过。命令重复执行也安全：目标里已存在的种子自动跳过。

第三步：启动 qBittorrent，让 qui 接管

迁移跑完后启动 qBittorrent，导入的种子库立刻就位。打开 qui 把这台 qBittorrent 添加为实例（qui 可以管理多个 qBittorrent 实例），旧种子的分类、标签、做种统计都原样呈现：

源目录与 qbit-dir 路径对照

--qbit-dir三源通用，按系统选位置：Linux 为~/.local/share/qBittorrent/BT_backup，Windows 为%LOCALAPPDATA%\qBittorrent\BT_backup，Docker 容器内为/config/qBittorrent/BT_backup。

验证清单

• ✅ 种子总数：日志里 "successfully imported" 的数字对得上旧客户端的完成数（skipped 的都有对应警告）
• ✅ 状态：导入的种子直接显示"已校验"，不触发重新校验
• ✅ 在 qui 里按migrated标签筛选，检查分类/标签是否正确带过来
• ✅ 抽查几个老种子的保存路径与做种时长、分享率

高频问题

导入的种子显示"找不到文件"

原因：迁移原样带过保存路径，新系统的挂载、盘符或目录结构对不上，qBittorrent 按原路径找不到文件。⚠️ 跨系统也不行——Unix 的会话目录导入 Windows 主机会直接被跳过。解法：迁移后让数据保持在旧路径上（换机器就把挂载布局搭成一模一样），然后在 qBittorrent 里重新定位文件。

部分种子没被导入

原因：导入器只收"所选文件全部下载完"的种子，BitTorrent v2 种子也一律跳过。日志里能看到每条 "not fully downloaded" 或 "v2 torrent" 的跳过记录。解法：把进行中的种子下完或删掉，重跑命令即可，已导入的会自动跳过、不会重复。

首次启动日志报分类"missing from the configuration file"

原因：分类/标签是导入时新建的，qBittorrent 配置里还没有。解法：不用处理，警告一次性出现，随后自动恢复，属纯外观问题。

迁移完成后的两件事

库搬完别浪费：在Instances页面把家里和 seedbox 的 qBittorrent 都加进来，一个界面管理多台机器；再到Automations建规则，新入的种子按条件自动归类、改名，从此不用手动记账。

换客户端不该等于从零开始，qui migrate让你的做种时长和分类跟着种子库一起走。参数细节与逐客户端行为见文档 Client Migration 和 CLI Commands。

【免费下载链接】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