现在位置: 首页 / Linux / Docker / 正文

[NAS应用] Docker安装qBittorrent-nox

  • Doge
  • Linux
  • 2025-10-26
  • 17热度
  • 0评论
内容 隐藏
1 文章内容
2 拉取qBittorrent-nox
3 允许直接使用IP地址访问webui
4 访问WEBUI
5 优化
6 常用命令

qBittorrent-nox（无界面版本，通过 Web UI 管理）推荐使用linuxserver/qbittorrent镜像（该镜像基于 qBittorrent-nox，配置简单且支持持久化）

文章内容

  • 拉取qBittorrent-nox
  • 允许直接使用IP地址访问webui
  • 访问WEBUI
  • 优化
  • 常用命令

拉取qBittorrent-nox

  1. 使用linuxserver维护的镜像

如果你没有安装Docker查看此文章： 在Fedora\Ubuntu中安装Docker和Docker Compose

执行以下命令拉取

docker pull linuxserver/qbittorrent

创建持久化目录（重要）

  • 配置目录：存放 qBittorrent 的设置、种子列表等
  • 下载目录：存放下载的文件
# 创建配置目录
mkdir -p ~/qbittorrent/config
# 创建下载目录
mkdir -p /tmp/bt

启动 qBittorrent 容器（务必要运行一次才能进行后面的步骤）

docker run -d \
--name=qbittorrent \ # 容器名称（自定义）
-e PUID=$(id -u) \ # 宿主机当前用户ID（避免权限问题）
-e PGID=$(id -g) \ # 宿主机当前用户组ID
-e TZ=Asia/Shanghai \ # 时区（如上海）
-e WEBUI_PORT=8080 \ # Web界面端口（默认8080，可修改）
-p 8080:8080 \ # 映射Web端口到宿主机（宿主机端口:容器端口）
-p 6881:6881 \ # BT下载TCP端口（必须映射，默认6881）
-p 6881:6881/udp \ # BT下载UDP端口（必须映射）
-v ~/qbittorrent/config:/config \ # 挂载配置目录
-v /tmp/bt:/downloads \ # 挂载下载目录
--restart unless-stopped \ # 容器退出后自动重启（除非手动停止）
linuxserver/qbittorrent
  • PUID/PGID：通过id -u和id -g获取当前用户的 ID 和组 ID，确保容器内文件权限与宿主机一致（避免 “权限不足” 问题）。
  • 端口映射：
  • 8080:8080：Web 管理界面端口（外部通过宿主机 IP:8080 访问）。
  • 6881:6881（TCP/UDP）：BT 协议的下载端口（需与 qBittorrent 内设置一致，否则影响下载速度）。
  • 目录挂载：-v 宿主机目录:容器目录，确保配置和下载文件持久化。

允许直接使用IP地址访问webui

# 停止正在运行的 qBittorrent 容器

docker stop qbittorrent

#找到 qBittorrent 的配置文件

# 进入配置目录
cd ~/qbittorrent/config/qBittorrent
# 查看配置文件（确认存在）
ls qBittorrent.conf

# 编辑配置文件，允许 IP 访问

vim qBittorrent.conf

# WebUI\Address：设置 Web 服务监听的地址（默认可能为 127.0.0.1，需改为 0.0.0.0 以允许所有网络接口访问）。
WebUI\Address=0.0.0.0

# 保存配置并重启容器

docker start qbittorrent

访问WEBUI

查看密码

docker logs qbittorrent

[migrations] started
[migrations] no migrations found
───────────────────────────────────────

██╗ ███████╗██╗ ██████╗
██║ ██╔════╝██║██╔═══██╗
██║ ███████╗██║██║ ██║
██║ ╚════██║██║██║ ██║
███████╗███████║██║╚██████╔╝
╚══════╝╚══════╝╚═╝ ╚═════╝

Brought to you by linuxserver.io
───────────────────────────────────────

To support LSIO projects visit:
https://www.linuxserver.io/donate/

───────────────────────────────────────
GID/UID
───────────────────────────────────────

User UID: 0
User GID: 0
───────────────────────────────────────
Linuxserver.io version: 5.1.2-r3-ls421
Build-date: 2025-10-19T06:54:46+00:00
───────────────────────────────────────

[custom-init] No custom files found, skipping...
WebUI will be started shortly after internal preparations. Please wait...

******** Information ********
To control qBittorrent, access the WebUI at: http://localhost:8080 # 访问地址
The WebUI administrator username is: admin # 用户名
The WebUI administrator password was not set. A temporary password is provided for this session: 6mVdArugU # 密码为6mVdArugU
You should set your own password in program preferences.
Connection to localhost (::1) 8080 port [tcp/http-alt] succeeded! # 访问端口
[ls.io-init] done.

访问 Web 管理界面

  • 启动容器后，通过宿主机的 IP（或localhost，若本地）访问：http://宿主机IP:8080
  • 初始登录信息：
  • 用户名：admin
  • 密码：adminadmin

优化

  • trackers列表：https://raw.githubusercontent.com/adysec/tracker/main/trackers_all.txt
  • 高级 - 总是向所有等级的 Tracker 汇报 （勾选）

常用命令

  • 查看容器状态：docker ps | grep qbittorrent
  • 查看日志（排查问题）：docker logs qbittorrent
  • 重启容器：docker restart qbittorrent
  • 停止容器：docker stop qbittorrent