Skip to content

workerspages/qBittorrent-Rclone

BranchesTags

Repository files navigation

qBittorrent Enhanced Edition + WebDAV (PaaS 单端口终极版)

这是一个专为现代 PaaS (Platform as a Service) 平台部署优化的 Docker 镜像项目。它集成了 qBittorrent Enhanced Edition (增强版) 与 Rclone，不仅提供强大的 BT/PT 下载功能，还内置了轻量级的 WebDAV 服务供本地拉取文件。

🔥 核心突破 (单端口架构)： 针对 Koyeb, Render, Heroku 等严格限制只允许对外暴露一个 HTTP 端口的 PaaS 平台，本镜像内置了 Caddy 轻量级反向代理服务器。它能将一个公网端口完美分发给内部的两个独立服务：

  • 访问根路径 / ➡️ 路由至 qBittorrent 面板
  • 访问路径 /webdav/* ➡️ 路由至 Rclone WebDAV 服务

✨ 核心特性

  • 单端口双服务：利用 Caddy 代理，彻底突破 PaaS 单端口限制。
  • 自动构建最新版：通过 GitHub Actions 自动获取并编译最新静态核心。
  • PaaS 深度优化：
    • 支持通过环境变量 QBT_USER 自定义 qBittorrent 登录账号。
    • 自动注入默认密码，绕过新版 qBittorrent 终端随机密码锁死机制。
    • 动态适配 PaaS 平台强行注入的 $PORT 环境变量。
    • 容器启动时自动清除 IP 封禁记录（防 PaaS 网关被 Ban），并自动修复 /data 目录读写权限。
  • 双端镜像推送：自动将镜像推送到 Docker Hub 和 GHCR。

⚙️ 环境变量 (Environment Variables)

部署时，您可以通过设置以下环境变量来配置容器：

变量名 默认值 说明
QBT_USER admin qBittorrent WebUI 面板的登录用户名。
QBT_PASS adminadmin 将 QBT_PASS 的值更新为你刚刚在 WebUI 中修改的新明文密码(注意，这密码是给qBittorrent API登录用的)。
PORT 8080 对外暴露的唯一公网 HTTP 端口。大部分 PaaS 会自动注入此变量。
WEBDAV_USER admin WebDAV 服务的登录用户名，强烈建议修改。
WEBDAV_PASS password WebDAV 服务的登录密码，强烈建议修改。
TZ Asia/Shanghai 容器时区。
BARK_SERVER https://api.day.app Bark通知 服务器地址。
BARK_KEY 您的Bark设备Key请填在这里 Bark 密钥。
RCLONE_CMD (空) rclone move -v "{source_path}" "OneDrive:视频专区/{torrent_name}/"
RCLONE_CONFIG_BASE64 (空) (可选) 为了方便在平台注入您的 rclone 配置，可以使用 cat rclone.conf | base64 -w 0 获得的完整字符串填入此处，容器启动将自动识别。
MAX_CONCURRENT_FILES 3 每个合集（每个独立的种子任务）中同时下载 3 个文件。
ONLY_VIDEO_FILES false 设置为 true 时，开启纯视频下载模式，种子中所有非视频文件都会被自动标记为“不下载”
VIDEO_EXTENSIONS mp4,mkv,avi,wmv,mov,ts,rmvb,webm,flv,f4v,... 自定义被认定为“视频”的扩展名（用英文逗号分隔）
MIN_FREE_SPACE_GB 10 当剩余空间小于 10GB 时就会刹车暂停

(注：由于采用了单端口代理架构，之前的 WEBDAV_PORT 变量已弃用，内部已自动接管。)

  • MIN_FREE_SPACE_GB: 设为 10（默认值即为 10）。当剩余空间小于 10GB 时就会刹车暂停。
  • 注意：要让这个“暂停-释放-恢复”的循环完全自动化，请确保你的环境变量中设置了 RCLONE_UPLOAD_MODE=move。这样一旦有文件下载完成，entrypoint.sh 里面的脚本就会把它剪切到网盘，从而腾出本地空间。空间一腾出来，被暂停的种子就会自动继续下载。
  • 常用视频格式: mp4,mkv,avi,wmv,mov,ts,rmvb,webm,flv,f4v,m4v,mpg,mpeg,vob,m2ts,mts,3gp,rm,asf,ogv,mxf,dat 已内置，如无需修改只添加 ONLY_VIDEO_FILES=true即开启纯视频下载模式

正确的密码修改流程

为了确保网盘安全且自动化脚本正常工作，以后修改密码请遵循以下 4 步：

  1. WebUI 内修改： 在 qBittorrent 网页端的“设置 -> WebUI”中修改并保存你的新密码。
  2. 修改环境变量： 去到你的 Docker 部署环境（例如 Portainer 面板、群晖容器管理器、PaaS 平台的环境变量设置，或者本地的 docker-compose.yml 文件中）。
  3. 更新明文： 将 QBT_PASS 的值更新为你刚刚设置的新明文密码。
  4. 重启/重建容器： 重新启动该 Docker 容器。容器重启后，后台脚本就会读取到新的密码，和 qBittorrent 本体再次成功“接头”。

📂 目录结构与数据持久化 (Volumes)

为了防止容器重启导致数据丢失，请在部署时，挂载持久化存储卷 (Volume) 到容器内的 /data 目录：

  • /data/config：存储 qBittorrent 的配置文件和种子校验数据。
  • /data/downloads：默认下载保存路径。WebDAV 服务仅会暴露此目录。
  • /data/rclone：预留的 Rclone 配置文件目录。

🚀 部署指南

1. 在 Koyeb / Render 等单端口 PaaS 平台部署

  1. 在控制台创建新的 Web Service 或 App。
  2. 镜像来源选择 Docker，填入：您的DockerHub账号/qbittorrent-ee-rclone:latest (或 GHCR 链接)。
  3. 设置端口 (Ports)：仅暴露一个 HTTP 端口，填写 8080 (平台通常会自动将其映射到 80 和 443)。
  4. 环境变量 (Env Vars)：添加 QBT_USER, WEBDAV_USER, WEBDAV_PASS。
  5. 持久化存储 (Volumes)：创建一个 Volume，挂载路径必须填写 /data。
  6. 点击部署即可。

2. 在 Zeabur 等支持多端口的 PaaS 平台部署

操作基本同上。虽然 Zeabur 支持多端口，但由于本镜像已升级为单端口架构，您现在只需要为它生成唯一的一个域名即可同时访问面板和 WebDAV！建议在 Zeabur 的“网络”设置中，额外开启 6881 (TCP) 的端口转发以加速 BT 下载。

3. 本地使用 Docker Compose 测试

version: "3.8"
services:
  qbittorrent:
    image: ghcr.io/workerspages/qbittorrent-rclone:latest
    container_name: qbittorrent-webdav
    restart: unless-stopped
    environment:
      - QBT_USER=admin
      - PORT=8080
      - WEBDAV_USER=admin
      - WEBDAV_PASS=mypassword
      - TZ=Asia/Shanghai
      - MAX_CONCURRENT_FILES=3  # 每个合集（每个独立的种子任务）中同时下载 3 个文件

      # Bark 通知环境变量
      - BARK_SERVER=https://api.day.app
      - BARK_KEY=您的Bark设备Key请填在这里

      - MIN_FREE_SPACE_GB=10  # 当剩余空间小于 10GB 时就会刹车暂停
    ports:
      - "8080:8080" # Caddy 统一代理端口 (同时包含 WebUI 和 WebDAV)
      - "6881:6881" # BT TCP
      - "6881:6881/udp" # BT UDP
    volumes:
      - ./data:/data

💡 访问与使用说明

部署成功并绑定域名后（假设您的域名是 https://my-app.koyeb.app）：

1. 访问 qBittorrent 面板

  • 地址：直接访问根域名 https://my-app.koyeb.app
  • 初始账号：您在 QBT_USER 中设置的值（默认 admin）
  • 初始密码：adminadmin

⚠️ 警告：请在首次登录后，立即前往 工具 (Tools) -> 选项 (Options) -> Web UI 中修改密码！

2. 连接 WebDAV 服务拉取文件

WebDAV 服务挂载在 /webdav 路径下。请在本地电脑终端运行 rclone config，按以下参数配置：

  • 新建远端类型 (Type)：webdav
  • URL 输入：https://my-app.koyeb.app/webdav/ (注意：必须带有 /webdav/ 后缀！)
  • Vendor 选择：other
  • User 输入：您设置的 WEBDAV_USER
  • Password 输入：您设置的 WEBDAV_PASS

Rclone 拉取命令示例：

配置完成后（假设远端命名为 paas-webdav）：

将云端下载好的文件拉取到本地，并自动删除云端文件以释放 PaaS 空间：

rclone move -Pv paas-webdav:/ "Z:\下载目录\" --delete-empty-src-dirs --transfers 1 --retries 10 --buffer-size 16M

本地 rclone 的配置

Option url.
URL of http host to connect to.
E.g. https://example.com.
Enter a value.
url> https://qbittorrent-rclone.zeabur.app/webdav

Option vendor.
Name of the WebDAV site/service/software you are using.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Fastmail Files
   \ (fastmail)
 2 / Nextcloud
   \ (nextcloud)
 3 / Owncloud 10 PHP based WebDAV server
   \ (owncloud)
 4 / ownCloud Infinite Scale
   \ (infinitescale)
 5 / Sharepoint Online, authenticated by Microsoft account
   \ (sharepoint)
 6 / Sharepoint with NTLM authentication, usually self-hosted or on-premises
   \ (sharepoint-ntlm)
 7 / rclone WebDAV server to serve a remote over HTTP via the WebDAV protocol
   \ (rclone)
 8 / Other site/service or software
   \ (other)
vendor> 7

Option user.
User name.
In case NTLM authentication is used, the username should be in the format 'Domain\User'.
Enter a value. Press Enter to leave empty.
user> admin

Option pass.
Password.
Choose an alternative below. Press Enter for the default (n).
y) Yes, type in my own password
g) Generate random password
n) No, leave this optional password blank (default)
y/g/n> y
Enter the password:
password:
Confirm the password:
password:

Option bearer_token.
Bearer token instead of user/pass (e.g. a Macaroon).
Enter a value. Press Enter to leave empty.
bearer_token>

Edit advanced config?
y) Yes
n) No (default)
y/n>

Configuration complete.
Options:
- type: webdav
- url: https://qbittorrent-rclone.zeabur.app/webdav
- vendor: rclone
- user: admin
- pass: *** ENCRYPTED ***
Keep this "paas-webdav" remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d>

在这里，针对我们镜像中内置的 WebDAV 服务（由 rclone 提供），您有两种选择，推荐选择第 7 项：

🛠️ 选择指南

  1. 输入 7 (rclone)： 这是最完美的匹配。因为我们的镜像内部正是使用 rclone serve webdav 启动的服务，选择 7 可以获得最佳的兼容性。
  2. 或者输入 8 (other)： 这也是通用的选择，通常不会有问题。

⏩ 接下来的完整操作步骤（参考）：

完成 vendor 选择后，请按以下步骤继续：

  1. user (用户名)： 输入您在 Zeabur 环境变量中设置的 WEBDAV_USER（默认是 admin）。
  2. pass (密码)：
  • 选择 y (Yes type in my own password)。
  • 输入您在环境变量中设置的 WEBDAV_PASS（输入时屏幕不会显示字符）。
  • 再次输入确认。
  1. bearer_token： 直接回车跳过（Leave empty）。
  2. Edit advanced config?： 输入 n (No)。
  3. Keep this "paas-webdav" remote?： 输入 y (Yes) 确认保存。

🧪 测试连接是否成功

配置完成后，您可以直接在终端输入以下命令测试一下（假设您的远端命名为 paas-webdav）：

rclone lsd paas-webdav:/

如果您能看到 /data/downloads 目录下的内容，说明整套“云端下载 + 本地拉取”的链路已经彻底打通了！

*Powered by qBittorrent-Enhanced-Edition, Rclone & Caddy*

About

这是一个专为现代 PaaS (Platform as a Service) 平台部署优化的 Docker 镜像项目。它集成了 qBittorrent Enhanced Edition (增强版) 与 Rclone，不仅提供强大的 BT/PT 下载功能，还内置了轻量级的 WebDAV 服务供本地拉取文件

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages