chisbread/qbittorrent

chisbread/qbittorrent 镜像文档

镜像概述

chisbread/qbittorrent是基于qBittorrent的定制化Docker镜像，专为PT（Private Tracker）下载场景优化，核心特点是集成了“快速hash校验”功能。该功能通过修改libtorrent库实现（详见https://github.com/ChisBread/libtorrent%EF%BC%89%EF%BC%8C%E5%8F%AF%E6%98%BE%E8%91%97%E6%8F%90%E5%8D%87%E5%A4%A7%E6%96%87%E4%BB%B6%E6%88%96%E5%A4%A7%E9%87%8F%E7%A7%8D%E5%AD%90%E7%9A%84hash%E6%A0%A1%E9%AA%8C%E9%80%9F%E5%BA%A6%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E5%AF%B9%E4%B8%8B%E8%BD%BD%E6%95%88%E7%8E%87%E6%9C%89%E8%BE%83%E9%AB%98%E8%A6%81%E6%B1%82%E7%9A%84PT%E7%94%A8%E6%88%B7%E3%80%82

核心功能与特性

• 快速hash校验：基于定制化libtorrent库，优化hash校验算法，提升校验速度
• 完整qBittorrent功能：保留原版qBittorrent的全部功能，包括Web UI管理、BT/PT协议支持、种子管理等
• 容器化部署：简化部署流程，支持跨平台运行，配置持久化存储

使用场景

• PT下载用户，特别是需要处理大量种子或大体积文件的场景
• 对hash校验速度有较高要求的BT/PT下载环境
• 希望通过容器化方式快速部署qBittorrent的个人或家庭用户

使用方法

基本部署命令

bash
docker 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 \
  chisbread/qbittorrent:latest

参数说明

环境变量（-e）

端口映射（-p）

卷挂载（-v）

其他参数

访问方式

部署完成后，通过浏览器访问 http://<主机IP>:8080 即可打开qBittorrent Web管理界面，默认用户名/密码为 admin/adminadmin（首次登录需修改密码）。

注意事项

• PUID/PGID建议设置为宿主机当前用户的ID，避免文件权限问题（可通过id命令查看当前用户ID）
• 确保宿主机的防火墙已开放映射的端口（6881 TCP/UDP、8080 TCP）
• 下载目录（downloads）建议使用较大容量的存储分区
• 如需修改Web界面端口，需同时调整环境变量WEBUI_PORT和端口映射中的主机端口与容器端口