[教程]用docker方式一键部署到VPS-BT服务器离线下载的办法

概要

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

qBitTorrent 是一款开源免费的种子和磁力链接下载工具，支持 Windows、Mac 和 Linux 平台，功能非常强大。

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

而一台海外的千兆带宽 VPS ，也不是月租 $5 而已（推荐 vultr）。

项目说明

本仓库包含三个 docker 镜像：

环境要求

Linux amd64

部署步骤

1. 项目构建

• 宿主机安装 docker、docker-compose
• 宿主机安全组/防火墙（iptables/firewall）放行这些端口的入口流量： 80、8080、8081-8089、8081-8089/udp、9000、9090
• 下载仓库： git clone https://github.com/lyy289065406/qBitTorrent-docker /usr/local/qBitTorrent-docker
• 打开仓库目录： cd /usr/local/qBitTorrent-docker
• 构建镜像并运行： caddy_user=admin caddy_pass=123456 docker-compose up -d

caddy 的账号密码按需设置即可；qBittorrent 的密码因为使用 PBKDF2 算法，又没有提供生成密码的命令行工具，故只能在 WEB 页面上修改。

2. 配置 qBitTorrent

• 登录 WEB 管理页面：http://${vps-ip}/bt/（或 http://${vps-ip}:8080）
• 默认登录账密: admin / adminadmin
• 修改默认密码: 【选项】 -> 【Web UI】 -> 【验证】
• 修改 tracker 列表： 【选项】 -> 【BitTorrent】 -> 【自动添加以下 tracker 到新的 torrent】

更多配置可参考《专业磁力种子下载工具 qBittorrent 使用教程》

3. 配置定时更新 trackers

通过 trackers 可以优化下载速度，但是 trackers 是有有效时限的，在以下地方可以获取最新的 trackers 列表：

• https://github.com/ngosang/trackerslist
• https://torrents.io/tracker-list/
• https://newtrackon.com/list

通过 update_trackers.sh 脚本可以自动刷新 trackers 配置。

建议把该脚本配置到 crontab ，每天更新一次：

# 编辑定时任务
crontab -e

# 每天更新一次 trackers
0 1 * * * /bin/sh /usr/local/qBitTorrent-docker/update_trackers.sh

4. 使用 caddy 浏览已下载文件

• 登录 WEB 页面：http://${vps-ip}/list/ 或 http://${vps-ip}:9090
• 默认 BasicAuth 登录账密: admin / 123456

BasicAuth 的账号密码在第 1 步构建项目时已配置好

FAQ

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

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

对于迅雷链接或磁力链接，需要使用其他工具先转换为 torrent 种子文件，具体方法可参考这篇文章。

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

仓库下的 downloads 挂载到 docker 容器，下载的文件均保存到这里。

在前端可以通过 caddy 下载，在后端可以到这个目录下载。

另外需要注意下载的文件大小不能超过 downloads 目录所在磁盘的空间大小。

Q3： tracker 是什么？

在 BT 下载中的一个重要概念是 P2P。

P2P 是 peer-to-peer 的缩写，网络中的一个 peer（正在下载资源的客户端） 如何才能找到另外志同道合的 peer，Tracker 扮演着至关重要的月老作用：Tracker 是一个 HTTP 或者 UDP 服务器，作用是帮助 peer 找到其他拥有相同资源的 peer。

后来有了 DHT 网络之后，Tracker 的作用逐渐弱化，但是 Tracker 代表的这种中心化一定程度上相对 DHT 代表的去中心化效率还是比较高的。

详见《BT 增强建议之 Tracker》

Q4： 忘记 qBitTorrent 的登录密码怎么办？

进入 docker_torrent 容器，修改 /config/qBittorrent/qBittorrent.conf 文件，删除 WebUI/Password_PBKDF2 配置项，然后重启进程即可还原为默认密码 adminadmin。

Q5： 可以用手机管理 qBitTorrent 吗？

使用 transdrone 即可。