qBittorrent（群晖套件版）

qBittorrent 是家庭影音下载管理的核心组件。
本文使用群晖套件方式安装，避免复杂容器参数配置。

前置条件

• 群晖 NAS 已完成基础配置（参考 群晖 NAS）
• 已安装第三方套件源（可使用 https://imnks.com/pkg/）
• 已创建下载用共享文件夹（例如 downloads）

1. 安装 qBittorrent 套件

1. DSM 打开套件中心。
2. 搜索 qBittorrent。
3. 安装并启动。
4. 首次登录 WebUI 后立即修改默认密码。

2. 基础参数设置

下载路径

1. 将默认下载路径指向 NAS 共享目录。
2. 建议区分：downloads/incomplete 与 downloads/completed。
3. 与 Alist 联动时，媒体目录尽量固定，避免频繁改路径。

网络与连接

1. 检查 WebUI 端口不冲突。
2. 如果需要更高公网连接质量，可按需做端口映射。
3. 不熟悉公网映射时，优先内网使用，先保证稳定。

RSS 自动化

1. 添加站点 RSS 地址。
2. 配置过滤规则（剧集名、分辨率、字幕组关键词）。
3. 小批量验证后再全量自动化，避免误下。

3. 与家庭影院联动

1. 下载完成后由 Alist 统一展示目录。
2. Apple TV（Infuse）通过 Alist/WebDAV 播放。
3. 建议建立规范命名，提升刮削匹配成功率。

4. 稳定运行建议

• 避免把下载目录放在系统盘根目录。
• 观察磁盘空间阈值，预留至少 15% 空间。
• 定期清理长期无种任务，避免无效占用连接数。
• 重要配置修改前做快照/备份。

常见问题

Q: WebUI 无法访问？

先确认套件状态是否运行，再检查端口占用和 DSM 防火墙放行规则。

Q: 速度慢是套件问题吗？

多数情况不是。通常由源健康度、带宽、端口连通性、磁盘写入瓶颈导致。

Q: RSS 自动下载经常误命中怎么办？

先收窄关键词和分辨率条件，启用“仅匹配全部关键词”的过滤策略。

相关文档

• 群晖 NAS — 套件平台与磁盘规划
• Alist — 下载后资源聚合与分发
• Apple TV — 终端播放体验优化

---

适用方式：群晖套件版 · 最后验证：2026-02-15