前言

种子和磁力链接是现在使用最为广泛的资源下载形式，但有时即使找到了种子资源，也会面临墙、网速、高额收费等限制问题，导致难以顺利下载。

qBittorrent 是一款开源免费的种子和磁力链接下载工具，支持 Windows、Mac 和 Linux 平台，功能非常强大。它不仅支持下载和管理BT、磁力链接等各种下载文件，还具有WebUI功能，可远程访问和管理。

通过把 qBittorrent 部署到个人的 VPS，就能离线下载到 VPS，再按需从 VPS 取回本地。

相关准备&链接

• 服务器/VPS（最好用国外的，硬盘/流量越多越好）
• 服务器需要安装docker、docker-compose环境
• 宝塔、Caddy、Nginx、Nginx Proxy Manager 等反代服务（非必需但建议）
• 域名（非必需但建议）
• qBittorrent文档：https://www.qbittorrent.org
• GitHub地址：https://github.com/qbittorrent/qBittorrent

部署方式

照例还是采用 Docker 的方式进行部署。

参数说明：

• 7881：用于传入连接的端口，TCP/UDP都需要映射，且主机端口和容器端口必须一致，否则无法下载和上传
• 18080：qBittorrent webui 访问端口，可自行修改宿主机上的映射端口
• /qbittorrent/config：qbittorrent配置文件存储目录，可自行修改
• /qbittorrent/downloads：下载目录，可自行修改

docker命令方式

可以直接执行下面命令把 Docker 容器启动起来：

docker run -d \
  --name qbittorrent \
  -p 7881:7881 \
  -p 7881:7881/udp \
  -p 18080:18080 \
  -v /qbittorrent/config:/etc/qBittorrent \
  -v /qbittorrent/downloads:/downloads \
  --restart unless-stopped \
  helloz/qbittorrent

docker-compose方式

docker-compose.yml 配置文件如下：

version: '3'

services:
  qbittorrent:
    image: helloz/qbittorrent
    container_name: qbittorrent
    ports:
      - "7881:7881"
      - "7881:7881/udp"
      - "18080:18080"
    volumes:
      - /qbittorrent/config:/etc/qBittorrent
      - /qbittorrent/downloads:/downloads
    restart: unless-stopped

然后在 docker-compose.yml 文件的目录下执行下面命令即可启动容器：

docker-compose up -d

配置Nginx反向代理（非必需但建议）

Docker 容器运行成功后，可以配置反向代理，用域名进行访问，Nginx 配置示例如下：

server {
  server_name qb.example.com;
  listen 443 ssl http2;
  ssl_certificate <SSL证书路径>.cer;
  ssl_certificate_key <SSL证书路径>.key;
  ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3;
  listen 80;
  if ($scheme = http) {
    return 301 https://$host:443$request_uri;
  }
  location / {
    proxy_pass http://127.0.0.1:18080;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Host $http_host;
    proxy_set_header X-Forwarded-Port $server_port;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_redirect http:// https://;
  }
}

使用

运行成功后可通过 http://IP:18080 进行访问，
如果配置了 Nginx，可使用域名进行访问。

• 初始用户名：admin
• 密码：adminadmin

登录成功后自行在设置处修改用户名和密码。

某些版本取消了默认密码，改为启动时生成随机密码作为临时密码。docker启动容器后。可以使用 docker logs qbittorrent（或者 docker logs 【容器id】） 查看临时密码

更新

# 进入 qBittorrent 项目的 `docker-compose.yml` 文件的目录下，执行下面命令

# 拉取新镜像
docker-compose pull

# 更新项目容器
docker-compose up -d

# 删除未被使用的镜像（prune 命令用来删除不再使用的 docker 对象。删除所有未被 tag 标记和未被容器使用的镜像）
docker image prune

卸载

# 进入 qBittorrent 项目的 `docker-compose.yml` 文件的目录下，执行下面命令

docker-compose down

# 然后删除 qBittorrent 对应的文件/文件夹即可

相关问题

Q1：为什么无法下载迅雷链接或磁力链接？

qBitTorrent 并不能直接解析迅雷链接或磁力链接，它只能解析 torrent 种子文件、或种子文件的下载链接。

对于迅雷链接或磁力链接，需要使用其他工具先转换为 torrent 种子文件，具体方法可自行搜索，工具比较多。

Q2：下载文件保存到哪里？

本篇文章是保存在 /qbittorrent/downloads 文件夹下面，可自行修改映射文件夹。

另外需要注意下载的文件大小不能超过 VPS 磁盘的空间大小。

Q3：其他详细使用/配置？

请自行搜索其他详细使用和配置方式，本篇不再赘述。

视频链接

• YouTube：https://youtu.be/DiyVBQt8VCw
• Bilibili：https://bilibili.com/video/BV1pz421Q7GP