承上启下
上一篇基本完成了通过群晖 Container Manager 手动下载并创建安装 Jellyfin (Docker 版本)的教程说明。
接下来的两篇就是安排【下载器】- qbittorrent 和 自动刮削服务(神秘)的内容咯,感兴趣的朋友欢迎留言,一起讨论 O(∩_∩)O。
前置条件
- 群晖NAS
- 正常安装 Container Manager 应用
安装&使用步骤
流程大纲
- 创建共享文件夹(上一篇已完成,本次略过)
- 在 Container Manager >项目>新增 通过“创建 docker compose.yml” 进行创建
- 启动服务后,进行调试和配置,再测试下载功能进行验收
一、通过 docker compose 创建并启动 qbittorrent 服务
启动 Container Manager,并在 Container Manager >项目>新增 通过“创建 docker compose.yml” 进行创建

- docker compose.yaml 代码内容
本次安装的是 linuxserver/qbittorrent 这个镜像(官方信息参考 附录一)
services:
qbittorrent:
image: lscr.io/linuxserver/qbittorrent:latest
container_name: qbittorrent
environment:
- PUID=1000
- PGID=1000
- TZ=Asia/Shanghai
- WEBUI_PORT=8081
- TORRENTING_PORT=6881
volumes:
- /volume1/Dockers/qbittorrent/appdata:/config
- /volume1/QB_Downloads:/downloads
ports:
- 8081:8081
- 6881:6881
- 6881:6881/udp
restart: unless-stopped
容器启动时,可以通过 compose 内指定各种参数来调整容器的行为和设置。例如可以设置端口映射、环境变量、卷挂载等参数来满足特定的需求。
以下为本文使用到的参数说明(对应的 environment/volumes/port 就是字面意思)
| 参数项 | 功能说明 |
|---|---|
8081:8081 | WebUI 的访问端口,映射关系—外部端口:容器内部端口 |
6881:6881 | tcp 数据连接端口,映射关系—外部端口:容器内部端口 |
6881:6881/udp | udp 数据连接端口,映射关系—外部端口:容器内部端口 |
PUID=1000 | UserID 群晖的用户id,一般来说群晖系统创建的第一个用户id是 1026 |
PGID=1000 | GroupID 群晖的用户组id |
TZ=Asia/Shanghai | 指定服务使用的时区 |
WEBUI_PORT=8081 | 指定 WebUI 的容器内部端口 |
TORRENTING_PORT=6881 | 指定数据(种子)连接的 tcp/udp 容器内部端口 |
/xxx:/config | 指定存储配置配置文件的目录地址 |
/xxx:/downloads | 指定存储配置媒体文件的目录地址 |
下一步启动服务
服务会优先下载镜像(如果注册表内存在镜像就会跳过下载环节)

二、通过端口8081 访问 WebUI
注意了,这里新版本的 qbittorrent 服务,初始密码需要在服务日志内查询(用户名 admin)

访问 Container Manager 对应的 qbittorrent 服务启动日志

常见的问题
① 登入 qbittorrent 提示 Unauthorize
如果是内网环境,可以访问WebUI的情况下进入WebUI的设置界面>取消CSRF保护

或者直接手动修改配置文件 ~/.config/qBittorrent/qBittorrent.conf
在[Preferences]中 设置
WebUI\HostHeaderValidation=false
WebUI\CSRFProtection=false附录一:官方的 docker 镜像说明/教程地址 https://hub.docker.com/r/linuxserver/qbittorrent
