qBittorrent：强大的开源 BT、PT 下载器

一. 前言

在数字化时代，数据的传输和共享变得更加便捷，但也带来了许多挑战。无论是下载软件、视频、文档，还是分享个人文件，如何高效、安全地完成这些任务，始终是用户关注的焦点。在众多的文件传输工具中，qBittorrent 作为一种开源的、免费的，基于 peer-to-peer（P2P）的文件传输工具，凭借其强大的速度和卓越的安全性，成为了众多用户的首选工具。

二. 介绍

qBittorrent 是一款开源的跨平台 BitTorrent 客户端，旨在为用户提供高效、安全的文件下载体验。作为免费且无广告的工具，它支持在 Windows、macOS 和 Linux 上运行，并能通过种子文件或磁力链接下载各类资源。由活跃的社区维护，确保了软件的纯净性和稳定性，适合从业余用户到经验丰富的下载者。

此外，qBittorrent 具备强大的功能，包括内置搜索引擎、种子管理、带宽优化、隐私保护等。它能够满足各种需求，无论是快速下载还是安全使用，都能提供出色表现。本文将详细介绍 qBittorrent 的主要特点及使用方法，帮助读者轻松实现高效、安全的文件下载。

三. 效果预览

四. 相关地址

Docker Hub：https://hub.docker.com/r/nevinee/qbittorrent

五. 部署教程

1. Docker CLI:

docker run -d \
  --name qbittorrent \
  --restart unless-stopped \
  --network host \
  --tty \
  --cpus='2' \
  --memory='2g' \
  -e WEBUI_PORT=8989 \
  -e BT_PORT=34567 \
  -e PUID=0 \
  -e PGID=0 \
  -e TZ=Asia/Shanghai \
  -e QB_USERNAME=admin \
  -e QB_PASSWORD=adminadmin \
  -v $(pwd)/qbittorrent:/data \
  -v $(pwd)/qbittorrent/config:/config \
  -v $(pwd)/downloads:/downloads \
  nevinee/qbittorrent:4.6.0

2. Docker Compose:

version: '3'

services:
  qbittorrent: # qbittorrent 服务的定义
    image: nevinee/qbittorrent:4.6.0              # 拉取固定版本镜像
    container_name: qbittorrent                   # 容器名称
    restart: unless-stopped                       # 重启策略
    network_mode: host                            # 网络配置
    tty: true                                     # 为容器分配一个伪终端，适合需要交互的应用
    deploy:                                       # 配置服务器部署
      resources:                                  # 资源限制配置
        limits:                                   # 定义资源限制
          cpus: '2'                               # 限制容器最多使用的 CPU 核心数为 2
          memory: 2G                              # 限制容器最多使用的内存为 2GB
    environment:
      - WEBUI_PORT=8989                           # WEBUI 控制端口
      - BT_PORT=34567                             # BT 监听端口
      - PUID=0                                    # 设置运行容器的用户 ID，群晖必须改
      - PGID=0                                    # 设置运行容器的组 ID，群晖必须改
      - TZ=Asia/Shanghai                          # 设置时区
      - QB_USERNAME=admin                         # 设置用户名
      - QB_PASSWORD=adminadmin                    # 设置密码
    volumes:
      - ./qbittorrent:/data                       # 映射 qb 容器数据路径
      - ./qbittorrent/config:/config              # 映射 qb 容器配置路径
      - ./downloads:/downloads                    # 映射 qb 下载的路径（修改为自己具体下载地址）

# /data                          # 基础路径在容器内为/data，下面所有文件夹均处于/data的下一层，基础路径在宿主机上为你创建容器时映射的
#├── cache                       # qbittorrent的缓存目录
#├── certs                       # 用来存放ssl证书，默认是空的，可另外使用acme.sh来申请ssl证书
#├── config                      # 所有的配置文件保存目录
#│     ├── qBittorrent.conf      # **配置文件，很重要，如需恢复配置此文件必须保留**
#│     ├── qBittorrent-data.conf # **上传下载数据统计文件，如需恢复配置此文件必须保留**
#│     └── rss                   # **rss的配置文件保存目录，如需恢复配置此目录必须保留**
#├── data                        # 所有的数据文件保存目录
#│     ├── BT_backup             # **当高级设置中恢复文件选择为"Fastresume files"时，种子和快速恢复文件保存目录，如需恢复做种数据此目录必须保留**
#│     ├── torrents.db           # **当高级设置中恢复文件选择为"SQLite database"时，种子和快速恢复数据的数据库文件，如需恢复做种数据此文件必须保留**
#│     ├── GeoDB                 # IP数据保存目录
#│     ├── logs                  # 日志文件保存目录
#│     ├── nova3                 # 启用qBittorrent搜索功能后相关文件保存目录
#│     └── rss                   # rss订阅下载文件保存目录
#├── diy                         # 存放你自己编写的脚本的目录，diy.sh需要存放在此
#├── downloads                   # 默认下载目录
#├── iyuu_db                     # 仅iyuu标签有此目录，用来保存IYUUPlus的配置文件，IYUUPlus用户须保留此文件夹
#├── logs -> data/logs           # 只是个软连接，连接到容器内的/data/data/logs
#├── temp                        # 下载文件临时存放目录，默认在配置中未启用
#├── torrents                    # 保存种子文件目录，默认在配置中未启用
#├── watch                       # 监控目录，监控这个目录下的.torrent文件并自动下载，默认在配置中未启用
#└── webui                       # 存放其他webui文件的目录，需要自己存放，默认在配置中未启用