qBittorrent 是一款免费、开源的 BitTorrent 客户端，支持跨平台使用（Windows、macOS、Linux 等）。它以轻量、高效、无广告著称，是许多用户选择的BT客户端。

1.环境准备

确保系统已扮装Docker和Docker-compose，若尚未安装，可参考以下步骤操作：

1.1 安装Docker

（1）安装docker。

sudo curl -f<a href='https://domain.oray.com/ssl' target='_blank'>sSL</a> https://github.com/tech-shrimp/docker_installer/releases/download/latest/linux.sh| bash -s docker --mirror Aliyun

(2)启动docker。

sudo systemctl start docker

1.2 安装Docker-compose

（1）下载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

(2)赋予docker-compose执行权限。

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

2.拉取镜像源

使用docker拉取qbittorrent的最新镜像。

sudo docker pull linuxserver/qbittorrent

3.创建并启动容器

（1）创建一个目录用于存放qbittorrent的数据，并且编写 docker-compose.yml 文件来配置qbittorrent服务。

mkdir qbittorrent
cd qbittorrent
vim docker-compose.yml

（2）在docker-compose.yml 文件中写入qbittorrent配置内容:

version: "2"  
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:  
      # 要使用的<a href='https://hsk.oray.com/' target='_blank'>映射</a>下载端口与内部下载端口，可保持默认，安装完成后在管理页面仍然可以改成其他端口。  
      - 6881:6881   
      - 6881:6881/udp  
      # 此处WEB UI 目标端口与内部端口务必保证相同  
      - 8081:8081  
    restart: unless-stopped

（3）保存退出后，运行容器。

sudo docker-compose up -d

（4）运行完成后，在浏览器输入 http://本地IP:8081 （本例http://10.168.123.227:8081） ，即可web访问qbittorrent。

（5）docker logs 查看日志得到临时的用户名和密码用于登录。首次登录，请用临时用户名和密码登录。

docker logs qbittorren

（6）点击【设置】->【WebUI】，设置登录用户名及密码，然后取消勾选Host header，点击Save保存。

4.配置花生壳映射

4.1 下载

在安装Docker-qBittorrent或可访问Ddocker-qBittorrent的内网终端设备上，下载贝锐花生壳客户端【点击下载花生壳客户端】

4.2 安装

根据不同位数的系统输入下面的命令进行安装，安装完成会自动生成SN码与登录密码。

sudo dpkg -i ph<a href='https://hsk.oray.com/' target='_blank'><a href='https://hsk.oray.com/' target='_blank'>ddns</a></a>_5.3.0_amd64.deb

4.3 登录

（1）浏览器访问【花生壳管理平台】 http://b.oray.com/ ，输入花生壳Linux 5.X.X在安装时，产生的SN码与默认登录密码admin登录。

（2）首次登录，需先进行设备激活。贝锐花生壳提供扫码激活和贝锐账号激活两种方式。

4.4 添加映射

（1）激活成功后，点击【内网穿透】->【添加映射】，填写新增映射信息。

（2）新增映射后，可访问外网地址访问Docker-qBittorrent。

5.外网访问Docker-qBittorrent

浏览器输入花生壳外网地址，即可实现外网访问Docker-qBittorrent。