nevinee/qbittorrent
nevinee
qBittorrent 5.1.2（qB 5.1.2）具备下载完成通知与文件自动分类功能，支持IYUU辅助工具，可批量删除与修改Tracker（TK），并能对出错的Tracker（TK）进行标记，同时集成了PT辅助脚本以优化PT站使用体验。
266 次收藏下载次数: 0状态：社区镜像维护者：nevinee仓库类型：镜像最近更新：1 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
因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获取信息，脚本全部行为都集中在本地，与任何远端服务器无任何联系。增加的脚本全部代码在 https://github.com/devome/dockerfiles/tree/master/qbittorrent 或 https://gitee.com/evine/dockerfiles/tree/master/qbittorrent 均可查看 。绝对不会因为使用此镜像而导致账号被封。
特点
-
自动按
tracker分类或打标签（可以选择关闭，可以选择采用qBittorrent中的“分类”还是“标签”）。 -
下载完成发送通知（可以选择关闭），可选途径：钉钉（https://gitee.com/evine/dockerfiles/raw/master/qbittorrent/pictures/notify.png）, ***, ServerChan, 爱语飞飞, PUSHPLUS推送加, 企业微信, Gotify；搭配RSS功能（RSS教程）自动下载效果很好；下载完成后还可以补充运行你的自定义脚本。
-
故障时发送通知，可选途径同上。
-
按设定的cron检查tracker状态，如发现种子的tracker状态有问题，将给该种子添加
TrackerError的标签，方便筛选；如果tracker出错数量超过设定的阈值，给设定渠道发送通知。 -
一些辅助功能：批量修改tracker；检测指定文件夹下未做种的子文件夹/文件；生成做种文件清单；生成未做种文件清单；配合IYUU自动重新校验和自动恢复做种；指定设备上线时自动限速；多时段限速；分析指定目录的重复做种率（辅种率）等等。
-
如需要下载完成后自动触发EMBY/JELLYFIN扫描媒体库，触发ChineseSubFinder自动为刚刚下载完成的视频自动下载字幕，请按照 https://github.com/devome/dockerfiles/tree/master/qbittorrent/diy 操作。
-
日志输出到docker控制台，可从portainer查看。
-
python为可选安装项，设置为true就自动安装。 -
体积小，默认中文UI，默认东八区时区。
-
iyuu标签集成了https://github.com/ledccn/IYUUPlus，自动设置好下载器，减少IYUUPlus设置复杂程度。
效果图
源代码、问题反馈、意见建议
如果镜像好用，请点亮star。如有使用上的问题，或者有其他好的功能建议，请在 https://github.com/devome/dockerfiles/issues 或 https://gitee.com/evine/dockerfiles/issues 提交。
提交bug必须反馈的信息，如不反馈以下信息，我就直接无视了。
-
创建命令或
docker-compose.yml文件，请自行对密码打码； -
使用的docker镜像的tag，以及qBittorrent的版本；
-
进入容器后运行
bash -x /usr/local/bin/<命令名>如bash -x /usr/local/bin/report-seed-files的输出，请自行对密码打码。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 qbittorrent 镜像标签
docker pull docker.xuanyuan.run/nevinee/qbittorrent:<标签>
DockerHub 原生拉取命令
docker pull nevinee/qbittorrent:<标签>
更多 qbittorrent 镜像推荐
linuxserver/qbittorrent
LinuxServer.io 社区镜像
这是由LinuxServer.io提供的Qbittorrent容器，Qbittorrent作为一款开源、轻量且功能全面的BitTorrent客户端，支持跨平台运行，具备强大的种子管理、下载调度及远程控制功能；该容器化部署方案便于用户快速搭建、高效管理，适用于家庭服务器、NAS设备或企业级存储环境，为文件共享与下载任务提供稳定可靠的运行环境。
1.7千 次收藏1亿+ 次下载
5 天前更新
kasmweb/qbittorrent
kasmweb
qBittorrent for Kasm Workspaces
26 次收藏10万+ 次下载
2 天前更新
crazymax/qbittorrent
crazymax
基于Alpine Linux的qBittorrent Docker镜像，提供轻量级、高效的开源BitTorrent客户端服务，适用于BT下载与管理。
11 次收藏100万+ 次下载
3 天前更新
wernight/qbittorrent
wernight
Lightweight qBittorrent-NoX (i.e. headless) torrent client and one of the most feature complete
60 次收藏100万+ 次下载
1 年前更新
superng6/qbittorrent
superng6
qBittorrent中国优化版是一款针对中国网络环境深度优化的全平台BT下载工具，支持x86-64、arm64、arm32等主流处理器架构，集成本地化节点加速、合规性调整及用户习惯适配功能，为国内用户提供高效、稳定且符合使用习惯的下载体验。
127 次收藏50万+ 次下载
24 天前更新
emmercm/qbittorrent
emmercm
Headless qBittorrent client with remote web interface.
4 次收藏10万+ 次下载
23 天前更新
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"