chisbread/qbittorrent
chisbread
为PT下载定制的“快速hash校验”版qBittorrent，相关修改详见https://github.com/ChisBread/libtorrent
45 次收藏下载次数: 0状态：社区镜像维护者：chisbread仓库类型：镜像最近更新：4 年前
让 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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
chisbread/qbittorrent 镜像文档
镜像概述
chisbread/qbittorrent是基于qBittorrent的定制化Docker镜像，专为PT（Private Tracker）下载场景优化，核心特点是集成了“快速hash校验”功能。该功能通过修改libtorrent库实现（详见https://github.com/ChisBread/libtorrent），可显著提升大文件或大量种子的hash校验速度，适用于对下载效率有较高要求的PT用户。
核心功能与特性
- 快速hash校验：基于定制化libtorrent库，优化hash校验算法，提升校验速度
- 完整qBittorrent功能：保留原版qBittorrent的全部功能，包括Web UI管理、BT/PT协议支持、种子管理等
- 容器化部署：简化部署流程，支持跨平台运行，配置持久化存储
使用场景
- PT下载用户，特别是需要处理大量种子或大体积文件的场景
- 对hash校验速度有较高要求的BT/PT下载环境
- 希望通过容器化方式快速部署qBittorrent的个人或家庭用户
使用方法
基本部署命令
bashdocker run -d \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Asia/Shanghai \ -e WEBUI_PORT=8080 \ -p 6881:6881 \ -p 6881:6881/udp \ -p 8080:8080 \ -v $PWD/config:/config \ -v $PWD/downloads:/downloads \ --restart unless-stopped \ docker.xuanyuan.run/chisbread/qbittorrent:latest
参数说明
环境变量（-e）
| 参数名 | 说明 | 默认值 |
|---|---|---|
| PUID | 运行容器内应用的用户ID，用于文件权限控制 | 1000 |
| PGID | 运行容器内应用的用户组ID，用于文件权限控制 | 1000 |
| TZ | 容器时区设置，如Asia/Shanghai、Europe/London等 | 无 |
| WEBUI_PORT | Web管理界面端口，需与端口映射中的主机端口保持一致 | 8080 |
端口映射（-p）
| 容器端口 | 主机端口 | 协议 | 说明 |
|---|---|---|---|
| 6881 | 6881 | TCP | BT下载数据传输端口 |
| 6881 | 6881 | UDP | BT下载数据传输端口（UDP协议） |
| 8080 | 8080 | TCP | Web管理界面端口，需与WEBUI_PORT一致 |
卷挂载（-v）
| 主机目录 | 容器目录 | 说明 |
|---|---|---|
| $PWD/config | /config | 存储qBittorrent配置文件，实现配置持久化 |
| $PWD/downloads | /downloads | 下载文件存储目录 |
其他参数
| 参数 | 说明 |
|---|---|
| --restart unless-stopped | 容器退出时自动重启（除非手动停止） |
| -d | 后台运行容器 |
访问方式
部署完成后，通过浏览器访问 http://<主机IP>:8080 即可打开qBittorrent Web管理界面，默认用户名/密码为 admin/adminadmin（首次登录需修改密码）。
注意事项
- PUID/PGID建议设置为宿主机当前用户的ID，避免文件权限问题（可通过
id命令查看当前用户ID） - 确保宿主机的防火墙已开放映射的端口（6881 TCP/UDP、8080 TCP）
- 下载目录（downloads）建议使用较大容量的存储分区
- 如需修改Web界面端口，需同时调整环境变量
WEBUI_PORT和端口映射中的主机端口与容器端口
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 qbittorrent 镜像标签
docker pull docker.xuanyuan.run/chisbread/qbittorrent:<标签>
DockerHub 原生拉取命令
docker pull chisbread/qbittorrent:<标签>
更多 qbittorrent 镜像推荐
linuxserver/qbittorrent
LinuxServer.io 社区镜像
这是由LinuxServer.io提供的Qbittorrent容器，Qbittorrent作为一款开源、轻量且功能全面的BitTorrent客户端，支持跨平台运行，具备强大的种子管理、下载调度及远程控制功能；该容器化部署方案便于用户快速搭建、高效管理，适用于家庭服务器、NAS设备或企业级存储环境，为文件共享与下载任务提供稳定可靠的运行环境。
1.7千 次收藏1亿+ 次下载
9 天前更新
kasmweb/qbittorrent
kasmweb
qBittorrent for Kasm Workspaces
26 次收藏10万+ 次下载
7 天前更新
crazymax/qbittorrent
crazymax
基于Alpine Linux的qBittorrent Docker镜像，提供轻量级、高效的开源BitTorrent客户端服务，适用于BT下载与管理。
11 次收藏100万+ 次下载
13 天前更新
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等主流处理器架构，集成本地化节点加速、合规性调整及用户习惯适配功能，为国内用户提供高效、稳定且符合使用习惯的下载体验。
126 次收藏50万+ 次下载
8 天前更新
emmercm/qbittorrent
emmercm
Headless qBittorrent client with remote web interface.
4 次收藏10万+ 次下载
8 天前更新
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"