superng6/qbittorrent

Docker qBittorrent 中国优化版

简介

Docker qBittorrent 中国优化版是针对国内BT下载场景定制的容器化方案，基于qBittorrent核心，默认配置贴合国内网络环境，支持多平台架构，开箱即用，无需复杂设置。

核心优势

1. 全平台适配：覆盖x86-64、arm64、arm32架构，兼容PC、服务器、嵌入式设备（如树莓派）等多种硬件。
2. 本地化配置：默认简体中文界面，上海时区（Asia/Shanghai），无需手动调整语言与时区。
3. 国内网络优化：针对国内BT环境优化默认配置，开放BT标准端口（TCP/UDP 6881），默认启用DHT加速；自动同步最新trackers列表（来自XIU2/TrackersListCollection项目），提升资源发现效率。
4. 权限安全：支持usermapping，使用宿主用户权限运行容器，避免文件权限混乱（群晖用户尤其需要）。
5. 纯净轻量：仅包含qBittorrent核心服务，无多余组件；自编译静态版本，镜像体积小，同步更新官方最新版qBittorrent。

支持架构

更新日志

• 2021/07/14

  • 更新qBittorrent至4.3.5、4.3.6版本；
  • 优化外网访问401"unauthorized"问题：默认勾选“禁用Host header属性验证”，建议内外网使用相同端口。

• 2021/02/04

  • 更新qBittorrent至4.3.3版本。

• 2021/01/14

  • 默认禁用Host header属性验证（解决修改宿主机端口后无法访问webui的问题）；
  • 推荐使用4.3.1版本（4.3.2版本存在任务添加后不自动开始的问题）。

• 2020/11/28

  • 换回自编译静态版本，镜像体积大幅减小；
  • 新增版本控制，支持下载历史版本qBittorrent。

• 2020/04/13

  • 新增启动容器时自动更新trackers功能（脚本基于gshang2017项目修改）。

• 2020/04/09

  • 基于linuxserver/qbittorrent构建，保留原项目稳定性；
  • 集成优化配置文件，默认中文、上海时区，减少手动设置。

• 2020/02/03

  • 首次提交，优化镜像体积，支持x86-64、arm64架构。

界面预览

使用指南

基础挂载路径

容器运行需挂载以下目录：

• /config：存放qBittorrent配置文件（如设置、种子列表等）；
• /downloads：下载文件保存目录。

群晖部署步骤

1. 获取用户UID/GID

通过SSH登录群晖系统，执行命令 id 你的用户ID（如 id admin），获取当前用户的UID和GID（后续配置需使用）。

2. 权限设置

• 对Docker配置文件夹根目录（如 /volume1/docker/qbittorrent/config）右键“属性”→“权限”，添加当前用户，仅勾选“读取”“写入”权限，取消“管理”权限；
• 下载文件夹根目录（如 /volume1/downloads）执行相同权限设置。

3. 配置参考

（配合以下截图操作）

Linux部署命令

1. 获取用户UID/GID

执行 id 你的用户ID（如 id ubuntu），记录UID和GID。

2. Docker命令启动

替换命令中的 PUID（用户UID）、PGID（用户GID）、挂载路径（/配置文件位置 和 /下载位置）后执行：

bash
docker create  \
    --name=qbittorrent  \
    -e WEBUIPORT=8080  \
    -e PUID=1026 \  # 替换为实际UID
    -e PGID=100 \   # 替换为实际GID
    -e TZ=Asia/Shanghai \
    -p 6881:6881  \  # BT监听端口(TCP)
    -p 6881:6881/udp  \  # BT监听端口(UDP)
    -p 8080:8080  \  # WebUI端口
    -v /配置文件位置:/config  \  # 本地配置目录
    -v /下载位置:/downloads  \  # 本地下载目录
    --restart unless-stopped  \
    superng6/qbittorrent:latest

3. Docker Compose配置

创建 docker-compose.yml 文件，填入以下内容（替换挂载路径和UID/GID）：

yaml
version: "2"
services:
  qbittorrent:
    image: docker.xuanyuan.run/superng6/qbittorrent
    container_name: qbittorrent
    environment:
      - PUID=1026  # 替换为实际UID
      - PGID=100   # 替换为实际GID
      - TZ=Asia/Shanghai
    volumes:
      - /path/to/appdata/config:/config  # 本地配置目录
      - /path/to/downloads:/downloads    # 本地下载目录
    ports:
      - 6881:6881
      - 6881:6881/udp
      - 8080:8080
    restart: unless-stopped

相关链接

• 项目博客：[[]]
• Docker Hub：[[]]
• GitHub：[[]]