【好玩的Docker项目】10分钟搭建你专属的下载神器——qbittorrent

简介

前阵子，入手了一号双鸡两台3o，无限流量，1T的硬盘空间，所以想着折腾一下一直听说，但是又似乎很神奇的PT下载（正好租户给了我几个邀请码）。

PT 即 Private Tracker ，一种小范围、附带流量统计的下载。根据上传流量不同，用户拥有不同身份，对应不同权限甚至不同下载速度。为了提高上传流量，一般会需要一台能够持续不断下载上传的机子（一般会用NAS），VPS24小时开机，加上3o又是不限流量，还有1T的硬盘空间，是非常理想的PT鸡鸡。

今天就来安装一个大名鼎鼎的开源下载神器——qBittorrent， 照例还是采用Docker安装的方式， 实现 24 小时下载与上传。

准备工作

• 服务器：VPS（Debian操作系统）或者NAS一台（威联通、群晖都可以，能装Docker就行），咕咕这边以腾讯云轻量为例子，如果你下载很频繁，而且是大文件，最好是用无限流量的机子，而且最好选大盘鸡。这边推荐BuyVM
• 系统：Debian 11 （DD 脚本 非必需 DD，用原来的系统也 OK，之后教程都是用 Debian 或者 Ubuntu 搭建～）
• 安装好 Docker、Docker-compose（相关脚本）
• 【非必需但建议】域名一枚，并做好解析到服务器上（域名购买、域名解析 视频教程）
• 【非必需】提前安装好宝塔面板海外版本 aapanel，并安装好 Nginx（安装地址）
• 【非必需本教程选用】安装好 Nginx Proxy Manager（相关教程）

服务器要求：硬盘越大越好，流量越多越好。

视频教程

YouTube：https://youtu.be/CUvJeWVNI7s

B站：https://www.bilibili.com/video/BV19p4y1g7hF/

开始部署

安装Docker

更新、安装必备软件

apt-get update && apt-get install -y wget vim

安装脚本

wget -qO- get.docker.com | bash

查看 Docker 安装版本等信息

docker version

启动 Docker 服务

systemctl start docker

查看 Docker 运行状态

systemctl status docker

将 Docker 服务加入开机自启动

systemctl enable docker

安装Docker compose

sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

赋予执行权限，

sudo chmod +x /usr/local/bin/docker-compose

查看docker-compose 版本，

docker-compose --version

安装qBittorrent

本文安装基于Debian11，对于其他环境，Docker的命令也应该是通用的。

DockerHub 上附带 qBittorrent Web UI的 qBittorent 客户端镜像为：

linuxserver/qbittorrent

1、拉取镜像

docker pull linuxserver/qbittorrent

2、创建对应目录并编写 Docker-Compose 文件

cd ~
mkdir /root/data/docker_data/qBittorrent #创建qbitorrent数据文件夹
cd /root/data/docker_data/qBittorrent
mkdir config downloads #创建配置文件目录与下载目录
nano docker-compose.yml #创建并编辑文件

3、复制如下内容并按需修改：

services:
  qbittorrent:
    image: linuxserver/qbittorrent
    container_name: qbittorrent
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai # 你的时区
      - UMASK_SET=022
      - WEBUI_PORT=8081 # 将此处修改成你欲使用的 WEB 管理平台端口 
    volumes:
      - ./config:/config # 绝对路径请修改为自己的config文件夹
      - ./downloads:/downloads # 绝对路径请修改为自己的downloads文件夹
    ports:
      # 要使用的映射下载端口与内部下载端口，可保持默认，安装完成后在管理页面仍然可以改成其他端口。
      - 6881:6881 
      - 6881:6881/udp
      # 此处WEB UI 目标端口与内部端口务必保证相同，见问题1
      - 8081:8081
    restart: unless-stopped

4、执行docker-compose

docker-compose up -d # docker-compose
# 执行后，如果得法，访问 ip:web-ui-port 即可进入管理页面。
# 默认用户名密码admin/adminadmin

注意：腾讯云、阿里云等用户记得在后台防火墙打开8081端口

使用qBittorrent

访问ip:port，进入 WebUI 管理界面。

默认账号admin,默认密码adminadmin

4.6.1.0版本后取消了默认密码啦，改为启动时生成随机密码作为临时密码。docker启动容器后。可以使用“docker logs【容器id】” 查看临时密码

qBittorrent 登录遇到 unauthorized的解决方法：

1、先停止容器docker compose down

2、SSH进入配置文件夹，编辑qBittorrent.conf在文末加上：

WebUI\HostHeaderValidation=false
WebUI\CSRFProtection=false

保存之后，重新启动容器即可。

修改页面为中文界面

打开如下面板：

Tool->Options->WebUI 将Language修改为简体中文，并点击最下方的Save即可。

修改下载与上传使用的端口

运营商可能会对常用的 BT/PT 端口(6881,688x)进行限速，大多数 PT 站会拒绝这些端口的请求。

修改端口方法如下：

工具->选项->连接将监听端口修改为 PT 站接受的端口。

可能遇到的问题

网页管理平台白屏无内容

检查 docekr-compose.yml 文件中的 WEBUI_PORT 与 端口映射是否都为一个端口。如果端口映射中内部端口与外部端口不同，可能会导致白屏。

如何访问下载的文件

可以通过FTP、Samba或者基于 Web 的目录程序访问对应目录。我推荐使用同样基于 Docker 的FileBrowser进行在线文件管理。

具体的安装方法可以看这篇：手把手教你搭建私人离线下载神器Aria2，搭配Rclone+Filebrowser自动上传至网盘

优化

RSS自动下载设置（PT推荐）

打开获取RSS订阅与启用RSS Torrent自动下载

添加两条下载规则，分别是no和auto，其中no的规则添加后不开始下载选择总是

其中auto的规则添加后不开始下载选择实用全局设定

然后你就可以去PT站，把RSS地址复制过来，先勾选no不勾选auto，此时你会看到自动下载了10个种子任务，然后你把这10个种子任务删除掉，再次打开这边的规则，勾选auto，把no的勾勾去掉，点击保存，之后，只要PT站有新的种子上传，你这边机器就能自动下载了（一般新种都是免费的，可以刷上传量）

其他

勾选上面三项可以优化磁盘读写性能。缓存到期时间为磁盘缓存除以最大下载速度，到时间后数据就从内存写入磁盘。

现在操作系统的块大小都是4KB，这是最小的储存单位。举个最简单的例子，你新建一个文件什么都不写都会占用4KB空间。原来默认是上限是500KB，下限是10KB，强迫症让我把发送缓存都设置为4的整数，或许对磁盘性能有优化，设置太高会浪费内存。官方文档说加大增长系数可以加快上传速度，BT用户默认50%够用，而PT用户为了抢上传，可以设置成100甚至更高。

由于本咕也刚刚使用，很多设置也在摸索中，如果大家有使用心得，欢迎在评论区一起交流！

关于更详细的设置可以参考：http://www.ptyqm.com/26966.html

PT更详细的教程可以参考：https://www.shifeiti.com/blog/2022-12-22/ （不要再薅Hetzner啦）

开启IPv6支持

有些VPS是支持IPv6的，比如BuyVM

然后有时候你下载速度太快，被站点标记了盒子，可以试着用IPv6来刷流，具体开启方法见这篇内容：

【有用的小知识】Docker-qBittorrent 开启 IPv6 笔记

参考资料

https://blog.csdn.net/maxuearn/article/details/104562021
https://www.colorcc.net/qbittorrent%E5%AE%89%E8%A3%85%E5%8F%8A%E4%BC%98%E5%8C%96%EF%BC%88%E8%B4%9F%E4%BC%98%E5%8C%96%EF%BC%89/
https://blog.laoda.de/archives/vps-recommad

推荐阅读

手把手教你搭建私人离线下载神器 Aria2，搭配 Rclone+Filebrowser 自动上传至网盘

利用 rclone 自动上传 aria2 下载的文件到 onedrive 或者 googledrive