步骤/目录：
1.编写compose模板
2.运行并验证

本文首发于个人博客https://lisper517.top/index.php/archives/25/，转载请注明出处。
本文的目的是使用docker、docker-compose在树莓派上运行qbittorrent。
本文实验日期为2022年8月1日。本文使用的是树莓派4B（内存8G版），系统为Pi OS 64位桌面版（2022年4月4日更新，镜像名 2022-04-04-raspios-bullseye-arm64.img ）。

之前的文章中曾提到过qbittorrent，详见 树莓派+Samba+frp搭建NAS（网络云存储） 。简单来说，qbittorrent的作用是离线下载，一般搭配NAS使用。

在docker官方仓库网页进行搜索，最后笔者选用的是linuxserver/qbittorrent镜像，其下载量为100M+，一个月前更新。

1.编写compose模板

如前所述，笔者使用树莓派+samba搭建了NAS，挂载一块硬盘到分享目录，路径为/home/samba_user/shared。如果没有NAS也无所谓，但由于树莓派本身存储较小，最好还是外接存储。另外，samba目前在官方仓库没有下载量大的官方镜像，所以仍然是直接在本地跑。
在树莓派上进行如下操作：

docker pull linuxserver/qbittorrent
mkdir -p /docker/qbittorrent/conf
mkdir /docker/qbittorrent/ssl_certificate
id samba_user #这里的samba_user是为samba创建的系统用户
#输出uid=1002、gid=1003
nano /docker/qbittorrent/docker-compose.yml

写入以下内容：

version: "3.9"
services:
  qbittorrent:
    image: linuxserver/qbittorrent
    environment:
      - PUID=1002
      - PGID=1003
      - TZ=Asia/Shanghai
      - WEBUI_PORT=8080
    volumes:
      - /docker/qbittorrent/conf:/config
      - /home/samba_user/shared/DLs:/downloads
      - /docker/qbittorrent/ssl_certificate:/ssl_certificate
    ports:
      - "8080:8080"
      - "6881:6881"
      - "6881:6881/udp"
    restart: unless-stopped

这里需要解释一下docker-qbittorrent的注意事项。PUID、PGID用于指定一位宿主机系统用户，该用户需要拥有宿主机的下载目录（本例中为/home/samba_user/shared），这样才不会有读写权限的问题，使用 id 用户名 可查看uid、gid。

2.运行并验证

cd /docker/qbittorrent
docker-compose config
docker-compose up

若要后台运行docker-frpc，可使用docker-compose up -d命令。

这时使用ufw打开8080、6881端口，即可浏览器登录到 树莓派ip:8080 ，出现qbittorrent网页UI，初始用户名密码为admin和adminadmin。在顶部工具栏下方，右边的齿轮图标为设置。接下来对qbittorrent进行一些初始设置：
在 Web UI 中将语言改为中文；
在 下载 中，将 默认Torrent管理模式 改为自动，勾选 保存未完成的torrent到 、 复制.torrent文件到（这两个目录自选），下面的 下载完成时发送电子邮件到 用的也是SMTP、有需要的可以打开， Torrent完成时运行外部程序 也可根据自身需要打开；
在 速度 中，可以选择下载速度限制；
在 BitTorrent 中，可调整最大同时下载数；
在 Web UI 中，可设置使用HTTPS，修改用户名密码。