镜像来源：nevinee/qbittorrent - Docker Image

了解更多功能请查看作者博客：一款更懂你的 qbittorrent docker 镜像

qBittorrent Docker镜像使用说明

重要说明

为保障使用安全，自2023年9月5日更新的镜像起，创建容器时必须新增设置两个环境变量：

  • QB_USERNAME：qBittorrent登录用户名

  • QB_PASSWORD：qBittorrent登录密码

容器将通过这两个变量初始化或修改登录信息。若未设置，或保持默认值（默认用户名admin、默认密码adminadmin），镜像附加的所有脚本、定时任务将无法使用。
此外，镜像默认已安装Python，无需额外设置INSTALL_PYTHON环境变量。
详细背景可参考相关说明。

镜像声明

本镜像为官方原版增强版，非魔改、非快验、非Enhanced版本：

  • qBittorrent自身功能/行为未做任何修改，与官方客户端完全一致，和PT站Tracker交互时反馈的信息均为官方原版数据。

  • 仅附加实用脚本，所有脚本通过qBittorrent官方API合法获取信息，运行行为限于本地，不与任何远端服务器交互。

  • 脚本代码完全开源，可在Github或Gitee查看。

  • 使用本镜像不会导致账号被封。

功能特点

核心功能

  • 自动分类/打标签：按种子tracker自动分类或打标签（支持关闭；可选择使用qBittorrent的“分类”或“标签”功能）。

  • 下载完成通知：支持关闭；可选通知途径：钉钉（效果图）、***、ServerChan、爱语飞飞、PUSHPLUS推送加、企业微信、Gotify；可搭配RSS自动下载使用，且支持运行自定义脚本。

  • 故障告警：容器或服务故障时发送通知，途径同上。

  • tracker状态监控：按设定cron周期检查tracker状态，异常种子自动添加TrackerError标签，便于筛选；错误数量超阈值时触发通知。

辅助功能

  • 批量修改tracker信息；

  • 检测指定文件夹下未做种的子文件夹/文件；

  • 生成做种文件清单、未做种文件清单；

  • 集成IYUUPlus标签，自动配置下载器，简化IYUUPlus设置；

  • 支持下载完成后触发EMBY/JELLYFIN媒体库扫描、ChineseSubFinder字幕自动下载（操作方法见DIY指南）。

compose.yml 配置文件

services:
  qbittorrent:
    image: nevinee/qbittorrent:5.1.2
    container_name: qbittorrent
    restart: always
    tty: true
    network_mode: host
    hostname: qbitorrent
    stop_grace_period: 10m # 让qBittorrent程序自行退出后再关闭/删除/重启容器的最长时间
    deploy:
      resources:
        limits:
          cpus: '0'
          memory: 2048M #内存使用限制2g
    tmpfs:
      - /tmp
    environment:
      - PUID=0
      - PGID=0
      - TZ=Asia/Shanghai
      - BT_PORT=52550
      - WEBUI_PORT=8989
      - QB_USERNAME=admin
      - QB_PASSWORD=password
    ports:
      - 8989:8989
      - 52550:52550
      - 52550:52550/udp 
    volumes:
      - /data/docker/qbittorrent:/data #配置保存目录
      - /data/downloads:/data/downloads #下载目录