安装
本文安装基于Ubuntu与Docker-ce,对于其他环境,Docker的命令也应该是通用的。

DockerHub 上附带 qBittorrent Web UI的 qBittorent 客户端镜像为:

linuxserver/qbittorrent

拉取镜像
docker pull linuxserver/qbittorrent
Bash

创建对应目录并编写 Docker-Compose 文件
cd ~
mkdir qBittorrent #创建qbitorrent数据文件夹
cd qBittorrent
mkdir config downloads #创建配置文件目录与下载目录
vim docker-compose.yml #创建并编辑文件
Bash

vim 复制如下内容并按需修改:

version: "2"
services:
qbittorrent:
image: linuxserver/qbittorrent
container_name: qbittorrent
environment:
- PUID=1000
- PGID=1000
- TZ=Asia/Shanghai # 你的时区
- UMASK_SET=022
- WEBUI_PORT=8081 # 将此处修改成你欲使用的 WEB 管理平台端口
volumes:
- /home/qb/config:/config # 绝对路径请修改为自己的config文件夹
- /home/d:/downloads # 绝对路径请修改为自己的downloads文件夹
ports:
# 要使用的映射下载端口与内部下载端口,可保持默认,安装完成后在管理页面仍然可以改成其他端口。
- 6881:6881
- 6881:6881/udp
# 此处WEB UI 目标端口与内部端口务必保证相同,见问题1
- 8081:8081
restart: unless-stopped

Bash

执行docker-compose
docker-compose up -d # docker-compose

执行后,如果得法,访问 ip:web-ui-port 即可进入管理页面。

默认用户名密码admin/adminadmin

Bash

开始使用qBittorrent
访问ip:port,进入 WebUI 管理界面。

修改页面为中文界面
打开如下面板:

Tool->Options->WebUI
将Language修改为简体中文,并点击最下方的Save即可。

修改下载与上传使用的端口
运营商可能会对常用的 BT/PT 端口(6881,688x)进行限速,大多数 PT 站会拒绝这些端口的请求。
修改端口方法如下:

工具->选项->连接
将监听端口修改为 PT 站接受的端口。

可能遇到的问题
网页管理平台白屏无内容
检查 docekr-compose.yml 文件中的 WEBUI_PORT 与 端口映射是否都为一个端口。如果端口映射中内部端口与外部端口不同,可能会导致白屏。

如何访问下载的文件
可以通过FTP、Samba或者基于 Web 的目录程序访问对应目录。我推荐使用同样基于 Docker 的FileBrowser进行在线文件管理。