# 安装 qBittorrent

# 一、拉取镜像

首先，我们需要从 Docker Hub 拉取 qBittorrent 镜像。执行以下命令，获取最新版本的镜像：

1	docker pull lscr.io/linuxserver/qbittorrent:latest

# 二、创建对应的目录

为了保证 qBittorrent 的数据存储和下载文件的管理，我们需要创建两个必要的目录：

1 2	mkdir /docker/qb/config #qBittorrent的数据文件夹，用于存放配置文件、日志等数据 mkdir /docker/media #下载目录，用于存储下载的各类文件

你可以根据实际需求，修改目录路径。比如，若你希望将数据存储在其他磁盘分区，可将路径改为对应分区的路径。

# 三、创建容器

接下来，使用 docker run 命令创建并启动 qBittorrent 容器。执行以下命令：

docker run -d \
--name=qbittorrent \
-e PUID=0 \
-e PGID=0 \
-e TZ=Asia/Shanghai \
-e WEBUI_PORT=8085 \
-p 8085:8085 \
-p 23121:23121 \
-p 23121:23121/udp \
-v /docker/qb/config:/config \
-v /docker/media:/downloads \
--restart unless-stopped \
lscr.io/linuxserver/qbittorrent:latest

# 命令参数详解：

-d ：表示以后台守护进程的方式运行容器，不占用当前终端。
--name=qbittorrent ：为容器指定名称，方便后续管理和操作。
-e PUID=0 -e PGID=0 ：PUID 和 PGID 分别代表用户 ID 和组 ID。设置为 0 表示以 root 权限运行容器，确保容器内对目录有足够的读写权限。可通过 id root 命令查看，一般 root 的 PUID 和 PGID 均为 0 。注意，若不正确设置，容器在写入文件时可能会因权限不足报错。
-e TZ=Asia/Shanghai ：设置容器的时区为上海时区，保证时间显示的准确性。
-e WEBUI_PORT=8085 ：指定 qBittorrent 的 Web 界面访问端口，可根据实际需求修改。
-p 8085:8085 ：将容器内的 8085 端口映射到主机的 8085 端口，实现通过主机访问容器内的 Web 界面。
-p 23121:23121 -p 23121:23121/udp ：映射 BT 下载所需的 TCP 和 UDP 端口。建议不要使用默认的 6881 端口，因为在一些 PT 站点，该端口可能被禁用。你可以根据实际情况修改为其他可用端口。
-v /docker/qb/config:/config -v /docker/media:/downloads ：将主机上的目录挂载到容器内对应的目录，实现数据持久化和文件存储。需根据实际创建的目录路径进行修改。
--restart unless-stopped ：设置容器的重启策略，当 Docker 服务重启或容器意外退出时，自动重启容器，除非手动停止容器。

# 四、访问 qbittorrent

容器创建成功后，在浏览器中输入 x.x.x.x:8085（x.x.x.x 为服务器的 IP 地址），即可访问 qBittorrent 的 Web 界面。

需要注意的是，qBittorrent 最新版本已取消默认密码 adminadmin，采用随机生成的密码。若想获取初始密码，在 /docker/qb/config 的 logs 目录中无法直接查看，需通过执行以下 Docker 命令获取：

1	docker logs -f qbittorrent

该命令会实时输出容器的日志信息，在日志中找到包含初始密码的内容，即可使用该密码登录 qBittorrent 的 Web 界面。

按照以上步骤，你就能成功使用 Docker 安装并配置 qBittorrent。

Docker