qBittorrent Docker 部署指南

qBittorrent 官方提供了 Docker 镜像，可以在 NAS、服务器或任何支持 Docker 的设备上运行，实现 24 小时挂机下载。主流的 Docker 镜像包括官方 qbittorrent/qBittorrent 和社区维护的 linuxserver/qbittorrent。本文以更流行的 linuxserver 镜像为例进行说明。

Docker 部署的优势

• 24小时运行：无需保持电脑开机，NAS或服务器可以长期运行
• 环境隔离：不会影响宿主系统的网络配置和软件环境
• 快速迁移：只需备份配置目录和docker-compose.yml，即可迁移到任意设备
• 资源可控：通过Docker限制CPU和内存使用，避免影响其他服务

使用 docker-compose 部署（推荐）

创建 docker-compose.yml 文件：

```yaml version: "3" services: qbittorrent: image: linuxserver/qbittorrent:latest container_name: qbittorrent environment:

• PUID=1000
• PGID=1000
• TZ=Asia/Shanghai
• WEBUI_PORT=8080

volumes:

• ./config:/config
• ./downloads:/downloads

ports:

• 8080:8080
• 6881:6881
• 6881:6881/udp

restart: unless-stopped ```

启动容器：

```bash docker-compose up -d ```

启动后访问 http://你的服务器IP:8080 即可进入 WebUI。默认用户名 admin，默认密码在容器日志中查看：

```bash docker logs qbittorrent | grep password ```

使用 docker run 单行部署

```bash docker run -d \ --name=qbittorrent \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Asia/Shanghai \ -e WEBUI_PORT=8080 \ -p 8080:8080 \ -p 6881:6881 \ -p 6881:6881/udp \ -v /path/to/config:/config \ -v /path/to/downloads:/downloads \ --restart unless-stopped \ linuxserver/qbittorrent:latest ```

关键配置说明

• PUID/PGID：容器内运行的用户ID和组ID，应与宿主机上存放下载文件的目录权限匹配。在宿主机执行 id $USER 查看当前用户的UID和GID
• 端口映射：8080为WebUI访问端口，6881为BT数据传输端口（TCP+UDP都需要）。如果8080端口冲突，修改左边数字即可
• 数据持久化：/config目录存储qBittorrent的所有配置和下载任务列表，务必备份此目录；/downloads是默认下载路径
• 时区设置：TZ=Asia/Shanghai确保日志时间和调度任务使用北京时间

NAS 设备适配说明

群晖 (Synology)

在群晖 Docker 套件中搜索 linuxserver/qbittorrent，下载后按界面配置即可。如果使用 docker-compose，需在群晖上先安装 Container Manager 并通过 SSH 执行。

威联通 (QNAP)

在 Container Station 中创建应用程序，粘贴上述 docker-compose.yml 内容，注意将卷路径改为威联通的共享文件夹路径（如 /share/Download）。

获取 qBittorrent

本站收录 Windows 版本安装包

下载 qBittorrent