qBittorrent 搭建 + 换肤 Vuetorrent 教程:宝塔面板 + Docker Compose 完整指南

1.介绍

qBittorrent 是一款开源、免费且功能强大的 BitTorrent 客户端,旨在提供一个轻量级但功能丰富的 P2P(点对点)文件共享体验。它是 µTorrent(uTorrent) 的一个优秀替代品,支持多种平台(Windows、macOS、Linux)。

官网:https://www.qbittorrent.org/

项目地址:https://github.com/qbittorrent/qBittorrent


qBittorrent 主要特点

免费 & 开源

  • 采用 GPLv2 许可证,完全免费,没有广告或恶意软件。
  • 源代码开源,安全透明,可供用户和开发者自由审查或修改。

轻量 & 低资源占用

  • 运行时占用内存和 CPU 资源较低,适合低配置设备使用。

无广告

  • 纯净无广告,体验优于许多商业 BitTorrent 客户端。

功能丰富

  • 磁力链接(Magnet Links):支持磁力链接下载,无需种子文件。
  • 种子搜索:内置搜索引擎,可直接搜索 BT 资源(需要 Python 支持)。
  • RSS 订阅 & 自动下载:可自动追踪最新的种子资源。
  • 远程管理:支持 Web UI,可通过浏览器远程管理下载任务。
  • 队列管理:可设置下载优先级,管理多个任务。
  • IP 过滤:可使用 IP 黑名单,提高隐私与安全性。
  • UPnP / NAT-PMP 端口映射:提升下载速度,减少手动端口配置的麻烦。

跨平台

  • 支持 Windows、macOS、Linux 等操作系统。

qBittorrent vs 其他 BT 客户端

特性 qBittorrent μTorrent BitTorrent Deluge Transmission
免费 & 开源 ❌(有广告) ❌(有广告)
无广告
内置搜索引擎
RSS 订阅
远程管理
轻量级

2.基于宝塔面板的Docker Compose

2.1复制以下docker compose代码

services:
qbittorrent:
image: linuxserver/qbittorrent:5.0.4-libtorrentv1
container_name: qbittorrent
environment:
- PUID=0
- PGID=0
- TZ=Asia/Shanghai 
- UMASK_SET=022
- WEBUI_PORT=8085 # Web UI端口
- TORRENTING_PORT=26881 # 监听端口,默认6881,修改为20000-65535区间值,下同
volumes:
- /qbittorrent/vol1/docker/qbittorrent/config:/config # 冒号左侧修改参照上文
- /qbittorrent/vol2/Download2:/downloads2
- /qbittorrent/vol3/Download3:/downloads3 #同上
ports:
- 8085:8085 # 同上面Web UI端口一致
- 26881:26881
- 26881:26881/udp
restart: unless-stopped

 

2.2打开宝塔面板docker页面 按照图中内容执行

 

2.3等待镜像拉取完成后 关闭添加日志

2.4查看编排日志给出的webui地址 以及管理员账户和密码

 

2.5下载WebUI皮肤Vuetorrent

项目地址:https://github.com/VueTorrent/VueTorrent/releases/tag/v2.22.0

 

2.6将下载的vuetorrent.zip解压至qbittorrent所映射的文件夹

 

2.7进入搭建的qBittorrent后台

http://localhost:8085 (注:localhost改为自己的IP地址)

填入2.4步骤所给出的账号密码

 

2.8 将语言改为中文 + 更改WebUI皮肤为Vuetorrent

WebUI路径为:/config/qBittorrent/skin/vuetorrent

2.9大功告成