保姆级教程：Docker 部署 qBittorrent 并通过 SSH 隧道实现高安全访问#

🛠️ 第一步：前期准备工作#

在开始配置 Docker 之前，为了避免下载后出现文件权限问题（比如无法删除、无法读取），我们需要获取当前 VPS 用户的 UID 和 GID。

在你的 VPS 终端中输入以下命令：

Bash

1
id

你会看到类似 uid=1000(user) gid=1000(user) 的输出。请记住这两个数字（通常普通用户是 1000，root 用户是 0），后面配置需要用到。

📁 第二步：创建目录与配置文件#

我们需要为 qBittorrent 创建专门的文件夹来存放配置文件和下载的数据。

1. 创建并进入目录：

Bash

1
mkdir -p qbittorrent/config qbittorrent/downloads
2
cd qbittorrent

这样我们就建立了一个清晰的目录结构：

Plaintext

1
qbittorrent/
2
├── docker-compose.yml
3
├── config/       # 存放配置文件
4
└── downloads/    # 存放下载的资源

1. 创建 docker-compose.yml 文件：

   输入命令创建并编辑文件：

Bash

1
nano docker-compose.yml

1. 填入配置代码（记得将 PUID 和 PGID 改成你刚才获取的数字）：

YAML

1
services:
2
  qbittorrent:
3
    image: lscr.io/linuxserver/qbittorrent:latest
4
    container_name: qbittorrent
5
    restart: unless-stopped
6

7
    environment:
8
      - PUID=1000  # 改成你的 uid
9
      - PGID=1000  # 改成你的 gid
10
      - TZ=Asia/Shanghai
11
      - WEBUI_PORT=8080
12

13
    volumes:
14
      - ./config:/config
15
      - ./downloads:/downloads
16

17
    ports:
18
      # 核心安全配置：WebUI 仅绑定在本地 127.0.0.1，公网无法直接访问
19
      - "127.0.0.1:8080:8080"
20
      # BT 对外通信端口，保持公网映射以保证下载速度
21
      - "6881:6881/tcp"
22
      - "6881:6881/udp"

(保存退出方法：按 Ctrl + O，然后回车确认，最后按 Ctrl + X 退出)

💡 进阶提示： 6881 是 BT 的对外通信端口，和 WebUI 的 8080 是两回事。为了保证下载速度和正常的连接数，建议保留 6881 的 TCP/UDP 映射。 如果你有极端的安全需求，希望 VPS “除了 SSH 之外完全不开放任何端口”，可以把 6881 的两行映射删掉。但这会变成纯“出站下载/做种”模式，入站连接能力会变差（不太推荐）。

🚀 第三步：启动容器并获取初始密码#

1. 一键启动：

   在 docker-compose.yml 所在的目录下执行：

Bash

1
docker compose up -d

1. 获取 WebUI 初始密码： 最新版的 qBittorrent 出于安全考虑，会在首次启动时随机生成一个密码。我们可以通过查看日志来获取它。输入以下命令：

Bash

1
docker logs qbittorrent 2>&1 | grep -i password

如果你是首次启动，日志中会清晰地显示临时密码：

Plaintext

1
The WebUI administrator username is: admin
2
The WebUI administrator password was not changed from the default: (这里是一串随机字符)

默认账号：admin

默认密码：复制日志中生成的那串字符。

如果容器已经运行了很久，或者你想看完整的近期日志，可以用 docker logs qbittorrent 2>&1 | tail -50 来查看最后 50 行信息。

🔒 第四步：建立 SSH 加密隧道（核心魔法）#

现在服务端已经跑起来了，但由于我们限制了只允许本地访问（127.0.0.1），你在电脑的浏览器里直接输入 VPS 的 IP 是打不开网页的。

这时候就需要 SSH 隧道 上场了！

打开你本地电脑（比如你的 Windows、Mac 或 Linux 系统终端），执行以下命令：

Bash

1
ssh -L 8080:127.0.0.1:8080 root@你的VPS_IP

1
ssh -p vps端口 -i ~/.ssh/密钥路径 -L 8080:127.0.0.1:8080 用户名@VPSIP

(注意：将 root 替换为你的 VPS 用户名，你的VPS_IP 替换为实际 IP。执行后可能需要输入 VPS 的密码)

这个命令的意思是：把本地电脑的 8080 端口，通过 SSH 加密通道，安全地映射到 VPS 的 127.0.0.1:8080 上。

它的网络访问路径非常安全，如下所示：

Plaintext

1
你的电脑 (浏览器访问)
2
   │
3
   │ SSH 军工级加密隧道
4
   ▼
5
VPS 的 127.0.0.1:8080
6
   │
7
   ▼
8
Docker 里的 qBittorrent

🌐 第五步：登录并修改密码#

1. 在隧道保持开启（刚刚那个终端不要关）的状态下，打开你电脑的浏览器，访问： 👉 [http://127.0.0.1:8080](http://127.0.0.1:8080)
2. 输入刚才获取的账号（admin）和临时密码登录。
3. 【极其重要】 登录成功后，请立刻修改为你自己的密码！ 进入：Tools（工具） → Options（选项） → WebUI → Authentication（验证） 里面进行修改。