# 安装 qBittorrent
# 一、拉取镜像
首先,我们需要从 Docker Hub 拉取 qBittorrent 镜像。执行以下命令,获取最新版本的镜像:
1 | docker pull lscr.io/linuxserver/qbittorrent:latest |
# 二、创建对应的目录
为了保证 qBittorrent 的数据存储和下载文件的管理,我们需要创建两个必要的目录:
1 | mkdir /docker/qb/config #qBittorrent的数据文件夹,用于存放配置文件、日志等数据 |
你可以根据实际需求,修改目录路径。比如,若你希望将数据存储在其他磁盘分区,可将路径改为对应分区的路径。
# 三、创建容器
接下来,使用 docker run
命令创建并启动 qBittorrent 容器。执行以下命令:
1 | docker run -d \ |
# 命令参数详解:
-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。