qBittorrent WebUI 远程管理配置
从零配置远程访问
qBittorrent 内置 WebUI 功能,允许你通过浏览器在任何设备上远程管理下载任务。无论是在手机上查看进度还是在另一台电脑上添加任务,WebUI 都能满足需求。更多 qBittorrent 的功能介绍请见qBittorrent 首页。
WebUI 使用场景
- 在家里的电脑上挂机下载,在公司用手机查看进度或添加新任务
- 在 NAS 或家庭服务器上 24 小时运行 qBittorrent,通过浏览器管理
- 多人共享一台下载机,各自通过浏览器访问自己的管理界面
- 远程排查下载问题,无需远程桌面或 TeamViewer
启用 WebUI
- 打开 qBittorrent,进入 工具 → 选项 → Web UI
- 勾选 启用 Web 用户界面(远程控制)
- IP 地址:保持默认的
0.0.0.0(监听所有网络接口)。如果只想本机访问,填127.0.0.1 - 端口:默认
8080。如果 8080 被其他服务占用,修改为其他端口(如 8081、9090) - 用户名:设置一个登录用户名(默认 admin)
- 密码:设置登录密码,至少 6 个字符
- 点击 Apply → OK 保存设置
本地访问测试
在运行 qBittorrent 的电脑上打开浏览器,访问 http://localhost:8080(如果改了端口,改为对应端口号)。输入设置的用户名和密码即可登录 WebUI 管理界面。
外网访问配置
如果希望从家庭网络外部访问 WebUI(如在外出时管理家里的下载机),需要以下额外步骤:
- 登录路由器管理页面(通常是 192.168.1.1 或 192.168.0.1)
- 找到"端口转发"或"虚拟服务器"设置
- 添加转发规则:外部端口(如 8080)→ 内部 IP(运行 qBittorrent 的电脑 IP)→ 内部端口(WebUI 端口)
- 保存并应用
- 确认电脑 IP 地址为固定 IP(而非 DHCP 自动分配)
之后通过 http://你的公网IP:8080 即可从外网访问。
安全设置建议
WebUI 暴露在公网上存在安全风险,建议采取以下措施:
- 强密码:使用 12 位以上的混合密码,包含大小写字母、数字和特殊字符
- 启用 HTTPS:在 WebUI 设置中上传 SSL 证书并启用 HTTPS 加密,防止密码明文传输
- 更改默认端口:不使用 8080 等常见端口,降低被扫描发现的概率
- 限制登录尝试:部分路由器可设置访问频率限制,防止暴力破解
- 定期检查日志:查看 WebUI 访问日志,及时发现异常登录
常见问题
外网无法访问 WebUI?
依次排查:路由器端口转发是否正确 → 电脑防火墙是否允许入站连接 → 运营商是否屏蔽了该端口。可尝试使用非标准端口(如 12345)绕过运营商限制。
忘记 WebUI 密码怎么办?
关闭 qBittorrent,打开配置文件 `%APPDATA%\qBittorrent\qBittorrent.conf`,找到 `WebUI\Password_PBKDF2` 行并删除。重启 qBittorrent 后 WebUI 密码重置为空,重新设置即可。
手机能访问 WebUI 吗?
可以。任何有浏览器的设备都能访问 WebUI 管理界面。此外,iOS 和 Android 应用商店中有多个第三方 App 可通过 WebUI API 连接 qBittorrent,提供更友好的手机操作体验。