说明

为保证用户安全，防止用户因使用反代并代理了127.0.0.1这种情况导致安全性降低，从2023年9月5日更新的镜像开始，创建容器需要新增设置两个环境变量：QB_USERNAME（登陆qBittorrent的用户名）和QB_PASSWORD（登陆qBittorrent的密码）。容器将在创建时使用这两个环境变量去设置（如已存在配置文件则是修改）登陆qBittorent的用户名和密码。如未设置这两个环境变量，或者保持为qBittorrent的默认值（默认用户名：admin，默认密码：adminadmin），则本容器附加的所有脚本、定时任务将无法继续使用。详情。也因此镜像默认即安装好python，不再需要设置INSTALL_PYTHON这个环境变量。

声明

本镜像非魔改版、非快验版、非Enhanced增强版，qBittorrent自身的行为/功能全部未做任何改动（也不会考虑添加或修改官方客户端行为/功能的内容），全部属于官方客户端的默认行为/功能，在和PT站Tracker服务器交互时反馈的一切信息均是qBittorrent官方版反馈的信息。本镜像只是基于官方客户端附加了一些实用的脚本，脚本全部是合理合法使用qBittorrent官方API获取信息，脚本全部行为都集中在本地，与任何远端服务器无任何联系。增加的脚本全部代码在 Github 或 Gitee 均可查看 。绝对不会因为使用此镜像而导致账号被封。

特点

• 自动按tracker分类或打标签（可以选择关闭，可以选择采用qBittorrent中的“分类”还是“标签”）。

• 下载完成发送通知（可以选择关闭），可选途径：钉钉（效果图）, Telegram, ServerChan, 爱语飞飞, PUSHPLUS推送加, 企业微信, Gotify；搭配RSS功能（RSS教程）自动下载效果很好；下载完成后还可以补充运行你的自定义脚本。

• 故障时发送通知，可选途径同上。

• 按设定的cron检查tracker状态，如发现种子的tracker状态有问题，将给该种子添加TrackerError的标签，方便筛选；如果tracker出错数量超过设定的阈值，给设定渠道发送通知。

• 一些辅助功能：批量修改tracker；检测指定文件夹下未做种的子文件夹/文件；生成做种文件清单；生成未做种文件清单；配合IYUU自动重新校验和自动恢复做种；指定设备上线时自动限速；多时段限速；分析指定目录的重复做种率（辅种率）等等。

• 如需要下载完成后自动触发EMBY/JELLYFIN扫描媒体库，触发ChineseSubFinder自动为刚刚下载完成的视频自动下载字幕，请按照 这里 操作。

• 日志输出到docker控制台，可从portainer查看。

• python为可选安装项，设置为true就自动安装。

• 体积小，默认中文UI，默认东八区时区。

• iyuu标签集成了IYUUPlus，自动设置好下载器，减少IYUUPlus设置复杂程度。

标签

1. 4.x.x , latest: 标签以纯数字版本号命名，这是qBittorrent正式发布的稳定版，其中最新的版本额外增加latest标签。Qt: 6.5.2 Libtorrent: 2.0.9 Boost: 1.82.0 OpenSSL:3.1.2 zlib: 1.2.13。

2. 4.x.x-iyuu , latest-iyuu , iyuu: 标签中带有iyuu字样，基于qBittorrent稳定版集成了IYUUPlus，其中最新的版本额外增加latest-iyuu和iyuu标签，自动安装好IYUUPlus，自动设置好下载器，主要针对不会设置下载器的用户。

3. x.x.xalphax, x.x.xbetax , x.x.xrcx , unstable: 标签中带有alpha、beta或rc字样，这是qBittorrent发布的测试版，其中最新的测试版额外增加unstable 标签。此标签仅供测试使用及向qBittorrent官方反馈bug使用。

4. edge: 基于alpine:edge制作的镜像，体积最小，所依赖的组件版本最新，会提供riscv64版本镜像。所有新功能或者BUG修复，或者有任何变化时，都会第一时间更新到此标签。Qt: 6.5.2 Libtorrent: 2.0.9 Boost: 1.82.0 OpenSSL: 3.1.2 zlib: 1.3。

更新日志（仅列出稳定版）

详见：Github 或 Gitee

环境变量清单

在下一节的创建命令中，包括已经提及的变量在内，总共以下环境变量，请根据需要参考创建命令中WEBUI_PORT BT_PORT的形式自行补充添加到创建命令中。

注1：默认值的含义是，你不设置这个环境变量为其他值，那么程序就自动使用默认值。

注2：所有定时任务cron类的环境变量（以CRON这四个字母开头的）在docker cli中请用一对双引号引起来，在docker-compose中不要增加引号。

注3：所有环境变量你都可以不设置，并不影响qbittorrent的使用，但如果你想用得更爽，你就根据你的需要设置。

以下是所有标签均可用的环境变量：

以下是仅iyuu标签额外可用的环境变量：

创建

群晖

1.png

2.png

3.png

4.png

5.png

6.png

7.png

8.png

9.png

10.png

11.png

12.png

安装后访问http://ip:8080。如想使用集成了IYUUPlus的qBittorrent（自动设置好IYUUPlus中的下载器），请使用docker cli以命令行方式部署。

命令行docker cli

• 除WEBUI_PORT BT_PORT PUID PGID这几个环境变量外，如果你还需要使用其他环境变量，请根据环境变量清单按照-e 变量名="变量值" \的形式自行添加在创建命令中。

• armv7设备如若无法使用网络，可能是seccomp问题，详见 这里。可以在创建命令中增加一行--security-opt seccomp=unconfined \ 来解决。

• 创建完成后请访问http://<IP>:<WEBUI_PORT>（如未修改，对安装机默认是http://127.0.0.1:8080）来对qbittorrent作进一步设置，初始用户名密码：admin/adminadmin。如要在公网访问，请务必修改用户名和密码。

• 针对iyuu标签，创建后可访问http://<IP>:8787进行IYUUPlus设置。

## latest标签或unstable标签
docker run -dit \
  -v $PWD/qbittorrent:/data `# 冒号左边请修改为你想在本地保存的路径，这个路径用来保存你个人的配置文件` \
  -e PUID="1000"        `# 输入id -u可查询，群晖必须改` \
  -e PGID="100"         `# 输入id -g可查询，群晖必须改` \
  -e WEBUI_PORT="8080"  `# WEBUI控制端口，可自定义` \
  -e BT_PORT="34567"    `# BT监听端口，可自定义` \
  -p 8080:8080          `# 冒号左右一样，要和WEBUI_PORT一致，命令中的3个8080要改一起改` \
  -p 34567:34567/tcp    `# 冒号左右一样，要和BT_PORT一致，命令中的5个34567要改一起改` \
  -p 34567:34567/udp    `# 冒号左右一样，要和BT_PORT一致，命令中的5个34567要改一起改` \
  --tmpfs /tmp \
  --restart always \
  --name qbittorrent \
  --hostname qbittorrent \
  nevinee/qbittorrent   `# 如想参与qbittorrent测试工作，可以指定测试标签nevinee/qbittorrent:unstable`

## iyuu标签
docker run -dit \
  -v $PWD/qbittorrent:/data `# 冒号左边请修改为你想在本地保存的路径，这个路径用来保存你个人的配置文件` \
  -e PUID="1000"        `# 输入id -u可查询，群晖必须改` \
  -e PGID="100"         `# 输入id -g可查询，群晖必须改` \
  -e WEBUI_PORT="8080"  `# WEBUI控制端口，可自定义` \
  -e BT_PORT="34567"    `# BT监听端口，可自定义` \
  -p 8080:8080          `# 冒号左右一样，要和WEBUI_PORT一致，命令中的3个8080要改一起改` \
  -p 34567:34567/tcp    `# 冒号左右一样，要和BT_PORT一致，命令中的5个34567要改一起改` \
  -p 34567:34567/udp    `# 冒号左右一样，要和BT_PORT一致，命令中的5个34567要改一起改` \
  -p 8787:8787          `# IYUUPlus的WebUI控制端口` \
  --tmpfs /tmp \
  --restart always \
  --name qbittorrent \
  --hostname qbittorrent \
  nevinee/qbittorrent:iyuu

docker compose

新建compose.yml文件如下（docker compose安装方法），创建好后以docker-compose up -d(旧版)或docker compose up -d(新版)命令启动即可。

version: "2.0"
services:
  qbittorrent:
    image: nevinee/qbittorrent  # 如想参与测试工作可以指定nevinee/qbittorrent:unstable，如想使用集成了iyuu的版本请指定nevinee/qbittorrent:iyuu
    container_name: qbittorrent
    restart: always
    tty: true
    network_mode: bridge
    hostname: qbitorrent
    stop_grace_period: 10m # 让qBittorrent程序自行退出后再关闭/删除/重启容器的最长时间，如不设置，则docker默认10秒，这时，种子多的qBittorrent可能还没有完全保存好全部需要保存的信息。
    volumes:
      - ./data:/data      # 配置保存目录
    tmpfs:
      - /tmp
    environment:          # 下面未列出的其他环境变量请根据环境变量清单自行添加
      - WEBUI_PORT=8080   # WEBUI控制端口，可自定义
      - BT_PORT=34567     # BT监听端口，可自定义
      - PUID=1000         # 输入id -u可查询，群晖必须改
      - PGID=100          # 输入id -g可查询，群晖必须改
    ports:
      - 8080:8080        # 冒号左右一致，必须同WEBUI_PORT一样，本文件中的3个8080要改一起改
      - 34567:34567      # 冒号左右一致，必须同BT_PORT一样，本文件中的5个34567要改一起改
      - 34567:34567/udp  # 冒号左右一致，必须同BT_PORT一样，本文件中的5个34567要改一起改
      #- 8787:8787       # 如使用的是nevinee/qbittorrent:iyuu标签，请解除本行注释
    #security_opt:       # armv7设备请解除本行和下一行的注释
      #- seccomp=unconfined

如若想将qbittorrent建立在已经创建好的macvlan网络上，可以按如下方式创建：

version: "2.0"
services:
  qbittorrent:
    image: nevinee/qbittorrent # 如想参与测试工作可以指定nevinee/qbittorrent:unstable，如想使用集成了iyuu的版本，请指定nevinee/qbittorrent:iyuu
    container_name: qbittorrent
    restart: always
    tty: true
    networks: 
      <你的macvlan网络名称>:
        ipv4_address: <你想设置的ip>
        aliases:
          - qbittorrent
    dns:   # docker是无法为macvlan网络提供dns解析服务的，要想正常在macvlan网络上发通知，请给容器添加dns服务器，你也可以直接使用你的网关ip作为dns服务器
      - 223.5.5.5
      - 114.114.114.114
      - 1.2.4.8
    hostname: qbitorrent
    stop_grace_period: 10m # 让qBittorrent程序自行退出后再关闭/删除/重启容器的最长时间，如不设置，则docker默认10秒，这时，种子多的qBittorrent可能还没有完全保存好全部需要保存的信息。
    volumes:
      - ./data:/data
    tmpfs:
      - /tmp
    environment:          # 下面未列出的其他环境变量请根据环境变量清单自行添加
      - WEBUI_PORT=8080   # WEBUI控制端口，可自定义
      - BT_PORT=34567     # BT监听端口，可自定义
      - PUID=1000         # 输入id -u可查询，群晖必须改
      - PGID=100          # 输入id -g可查询，群晖必须改
    #security_opt:        # armv7设备请解除本行和下一行的注释
      #- seccomp=unconfined

networks: 
  <你的macvlan网络名称>:
    external: true

• 创建完成后请访问http://<IP>:<WEBUI_PORT>（如未修改，对安装机默认是http://127.0.0.1:8080）来对qbittorrent作进一步设置，初始用户名密码：admin/adminadmin。如要在公网访问，请务必修改用户名和密码。

• 针对iyuu标签，创建后可访问http://<IP>:8787进行IYUUPlus设置。

目录说明

如果按照上述任何一种部署方式，在映射的目录下会有以下文件夹：

/data                         # 基础路径在容器内为/data，下面所有文件夹均处于/data的下一层，基础路径在宿主机上为你创建容器时映射的
├── cache                     # qbittorrent的缓存目录
├── certs                     # 用来存放ssl证书，默认是空的，可另外使用acme.sh来申请ssl证书
├── config                    # 所有的配置文件保存目录
│   ├── qBittorrent.conf      # **配置文件，很重要，如需恢复配置此文件必须保留**
│   ├── qBittorrent-data.conf # **上传下载数据统计文件，如需恢复配置此文件必须保留**
│   └── rss                   # **rss的配置文件保存目录，如需恢复配置此目录必须保留**
├── data                      # 所有的数据文件保存目录
│   ├── BT_backup             # **当高级设置中恢复文件选择为"Fastresume files"时，种子和快速恢复文件保存目录，如需恢复做种数据此目录必须保留**
│   ├── torrents.db           # **当高级设置中恢复文件选择为"SQLite database"时，种子和快速恢复数据的数据库文件，如需恢复做种数据此文件必须保留**
│   ├── GeoDB                 # IP数据保存目录
│   ├── logs                  # 日志文件保存目录
│   ├── nova3                 # 启用qBittorrent搜索功能后相关文件保存目录
│   └── rss                   # rss订阅下载文件保存目录
├── diy                       # 存放你自己编写的脚本的目录，diy.sh需要存放在此
├── downloads                 # 默认下载目录
├── iyuu_db                   # 仅iyuu标签有此目录，用来保存IYUUPlus的配置文件，IYUUPlus用户须保留此文件夹
├── logs -> data/logs         # 只是个软连接，连接到容器内的/data/data/logs
├── temp                      # 下载文件临时存放目录，默认在配置中未启用
├── torrents                  # 保存种子文件目录，默认在配置中未启用
├── watch                     # 监控目录，监控这个目录下的.torrent文件并自动下载，默认在配置中未启用
└── webui                     # 存放其他webui文件的目录，需要自己存放，默认在配置中未启用

有两个星号标记的文件或目录是重要目录，恢复数据必须要有这几个。

在这里可以查阅所有可用的非官方webui：https://github.com/qbittorrent/qBittorrent/wiki/List-of-known-alternate-WebUIs

相关问题

使用此镜像会导致封号吗

此镜像未修改qbittorrent客户端官方任何信息，在和pt站tracker服务器交互时反馈的一切信息均是qbittorrent官方原版反馈的信息，此镜像只是基于qbittorrent额外增加了一些脚本而已。增加的脚本全部代码在 这里 可以查看，不会因为使用此镜像导致pt账号被封。

如何在运行 dl-finish "%I" 时调用自定义脚本

• 此功能可用版本：4.3.7+；

• 只要你将名为diy.sh的shell脚本放在映射目录下的diy文件夹下即可，容器内路径为/data/diy/diy.sh（hash已存储在名为torrent_hash的变量中，可通过此值获取其他信息）。

• 如想传入除“%K”种子ID之外的其他参数，可以在 设置->下载->Torrent 完成时运行外部程序 下填入这种形式：dl-finish "%K" "%N" "%L" "%F"，必须保证"%K"是第一个参数，后面的参数根据你自己需要调整。在diy.sh中，"%N" "%L" "%F"分别通过$2 $3 $4调用。如：cmd "$2" "$3 "$4"。3, $4分别指传入的第2, 第3, 第4个参数，分别对应"%N" "%L" "%F"。

• 假如你要调用其他语言的脚本，比如python，可以在diy.sh中写上python3 /data/diy/your_python_scripts.py $torrent_hash即可。如需要传入更多参数，请参考上一条在“Torrent 完成时运行外部程序”填入形如dl-finish "%K" "%N" "%L" "%F"的形式，然后在diy.sh中写上python3 /data/diy/your_python_scripts.py "$2" "$3" "$4"。

• 如需要下载完成后自动触发EMBY/JELLYFIN扫描媒体库，触发ChineseSubFinder自动为刚刚下载完成的视频自动下载字幕，请按照 这里 操作。

如何优雅的关闭qbittorrent容器

• 暴力强制关闭qbittorrent容器自然是容易丢失任务的，所以在关闭前应当先将所有种子暂停，过一会再关闭容器。这时，所有的配置文件和torrent恢复文件也都是暂停后的状态，然后再新建容器或重新部署，启动后再开始所有任务。

• 还有一点要注意，千万不要在有下载任务时关闭或重启qbittorrent容器。

如何从其他作者的镜像/套件版转移至本镜像

• 如果启用了ssl/https，请先在原qbittorrent的webui中禁用，或者将qBittorrent.conf中WebUI\HTTPS\Enabled=true改为WebUI\HTTPS\Enabled=false。

• 请注意要优雅的关闭旧容器后再处理配置文件。

• 进入原来容器的映射目录（或原套件版配置文件保存目录，可能是隐藏的）下，在config下分别找到qBittorrent.conf qBittorrent-data.conf rss，在data下找到BT_backup，然后将其参考上面的目录树放在新容器的映射目录下，然后在创建容器时，保证新容器中的下载文件的保存路径和旧容器一致，并新建容器即可。

• 举例说明如何保证新容器中的下载文件的保存路径和旧容器一致，比如旧容器中下载了一个 xxx.2020.BluRay.1080p.x264.DTS-XXX，保存路径为/movies（宿主机上的真实路径为/volume1/home/id/movies），那么在新建新容器时，给新容器增加一个路径映射：/volume1/home/id/movies:/movies　即可。

• 注意新容器的PUID/PGID和要旧容器保持一致。

• 注意在 设置 -> 下载 中勾选 Torrent 完成时运行外部程序 并填入 dl-finish "%K"，如需要https要重新设置证书路径。

可不可以不使用默认下载目录

默认下载目录是/data/downloads，如不想使用默认下载目录，可以额外映射其他路径，比如映射/volume1/media:/media，然后在qbittorrent中设置默认下载目录为/media，也可以在每次下载时自己输入下载目录为/media。

遗忘登陆密码如何重置

# 进入容器
docker exec -it qbittorrent bash

# 如果启用了ssl
curl -k -X POST -d 'json={"web_ui_username":"新的用户名","web_ui_password":"新的密码"}' https://127.0.0.1:${WEBUI_PORT}/api/v2/app/setPreferences

# 如果未启用ssl
curl -X POST -d 'json={"web_ui_username":"新的用户名","web_ui_password":"新的密码"}' http://127.0.0.1:${WEBUI_PORT}/api/v2/app/setPreferences

如何与emby, jellyfin, plex等等配合使用

将需要配合使用的容器的环境变量PUID/PGID设置为一样的即可。

启用了其他非官方webui，导致webui打不开，如何关闭

# 进入容器
docker exec -it qbittorrent bash

# 如果启用了ssl
curl -k -X POST -d 'json={"alternative_webui_enabled":false}' https://127.0.0.1:${WEBUI_PORT}/api/v2/app/setPreferences

# 如果未启用ssl
curl -X POST -d 'json={"alternative_webui_enabled":false}' http://127.0.0.1:${WEBUI_PORT}/api/v2/app/setPreferences

如何自动更新容器

安装watchtower即可，详见 这里

安装了watchtower，如何让qbittorrent不被watchtower自动更新

• 方法1：部署qbittorrent容器时，直接指定标签，如nevinee/qbittorrent:4.3.7；

• 方法2（推荐）：在部署时在命令中添加一个label：com.centurylinklabs.watchtower.enable=false：

  docker cli：

  --label com.centurylinklabs.watchtower.enable=false \
  

  docker-compose:

      labels:
        com.centurylinklabs.watchtower.enable: false
  

为何建议将qbittorrent安装在macvlan网络上

• 可以在网关上给qbittorrent所在ip独立设置限速;

• 如果有用openwrt时，可以让qbittorrent所在ip跳过代理。

将qbittorrent安装在macvlan网络上时，如何使用IYUUAutoReseed自动辅种

将两个容器都安装在同一个macvlan网络上即可，或者直接安装nevinee/qbittorrent:iyuu标签。

如何使用 CRON_ALTER_LIMITS 这个环境变量

• 4.3.8+可用。

• 该功能主要提供给多时段限速场景使用，请在qbittorrent客户端中先设置好”备用速度限制“的限制速率。

• 当设置了有效的MONITOR_IP时，CRON_ALTER_LIMITS的cron不生效（因为会冲突）。

• 设置形式如：0 5 * * *:0 18 * * *|0 8 * * *:0 22 * * *，|前面的cron是启用“备用速度限制”的时间点，|后面的cron是关闭“备用速度限制”的时间点。需要在一天中多次启用“备用速度限制”的，以:分隔每个cron，可以任意个cron，需要多次关闭“备用速度限制”的同样以:分隔每个cron。

• 比如需要在周一至周五的5:00-8:00、17:30-23:30，以及周六、周日的9:00-23:30进行限速，那么可以设置CRON_ALTER_LIMITS为0 5 * * 1-5:30 17 * * 1-5:0 9 * * 0,6|0 8 * * 1-5:30 23 * * *。

• 比如需要在周一至周五的17:30-22:00，以及周六、周日的8:30-23:00进行限速，那么可以设置CRON_ALTER_LIMITS为30 17 * * 1-5:30 8 * * 0,6|0 22 * * 1-5:0 23 * * 0,6。

• 在docker cli中请使用一对双引号引起来，在docker-compose.yml中请勿增加引号。

如何使用 CRON_IYUU_HELP 这个环境变量

• 4.3.8+可用。

• 在设置的时间点执行iyuu-help命令，实现以下功能：

  1. 检查下载清单（就是qbittorrent筛选“下载”的清单），检测该清单中处于暂停状态、并且下载完成率为0%（辅种的种子在校验前也是0%）的种子，将这些种子请求重新校验。已经请求过校验并且完成率大于0%的种子不会再次校验。
  2. 检查暂停清单（就是qbittorrent筛选“暂停”的清单），检测该清单中100%下载完成/100%校验通过的种子，将这些种子恢复做种。校验未通过不达100%完成率的种子不会启动，仍然保持暂停状态。

• 配合IYUUAutoReseed，将CRON_IYUU_HELP设置在IYUUAutoReseed自动辅种任务的cron以后，并运行若干次即可（因为校验比较费时，所以要多次运行）。

• 比如你IYUUAutoReseed辅种任务的cron是22 7 * * *，你想从辅种任务3分钟后，每10分钟运行一次，共运行4次，那么可以设置CRON_IYUU_HELP为：25-55/10 7 * * *。

• 在docker cli中请使用一对双引号引起来，在docker-compose.yml中请勿增加引号。

qBittorrent使用https的webui时，iyuu如何连接

• 当qBittorrent使用https的webui时，iyuu连接qBittorrent需要使用https://<域名>:<端口>的形式，不能使用https://<IP>:<端口>，所以需要在创建iyuu容器（使用nevinee/qbittorrent:iyuu时同样也需要）指定域名和ip的对应关系。

• 命令行创建iyuu容器时时，增加--add-host <域名>:<qBittorrent容器的IP>，其中域名是你在公网上访问qBittorrent的webui的域名，如果直接使用的nevinee/qbittorrent:iyuu标签，就是--add-host <域名>:127.0.0.1。

• docker compose创建时，增加以下内容：

      extra_hosts:
        - "<域名>:<qBittorrent容器的IP>"  ## 如果直接使用的`nevinee/qbittorrent:iyuu`标签，IP就是127.0.0.1
  

qBittorrent占用了巨大的内存，如何调整

你所见到的占用巨大的内存并不是真的占用了，使用docker stats qbittorrent输出的内存占用更准确一点，其他方式输出的内存占用会非常的大。因为libtorrent-rasterbar v2.x把内存使用交给内核来处理，内核会自己根据内存大小和读取频次来自动决定怎么去缓存，所以不要被看起来庞大的内存占用给吓着了。详见libtorrent-rasterbar作者的原话。

谷歌翻译如下：

总结一下，libtorrent2.0使用内存映射文件。在除windows之外的所有现代操作系统上，在块设备级别使用统一的页面缓存，其中匿名内存（由swapfile支持）和内存映射文件（包括共享库，运行可执行文件）都是同一缓存的一部分。Linux可能是决定如何在物理RAM中平衡这些页面的最复杂的工具。

使用内存映射文件的好处主要有：

内核（它知道机器有多少物理RAM可用）最了解何时以及以何种顺序刷新缓存。也许更重要的是，决定保留读缓存的数量和时间。

某些类型的存储可以由CPU直接寻址，就像它是RAM一样，绕过了许多内核基础设施，并提供了非常高的性能。（linux称此DAX）

此外，当报告libtorrent（特别是mmap磁盘后端）中的问题时，仅仅指出vmstats数字表明内核决定使用大量物理内存进行磁盘缓存是不够的。这是内存映射磁盘后端的一个特性。

命令

自动运行的命令（所有标签可用，由设置的cron或在下载完成时自动运行，当然也可以手动运行）

# 发送通知
docker exec qbittorrent notify "测试消息标题" "测试消息通知内容"

# 将种子按tracker进行分类，由CRON_AUTO_CATEGOR设置的cron来调用
docker exec qbittorrent auto-cat -a  # 由程序自动调用，也可手动运行。当CATEGORY_OR_TAG=category时，将所有未分类的种子按tracker分类；当CATEGORY_OR_TAG=tag时，对所有种子按tracker打标签
docker exec qbittorrent auto-cat -A  # 需要手动运行。当CATEGORY_OR_TAG=category时，将所有种子按tracker分类；当CATEGORY_OR_TAG=tag时，对所有种子按tracker打标签

# 将指定种子按tracker进行分类，会自动在下载完成时运行一次（由 dl-finish <hash> 命令调用）
docker exec qbittorrent auto-cat -i <hash>   # hash可以在种子详情中的"普通"标签页上查看到

# 下载完成时将种子分类，并发送通知，已经在配置文件中填好了
docker exec qbittorrent dl-finish <hash>     # hash可以在种子详情中的"普通"标签页上查看到

# 检查qbittorrent是否宕机，如宕机则发送通知，由CRON_HEALTH_CHECK设置的cron来调用
docker exec qbittorrent health-check

# 检查所有种子的tracker状态是否有问题，如有问题，给该种子添加一个 TrackerError 的标签，由CRON_TRACKER_ERROR设置的cron来调用
docker exec qbittorrent tracker-error

# 每分钟检测MONITOR_IP设置的ip是否在线，如有任何一个ip在线，则启用“备用速度限制”，4.3.8+可用。
docker exec qbittorrent detect-ip

## 启用可关闭“备用速度限制”，4.3.8+可用，由CRON_ALTER_LIMITS设置的cron来调用
docker exec qbittorrent alter-limits on    # 启用“备用速度限制”
docker exec qbittorrent alter-limits off   # 关闭“备用速度限制”

## IYUUAutoReseed辅助任务，自动重校验、自动恢复做种，4.3.8+可用，由CRON_IYUU_HELP设置的cron来调用
docker exec qbittorrent iyuu-help

需要手动运行的命令（所有标签可用）

# 查看qbittorrent日志，也可以直接在portainer控制台中看到
docker logs -f qbittorrent

# 批量修改tracker，详见下面效果图，4.3.7+可用，有两种使用方式，请运行下面命令查看两种方式
docker exec -it qbittorrent change-tracker -h

# 批量删除tracker，4.4.4+可用，有两种使用方式，请运行下面命令查看两种方式
docker exec -it qbittorrent remove-tracker -h

# 检测指定文件夹下没有在qbittorrent客户端中做种或下载的子文件夹/子文件，由用户确认是否删除，详见下面效果图，4.3.8+可用
# 从4.4.4起，更改成可以一次性检测多个目录
docker exec -it qbittorrent del-unseed-dir

# 当CATEGORY_OR_TAG=category时，将所有种子按tracker分类；当CATEGORY_OR_TAG=tag时，对所有种子按tracker打标签。4.3.9+可用
docker exec qbittorrent auto-cat -A

# 生成本qBittorrent客户端中所有做种文件清单，4.3.9+可用
docker exec -it qbittorrent report-seed-files

# 生成指定路径下没有在本qBittorrent客户端做种的文件清单，4.3.9+可用
docker exec -it qbittorrent report-unseed-files

# 分析指定目录的重复做种率（辅种率），具体说明请运行下列命令，4.5.3+可用
docker exec -it qbittorrent gen-dup

仅“iyuu”标签可用的命令

# 更新IYUUPlus脚本
docker exec -it qbittorrent git -C /iyuu pull

# 重启IYUUPlus
docker exec -it qbittorrent php /iyuu/start.php restart -d 

参考

• crazymax/qbittorrent , 参考了Dockerfile;

• 80x86/qbittorrent, 借鉴了标签和分类的理念。

源代码、问题反馈、意见建议

如果镜像好用，请点亮star。全套代码见 Github 或 Gitee。如有使用上的问题，或者有其他好的功能建议，请在 Github这里 或 Gitee这里 提交。