完整迁移qBittorrent需同步配置与运行时数据，方法包括：一、完整配置目录迁移；二、BT_backup+fastresume重建；三、qbittorrent-torrents-exporter工具导出导入；四、Docker卷迁移；五、NAS平台专用迁移。

如果您需要将qBittorrent中的全部下载任务、种子状态、分类标签、RSS订阅及WebUI设置完整迁移到新电脑，而不仅仅是重新添加种子文件，则必须同步迁移核心配置与运行时数据。以下是实现完整迁移的多种可靠方法：

一、完整配置目录迁移法

该方法直接复制qBittorrent在原系统中生成的全部持久化数据，涵盖种子元数据（.fastresume）、配置文件（qBittorrent.conf）、RSS规则、分类与标签定义、日志及缓存，是保留100%任务状态的最彻底方式。

1、定位原电脑qBittorrent配置目录：

Windows系统：打开文件资源管理器，粘贴路径 %APPDATA%\qBittorrent 并回车；

macOS系统：在访达中按 Cmd+Shift+G，输入 ~/Library/Application Support/qBittorrent；

Linux系统：在终端执行 ls -a ~/.config/qBittorrent，确认目录存在。

2、关闭原电脑上的qBittorrent进程，确保所有文件未被锁定；

3、将整个 qBittorrent 文件夹压缩为ZIP或TAR包；

4、在新电脑上安装同版本或更高版本的qBittorrent（建议≥v4.6）；

5、关闭新电脑的qBittorrent，删除其默认生成的空配置目录；

6、将压缩包解压至新电脑对应路径的相同位置，覆盖全部内容；

7、启动qBittorrent，所有任务将显示为“已暂停”，且保留原始保存路径、标签、分类及完成度。

二、BT_backup + fastresume重建法

当原电脑无法访问GUI或配置目录损坏时，此方法利用qBittorrent底层存储结构——BT_backup文件夹中存放的.torrent与.fastresume配对文件，手动重建任务列表，适用于NAS或无界面环境。

1、进入原qBittorrent配置目录，找到子路径 .local/share/qBittorrent/BT_backup（Linux/macOS）或 AppData\Local\qBittorrent\BT_backup（Windows）；

2、确认该目录下存在成对文件：每个 xxx.torrent 对应一个同名 xxx.fastresume；

3、将整个BT_backup文件夹拷贝至新电脑任意位置；

4、在新电脑启动qBittorrent后，依次点击「文件」→「从URL添加种子」→「从本地文件添加」；

5、在文件选择对话框中，按住 Ctrl+A 全选BT_backup内所有.torrent文件，点击「打开」；

6、qBittorrent会自动识别并关联同名.fastresume，恢复原始下载进度、上传/下载速度限制、队列优先级等状态。

三、qbittorrent-torrents-exporter工具导出导入法

该方法专为PT用户及需筛选迁移场景设计，支持按Tracker域名、标签、分类、完成状态等条件批量导出纯净.torrent文件，并自动从.fastresume还原Tracker信息，避免因qBittorrent 4.4+版本移除.torrent内Tracker导致的重定向失败。

1、在原电脑下载并解压 qbittorrent-torrents-exporter.exe（GitHub开源工具）；

2、将原电脑的BT_backup文件夹与该exe置于同一目录；

3、双击运行exe，在提示中输入原qBittorrent WebUI地址（如http://127.0.0.1:8080）、用户名与密码；

4、按需选择导出条件（例如仅导出“已完成”且标签为“HD-BluRay”的种子），回车执行；

5、工具生成export/目录，内含按分类/Tracker组织的.torrent文件；

6、在新电脑qBittorrent中使用「文件」→「从本地文件添加」，一次性导入export/下全部.torrent；

7、所有种子将自动恢复原始Tracker、标签、保存路径，无需手动设置。

四、Docker容器卷迁移法

适用于在Docker中运行qBittorrent的用户，通过直接迁移挂载卷实现零配置切换，所有状态、设置、下载文件均保持绝对一致。

1、在原主机执行 docker inspect qbittorrent，查找Mounts部分中"Source"字段指向的宿主机路径；

2、确认该路径包含config/与downloads/两个子目录，其中config/即为qBittorrent配置目录；

3、停止原容器：docker stop qbittorrent；

4、将整个挂载路径（如 /volume2/docker/qbittorrent）打包压缩；

5、在新主机安装相同镜像（推荐 linuxserver/qbittorrent）；

6、创建新容器时，将压缩包解压后的路径作为config/卷挂载点，downloads/挂载点路径需与原路径一致或通过符号链接映射；

7、启动容器，WebUI将直接加载全部历史任务与设置，下载文件路径自动识别。

五、NAS平台专用迁移法（威联通/群晖）

针对NAS设备，利用系统级文件权限与套件路径特性，绕过WebUI限制，直接操作隐藏配置区，确保包括WebUI密码、端口、SSL证书在内的全量设置不丢失。

1、启用原NAS的SSH服务，使用WinSCP或Terminal登录；

2、定位qBittorrent套件主目录：

威联通：访问 /share/CACHEDEV1_DATA/.qpkg/qBittorrent；

群晖：访问 /volume1/@appstore/qBittorrent 或 /volume*/docker/qbittorrent（依安装方式而定）；

3、完整复制该目录至U盘或远程服务器；

4、在新NAS上安装同版本qBittorrent套件，安装完成后立即停止服务；

5、用相同方式登录新NAS，删除新生成的套件目录，将备份目录原样粘贴覆盖；

6、重启qBittorrent套件，所有任务、RSS、WebUI账户及高级设置（如IP过滤、计划任务）均完全复现。