nevinee/qbittorrent repository overview

---

⁠因Docker Hub简介有字数限制，详细教程及全部说明请见 我的博客⁠。

⁠说明

从2026年5月26日v5.2.1开始，删除环境变量QB_USERNAME和QB_PASSWORD，不再需要设置，改用qB新支持的API KEY的方式来实现认证。不再默认安装python，如有需要请设置EXTRA_PACKAGES，增加python3。

⁠声明

本镜像非魔改版、非快验版、非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设置复杂程度。

⁠效果图

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

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

提交bug必须反馈的信息，如不反馈以下信息，我就直接无视了。

- 创建命令或 docker-compose.yml 文件，请自行对密码打码；

- 使用的docker镜像的tag，以及qBittorrent的版本；

- 进入容器后运行 bash -x /usr/local/bin/<命令名> 如 bash -x /usr/local/bin/report-seed-files 的输出，请自行对密码打码。