qBittorrent：下载工具

带网页界面的 BitTorrent 客户端，可以从任何设备提交任务，由 NAS 在后台完成下载。

只下载你有权获取的内容

使用 BitTorrent 时你同时在上传。请遵守所在地区的法律法规和网站规则，只用于合法内容（开源镜像、有授权的资源、自己的文件分发）。本站不提供任何规避版权保护的方法。

部署

services:
  qbittorrent:
    image: lscr.io/linuxserver/qbittorrent:latest
    container_name: qbittorrent
    restart: unless-stopped
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
      - WEBUI_PORT=8080
    ports:
      - "8080:8080"
      - "6881:6881"
      - "6881:6881/udp"
    volumes:
      - /vol1/docker/qbittorrent/config:/config
      - /vol1/downloads:/downloads

PUID/PGID 决定容器内进程的身份，要和你希望的文件属主一致，否则下载完的文件在 NAS 上可能没有权限访问。首次启动后从容器日志里获取临时密码，登录后立刻修改。

目录规划

建议分成三层，避免正在下载的文件和已完成的混在一起：

/vol1/downloads/
  incomplete/   # 下载中
  complete/     # 已完成
  torrents/     # 种子文件备份

在设置中指定「保存路径」和「未完成文件路径」。做好这个分离之后，媒体库只扫描 complete 目录，就不会把下载了一半的文件当成影片。

对硬盘的影响

下载是持续随机写入，会让硬盘无法休眠，长期挂 PT 的机器基本别指望静音。缓解办法：

• 把「未完成文件路径」放在固态盘上，完成后再移动到机械盘。
• 限制全局连接数和上传槽位，减少碎片化写入。
• 在 Btrfs 上，下载目录关闭写时复制可以减少碎片，见存储进阶。

数据与备份

config 目录里是配置和任务列表，备份它可以避免重装后重新添加所有任务。下载的内容一般不需要备份（可重新获取）。

已知坑

• 网页界面不要暴露到公网，它能操作 NAS 上的文件路径。
• 容器重启后任务状态依赖 config 目录，这个目录一定要持久化。
• 磁盘写满时任务会全部报错，配好容量告警。

参考资料

• qBittorrent 官方网站