xinebf/qbittorrent

xinebf/qbittorrent 镜像说明

镜像概述

本镜像基于开源BitTorrent客户端qBittorrent构建，提供轻量级、跨平台的 torrent 下载与管理能力。通过Web UI即可完成任务配置与监控，无需本地安装客户端，适用于合法资源的点对点传输场景。

核心功能

• Web UI管理: 浏览器访问即可添加、暂停、删除torrent任务，查看下载进度与种子信息。
• 多协议支持: 兼容BitTorrent协议、Magnet链接及种子文件导入。
• 资源控制: 可自定义下载/上传速度限制、连接数上限等参数。
• 持久化存储: 通过目录挂载保存配置文件、下载数据及共享资源，确保重启后数据不丢失。

使用场景

• 合法开源软件、免费文档等资源的下载与分享。
• 个人媒体资源的跨设备同步（需确保内容符合***）。
• 小型团队内部文件的高效点对点传输。

配置说明

目录挂载

需提前创建本地目录并挂载至容器对应路径：

• ~/data/qbittorrent/config/: 存储qBittorrent配置文件。
• ~/data/qbittorrent/share/: 存储共享数据（如种子元信息）。
• ~/data/qbittorrent/store/: 存储下载完成的文件。

端口映射

默认Web UI端口为8080，建议映射至主机空闲端口（如9090）。

启动命令

临时测试运行

bash
mkdir -p ~/data/qbittorrent/{config,share,store}
docker run --rm -v ~/data/qbittorrent/config/:/home/qbtuser/.config/qBittorrent/ -it xinebf/qbittorrent qbittorrent-nox

后台持久运行

bash
docker run \
    --name qbittorrent \
    -p 9090:8080 \
    -v ~/data/qbittorrent/config/:/home/qbtuser/.config/qBittorrent/ \
    -v ~/data/qbittorrent/share/:/home/qbtuser/.local/share/data/qBittorrent/ \
    -v ~/data/qbittorrent/store/:/home/qbtuser/Downloads/ \
    --restart always \
    -d xinebf/qbittorrent

NGINX反向代理配置

若需通过域名访问Web UI，可使用以下NGINX配置（需替换127.0.0.1:8080为实际容器地址）：

nginx
location /qbt/ {
    proxy_pass         http://127.0.0.1:8080/;
    proxy_http_version 1.1;
    http2_push_preload on;

    proxy_set_header   Host               127.0.0.1:8080;
    proxy_set_header   X-Forwarded-Proto  $scheme;
    proxy_set_header   X-Forwarded-Host   $http_host;
    proxy_set_header   X-Forwarded-For    $remote_addr;
    proxy_set_header   X-Real-IP          $remote_addr;

    # 可选：调整POST请求大小以支持批量添加torrent
    # client_max_body_size 100M;

    # 为session cookie设置Secure标志（适用于HTTPS场景）
    proxy_cookie_path / "/; Secure";
}

更多细节参考https://github.com/qbittorrent/qBittorrent/wiki/NGINX-Reverse-Proxy-for-Web-UI%E3%80%82