nas搭建qbittorrent下载

简介

qBittorrent 是一款免费的开源种子下载工具，被广泛作为 µTorrent 的替代品，在 Windows、Linux 和 macOS 等平台上提供一致的功能。把它跑在 NAS 上，下载任务就从个人电脑转移到家中常开的设备上，不必一直开着电脑守进度。它支持种子文件与磁力链接两种添加方式，并提供做种、tracker 编辑、下载优先级设置、RSS 订阅等能力，适合想把 NAS 打造成家庭下载中心与追更终端的用户，也适合需要长期挂做种任务的人。

核心功能

• 种子文件与磁力链接：既可添加本地 .torrent 文件，也可直接粘贴磁力链接创建任务，覆盖两类最常见的资源入口。
• 做种与 tracker 编辑：任务下载完成后可持续做种，并在任务属性里编辑 tracker 列表，替换失效或速度慢的 announce 地址。
• 下载优先级设置：可对单个任务或任务内的具体文件设置优先级，先拿最需要的文件，其余文件排队等待后续带宽。
• RSS 订阅自动下载：按关键词建立 RSS 规则，匹配到新条目后自动加入下载队列，用于追番、追剧集更新。
• WebUI 网页界面：部署完成后通过浏览器访问 WebUI 管理页，桌面与手机共用同一页面，无需在每个设备上另装客户端。
• Docker 镜像可选：群晖可在 Container Manager 的注册表中搜索 qBittorrent，下载 linuxserver/qbittorrent，版本选择 latest。
• 跨平台一致功能：Windows、Linux、macOS 上功能相同，桌面端积累的操作习惯可直接迁移到 NAS 端使用。

使用场景

• 家庭媒体库补片源：把下载目录指向 NAS 上的影视共享目录，下载完成后播放器可直接读取，无需再做搬运。
• 追番与剧集追更：用 RSS 规则匹配字幕组或站点的更新条目，新集发布后自动排队，省去每天手动找资源。
• 长期做种：NAS 常开，适合挂长周期做种任务，配合 tracker 编辑定期清理失效条目，保持任务列表干净。
• 出门后的远程管理：用手机浏览器打开 WebUI 查看进度、调整限速、暂停任务或新增链接，不必回到电脑前。
• 多容器编排：用 Docker Compose 把 qBittorrent 与媒体库、播放器等容器一起定义，实现容器集群的快速编排与统一管理。
• 国产 NAS 扩展：绿联可在应用中心直接点“安装”；极空间等系统基于 Linux 且集成了 Docker，可用容器方式拓展 NAS 功能。

安装与获取步骤

1. 先选路线：在 NAS 上装 qBittorrent 常见有三条路——系统自带套件中心直接装、Docker 部署、源码编译；实测 Docker 综合体验最好。
2. 走应用中心路线：打开【应用中心】找到 qBittorrent 应用，点击“安装”，选择存储空间后点“下一步”继续。
3. 选择下载目录：通过该应用下载的文件会存储在该目录，建议指向空间充足、且播放器容易读取的共享目录。
4. 走 Docker 路线：在 Container Manager -> 注册表 中搜索 qBittorrent，下载 linuxserver/qbittorrent，版本选择 latest，创建容器时映射配置目录与下载目录。
5. 访问 WebUI：部署完成后在浏览器输入 NAS 地址与 WebUI 端口进入管理页；自带界面观感一般，可参考 https://wiki.slarker.me/unraid/qbittorrent_webui.html 更换界面。
6. 补齐后续配置：添加并整理 tracker、建立 RSS 下载规则，可对照 https://wiki.slarker.me/synology/qbittorrent.html 与相关部署指南逐项核对。

与同类方案的区别

• 对比 deluge 与 transmission：社区里有人试过这两者后又回到 qBittorrent，讨论见 https://www.reddit.com/r/selfhosted/comments/150prwk/docker_alternative_to_qbittorrentnox/。
• 对比 qBittorrent-nox：nox 是无图形界面的版本，相关讨论集中在它的 Docker 替代方案上，适合只在服务器端跑的场景。
• 对比套件中心与 Docker：套件中心一键完成、省事；Docker 需要自己映射目录与端口，但配置文件与数据位置更可控，便于迁移重建。

注意事项

• 下载目录要与所选存储空间匹配，避免指向空间不足的卷，否则任务会在写入时失败。
• 用容器方式运行时务必把配置目录映射到宿主机，容器被删除后任务列表与设置才会保留。
• WebUI 的访问地址、端口与账号以实际部署结果为准，不同 NAS 系统的界面菜单位置也以官方页面为准。
• tracker 列表需定期清理失效条目；RSS 规则的关键词设得过宽会拉进大量无关条目，建议先小范围试跑。
• 各系统入口不同：绿联在【应用中心】，群晖在套件中心（搜不到需先解锁第三方套件源），极空间走 Docker，操作前先确认自己属于哪一类。
• 镜像版本选 latest 时，拉取到的新版本行为可能变化，改动前先备份配置目录，避免规则与任务丢失。