lsioarmhf/qbittorrent
lsioarmhf
此镜像已弃用，建议使用多架构镜像linuxserver/qbittorrent，这是基于ARMHF架构的Linuxserver.io qbittorrent镜像，提供开源BitTorrent客户端功能，可替代µTorrent，基于Qt和libtorrent-rasterbar库。
5 次收藏下载次数: 0状态：社区镜像维护者：lsioarmhf仓库类型：镜像最近更新：7 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
lsioarmhf/qbittorrent
镜像概述和主要用途
【重要提示】此镜像已弃用，请使用多架构镜像 linuxserver/qbittorrent
该镜像是由https://linuxserver.io团队提供的基于ARMHF架构的qBittorrent容器。qBittorrent项目旨在提供µTorrent的开源替代方案，基于Qt工具包和libtorrent-rasterbar库开发，支持BitTorrent协议文件共享。
LinuxServer.io团队的容器以易于用户映射和社区支持为特色，可通过https://forum.linuxserver.io、https://www.linuxserver.io/irc/或https://www.linuxserver.io/podcast/获取支持。
核心功能和特性
- 基于Alpine Linux构建，轻量高效
- 集成s6 overlay，支持容器内进程管理
- 支持用户/组ID（PUID/PGID）映射，避免权限问题
- 可配置WebUI端口、时区和文件权限（umask）
- 提供完整的qBittorrent功能，包括BT下载管理、Web界面控制等
使用场景和适用范围
适用于需要在ARMHF架构设备（如部分单板计算机）上运行BitTorrent客户端的用户，用于下载和管理BT资源。注意：由于镜像已弃用，新部署建议使用多架构镜像 linuxserver/qbittorrent
使用方法和配置说明
Docker运行命令
bashdocker create \ --name=qbittorrent \ -v <主机配置路径>:/config \ -v <主机下载路径>:/downloads \ -e PGID=<组ID> -e PUID=<用户ID> \ -e UMASK_SET=<022> \ -e WEBUI_PORT=<8080> \ -e TZ=<时区> \ -p 6881:6881 \ -p 6881:6881/udp \ -p 8080:8080 \ lsioarmhf/qbittorrent
参数说明
参数格式为主机端:容器端，左侧为主机配置，右侧为容器内部配置：
| 参数 | 说明 |
|---|---|
-p 6881 | BT协议TCP端口映射 |
-p 6881/udp | BT协议UDP端口映射 |
-p 8080 | WebUI端口映射 |
-v /config | qBittorrent配置文件存储路径 |
-v /downloads | 下载文件存储路径 |
-e PGID | 组ID，用于权限映射（见用户/组标识符说明） |
-e PUID | 用户ID，用于权限映射（见用户/组标识符说明） |
-e UMASK_SET | 文件权限掩码，可选，默认022 |
-e WEBUI_PORT | WebUI端口，需与端口映射同步修改 |
-e TZ | 时区信息，如Europe/London |
WEBUI_PORT变量说明
由于CSRF和端口映射问题，修改WebUI端口时需同时调整端口映射和WEBUI_PORT变量。例如，将端口改为8090需设置：
bash-p 8090:8090 -e WEBUI_PORT=8090
若WebUI无法访问，检查配置文件/config/qBittorrent/qBittorrent.conf，确保以下配置：
WebUI\Address=* WebUI\ServerDomains=*
用户/组标识符
使用数据卷（-v）时，主机与容器可能出现权限问题。通过指定PUID（用户ID）和PGID（组ID），确保主机数据卷目录与容器内用户权限一致。
获取当前用户的ID：
bashid <用户名> # 示例输出：uid=1001(用户) gid=1001(组) groups=1001(组)
设置PUID=1001和PGID=1001即可匹配权限。
应用设置
【重要】这是ARMHF版本镜像
- WebUI访问地址：
<你的IP>:8080 - 默认用户名/密码：
admin/adminadmin - 通过WebUI的"设置-Web UI"部分修改用户名和密码
容器管理信息
- 容器运行中获取Shell：
docker exec -it qbittorrent /bin/bash - 实时查看容器日志：
docker logs -f qbittorrent - 查询容器版本：
docker inspect -f '{{ index .Config.Labels "build_version" }}' qbittorrent - 查询镜像版本：
docker inspect -f '{{ index .Config.Labels "build_version" }}' lsioarmhf/qbittorrent
版本历史
- 09.01.19: 此镜像已弃用，请使用多架构镜像
linuxserver/qbittorrent - 25.09.18: 使用构建阶段类型构建，更新qbittorrent至4.1.3
- 14.08.18: 基于Alpine 3.8重构，更新libtorrent至1.1.9和qbittorrent至4.1.2
- 08.06.18: 更新qbittorrent至4.1.1
- 26.04.18: 更新libtorrent至1.1.7
- 02.03.18: 更新qbittorrent至4.0.4和libtorrent至1.1.6
- 02.01.18: 弃用cpu_core例程（缺乏扩展性）
- 20.12.17: 基于Alpine 3.7重构
- 01.12.17: 更新至v4版本
- 16.09.17: 升级至3.3.16，添加WEBUI_PORT变量及文档说明
- 01.08.17: 添加unrar包
- 13.07.17: 升级至3.3.13，使用qbittorrent wiki中的libtorrent编译说明
- 30.05.17: 基于Alpine 3.6重构
- 19.05.17: 初始发布
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 qbittorrent 镜像标签
docker pull docker.xuanyuan.run/lsioarmhf/qbittorrent:<标签>
DockerHub 原生拉取命令
docker pull lsioarmhf/qbittorrent:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"