qb-web 使用教程：3 步为 qBittorrent 换上全新界面，解锁聚合搜索与 RSS 自动下载
【免费下载链接】qb-webA qBittorrent Web UI, write in TypeScript+Vue.项目地址: https://gitcode.com/gh_mirrors/qb/qb-web
qBittorrent 自带的网页管理界面功能齐全，但颜值和操作体验总有提升空间。qb-web 是一款基于 TypeScript + Vue 打造的 qBittorrent 备用 Web UI，它把搜索插件聚合、RSS 自动下载、响应式布局等能力整合进一个清爽的界面里，让你不用换下载引擎，就能获得现代客户端级别的操控体验。这篇文章会用最短路径带你完成部署、搜索与自动化配置，全程无需写一行代码。
为什么值得换掉 qBittorrent 默认界面
先坦白一个场景：同时管理几十个任务时，默认界面里切换分类、看速度曲线、找某个种子，往往要点好几层菜单。qb-web 的思路很简单——把高频操作放在手边：
- 左侧状态栏一键筛选：全部、下载、上传、完成、暂停、活动、错误，几秒钟定位目标任务。
- 顶部工具栏集中操作：添加、暂停、继续、删除、视图切换都在同一行。
- 底部状态栏实时概览：版本、任务总数、磁盘占用、节点数、实时上下行速度一眼可见。
- 响应式设计：手机浏览器打开同样顺手，通勤路上也能查进度。
说白了，它解决的痛点是"功能都有，但用起来费劲"。换皮不换芯，底层还是你的 qBittorrent 服务，数据完全无缝衔接。
qb-web 是什么：认识"备用 Web UI"机制
qBittorrent 从很早的版本就内置了"备用 Web UI"入口：你只需要告诉它一个目录，它就会用该目录里的页面替换掉默认界面。qb-web 正是为这个机制量身打造的成品，压缩包解压即用。
几个值得知道的特点：
- 多语言支持：内置英文、简体中文、繁体中文、俄语、土耳其语等多种语言包，语言切换在设置里即时生效。
- 纯前端 SPA：所有页面跳转不刷新，操作反馈更快。
- 多 WebUI 并存：官方支持与默认界面同时运行，遇到问题可以随时回退。
- 开源可扩展：界面逻辑集中在
src/components/下，想研究实现或定制，克隆仓库即可上手，比如核心的搜索与插件模块就在 src/components/dialogs/searchDialog/。
第一步：qb-web 安装步骤（约 3 分钟）
整个安装过程本质上只有两步，老人机用户也能搞定。
- 获取文件：从项目 Release 页面下载最新的压缩包（qBittorrent 建议 v4.2.5 及以上版本），解压到一个固定的、你记得住的位置。
- 指定路径：进入 qBittorrent 的「Web 用户界面」设置，勾选"使用备用 Web UI"，在文件路径处填上刚才解压的目录（注意不要带
public后缀）。 - 刷新页面：重新打开 Web 管理地址，新界面就会接管。清一下浏览器缓存，效果更稳。
这里多提一句安全设置：如果后续要从其他域名（比如自己搭建的导航页）调用界面，可以在"自定义 HTTP 头"里配置 CORS 白名单，把允许的来源域名填进去即可，避免跨域请求被拦。
兜底方案：万一把自己锁在门外，别慌。直接在浏览器地址栏访问/api/v2/app/setPreferences?json=%7B%22alternative_webui_enabled%22:false%7D，这条命令会立刻禁用备用 Web UI，恢复默认界面，相当于一条保险绳。
如果你是开发者想跑源码版，执行git clone https://gitcode.com/gh_mirrors/qb/qb-web后按 DEV.md 里的说明yarn install再yarn run serve即可启动热更新开发环境。
第二步：用搜索插件实现多源聚合搜索
这是 qb-web 最值得吹的功能之一。它把 qBittorrent 原生的搜索能力包装成了"插件市场"的形态：每个插件对应一个搜索源，一次输入关键词，多个站点并行帮你找，结果统一汇总在结果表格里。
插件管理器怎么用
打开搜索对话框后，右下角有个齿轮图标，点进去就是插件管理器。在这里你能看到所有已安装的搜索插件：
- 单个开关：每个插件对应一个开关，按需启用，不需要的关掉即可。
- 批量更新：顶部有更新按钮，一键把所有插件刷新到最新版本，修复失效源。
- 即改即生效：启停动作会立刻同步到服务端，下次搜索自动按新配置执行。
背后的逻辑由 src/store/searchEngine.ts 驱动，启停、更新、重新拉取插件列表都封装成了清晰的动作，感兴趣的话读起来很顺。
高效搜索技巧
- 精简插件数量：插件越多请求越多，结果反而慢。日常只留 2~3 个质量高的源，速度和质量最平衡。
- 关键词要具体：带年份、分辨率、格式的关键词（如"沙丘 2021 2160p"）比模糊词命中率高得多。
- 用好结果表的下载按钮：每个结果行都带一键下载图标，看中哪个点一下，种子直接进下载队列。
添加任务时还能顺手配置：选择分类、是否立即开始、是否跳过哈希校验、是否按顺序下载等，一步到位，不用之后再改。
第三步：配置 RSS 订阅，让追更全自动
如果你追的剧集来自固定的资源站，RSS 就是你的私人助理。qb-web 的 RSS 模块把订阅源管理、条目浏览、自动下载规则整合在同一个页面，省掉"每天手动刷一遍"的重复劳动。
三个常见玩法
- 添加订阅源：点击加号填入 RSS 地址，左侧列表立即出现该源，右侧可浏览最新条目与元数据（大小、分辨率、音轨信息）。
- 开启自动刷新：打开顶部的自动刷新开关，qb-web 会定时拉取最新条目，新资源不会漏。
- 规则化自动下载：这是精髓——在规则设置里定义"必须包含/必须排除"的关键词，还能用正则匹配和智能剧集过滤，把规则绑定到特定订阅源。
举一个真实例子：你只想自动下载某部美剧的 1080p 版本。新建一条规则，把"包含关键词"设为剧名 + 1080p，"排除关键词"设为 720p / HDTV，开启智能剧集过滤，勾选只对目标订阅源生效。之后只要该源出现符合条件的种子，qb-web 会自动帮你拉取，早上醒来新剧已经在硬盘里躺好了。
让 qb-web 用起来更顺的实用技巧
- 定期更新插件：搜索源的结构经常变动，旧插件容易失效。每周点一次"更新插件"，成功率有明显提升。
- 善用分类与站点筛选：左侧导航除了状态，还支持按分类和站点过滤，资源一多就知道这个功能的好了。
- 移动端优先的布局：手机浏览器打开界面，列表、操作、RSS 阅读都能正常使用，适合在外监控下载进度。
- 只开需要的插件：长期启用的插件控制在个位数，既省系统资源，搜索结果也更干净。
常见问题与避坑指南
Q：装完后界面没有变化？A：优先检查两件事：备用 Web UI 的文件路径是否指向解压目录（不带public），以及浏览器是否缓存了旧页面。两者确认无误后强制刷新即可。
Q：某个搜索插件搜不到结果？A：先确认该插件处于启用状态，再点一次更新插件。若仍失败，多半是站点改版或封禁了该来源，暂时停用它并等插件更新。
Q：RSS 自动下载不触发？A：检查自动刷新开关是否打开、规则是否绑定了正确的订阅源、关键词是否写反了"包含/排除"。规则列表里每条规则都可以单独删除重配，别怕试错。
Q：能和默认 Web UI 共存吗？A：可以。qb-web 支持多 WebUI 同时运行，想对比或临时回退都没有压力，这也正是备用机制存在的意义。
现在就开始
换一个界面，顺手把搜索和 RSS 自动化都安排上，这就是 qb-web 能带给你的完整收益。去 Release 页下载最新包，花 3 分钟完成安装，再花 5 分钟把插件和 RSS 规则配好——今天的追更、找资源效率就能立刻不一样。动手吧，你的 qBittorrent 值得一个更好的门面。
【免费下载链接】qb-webA qBittorrent Web UI, write in TypeScript+Vue.项目地址: https://gitcode.com/gh_mirrors/qb/qb-web
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
