qBittorrent 部署教程

qBittorrent 是 NAS 影音自动化里最常用的下载器之一。先把它部署稳定，后面接入 MoviePilot 会简单很多。

目录规划

/volume1/docker/
├── appdata/qbittorrent/
└── downloads/
    ├── movies/
    ├── tvshows/
    └── anime/

Compose 配置

在 /volume1/docker/compose/qbittorrent/docker-compose.yml 写入：

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

启动：

docker compose up -d
docker compose logs -f

访问：

http://NAS-IP:8080

初始设置建议

设置项	建议
默认保存路径	/downloads
临时文件路径	/downloads/incomplete
Web UI 密码	首次登录后立即修改
监听端口	6881 或自行固定一个端口
自动分类	电影、剧集、动漫分目录保存

接入 MoviePilot

MoviePilot 和 qBittorrent 如果在同一个 Docker 网络里，可以用容器名访问：

http://qbittorrent:8080

如果不在同一个网络里，就用 NAS 内网 IP：

http://NAS-IP:8080

常见问题

Web 页面打不开

先检查容器是否运行：

docker compose ps

再确认端口没有被其他服务占用。

下载完成后 MoviePilot 找不到文件

通常是路径映射不一致。qBittorrent 和 MoviePilot 看到的下载目录最好都使用 /downloads，这样最不容易出错。

速度不稳定

检查网络、Tracker、硬盘写入性能和端口连通性。不要把下载目录放到性能很差的外接盘上。