qBittorrent 默认 Web UI 太简陋？qb-web 免费替代界面的完整上手指南
【免费下载链接】qb-webA qBittorrent Web UI, write in TypeScript+Vue.项目地址: https://gitcode.com/gh_mirrors/qb/qb-web
是不是每次打开 qBittorrent 的网页管理界面，都有种被时光拽回 2010 年的错觉？功能倒是一样不缺，可那个表格、那排生硬的按钮，实在配不上你精心攒下的下载战利品。别急着换下载工具，问题出在"脸"上——qBittorrent 的 Web 界面本来就可以换。今天要聊的qb-web，就是一个用 TypeScript + Vue 重写的现代化 qBittorrent 网页管理界面，免费开源、纯前端、装上就能用，让你在浏览器里也能拥有 2020 年代的操作体验。
为什么说原生界面"够用但不够好看"
先别急着否定老界面。qBittorrent 自带的 Web UI 在功能上其实相当完整：能看种子列表、能暂停恢复、能设置分类标签。可问题恰恰出在"完整"二字上——当你的种子列表滚过几百行，翻页翻到手指发酸时，你会发现默认界面的设计密度完全没考虑"人"的体验：
- 左侧几乎没有像样的筛选树，想按分类、按标签、按站点筛种子得靠手动搜索
- 进度、速度、比率挤在一行小字里，密集恐惧症患者当场破防
- 手机上访问时表格直接横滚，每次操作都要放大缩小，堪称手指健身器
换句话说，界面是给"功能"设计的，不是给"人"设计的。而 qb-web 的存在，就是要把这块短板补上，而且不需要动 qBittorrent 本体一根汗毛。
qb-web 是什么：一场"换肤"而不是"换芯"
这是新手最容易误解的一点，先给你吃颗定心丸：qb-web 不是一个新的下载软件，也不是对 qBittorrent 的修改版。它是一个纯粹的 Web 前端，相当于给 qBittorrent 换了一件新衣服——下载引擎、Tracker 连接、做种逻辑全都在后台原样运行，qb-web 只是把数据用更现代、更顺眼的方式呈现出来。
它的定位在项目描述里写得很直白：A qBittorrent Web UI, write in TypeScript+Vue。技术上采用 Vue + Vuex + Vuetify 搭建，单页应用（SPA）架构意味着切换页面无需刷新，响应式设计让它能同时照顾桌面端和手机端，还内置了中、英、俄、土四国语言。官方兼容测试覆盖 qBittorrent ≥ v4.2.5 的版本，老用户也能放心升级。
三步安装：让 qb-web 接管你的管理页面
把 qb-web 挂上去的过程比想象中简单，全程不需要命令行，三步搞定：
- 下载发布包：从项目的 Release 页面下载最新版本的压缩包，解压到任意目录（比如
qb-web文件夹）。注意解压后目录里直接就是index.html，不要再嵌套一层。 - 指定备用界面路径：打开 qBittorrent 的「Web 用户界面」设置，勾选「使用备用 Web UI」，在「文件路径」一栏填上刚才解压的文件夹路径（不要带
public后缀）。 - 刷新浏览器：回到浏览器刷新管理页面，一个焕然一新的界面就出现了。
万一配置出错、界面打不开了怎么办？官方在INSTALL.md里留了后路：在 URL 后手动拼接/api/v2/app/setPreferences?json=%7B%22alternative_webui_enabled%22:false%7D，即可一键禁用备用界面，回到默认皮肤，相当贴心。
顺带一提，如果你是通过 GitHub Pages 这类静态托管方式访问，官方截图也提示了需要配合 qBittorrent 的「Add custom HTTP headers」添加Access-Control-Allow-Origin头来放行跨域，按screenshot/CORS-settings.png里的配置照抄即可。
主界面：一个侧边栏抵十个筛选条件
登录进去的第一眼，你就能感受到 qb-web 的用心。左侧的导航抽屉（源码在src/components/Drawer.vue）不是摆设，而是整个界面的"指挥中心"。它把种子列表按状态、分类、标签、站点四个维度做成了可折叠的筛选树，每个分组后面实时显示数量和占用空间：
- 想看正在下载的？点「下载」分组，进度一目了然
- 想单独查某个站点的资源？按「站点」分组，还能自动识别站点图标
- 想管理打标签的资源？「标签」分组帮你把混乱理成秩序
右侧的种子表格（src/components/Torrents.vue）则是信息密度和可读性的平衡之作：名称、大小、进度条、状态、做种/下载数、上下行速度、剩余时间、比率、添加时间，一屏扫完所有关键指标。选中几个种子后，顶部的批量操作栏立即激活——暂停、继续、强制开始、重新校验、设置分类、修改保存路径，全部一键完成，不用再挨个右键。
添加种子：把"填表单"变成"贴链接"
用默认界面加种子时，你总得在页面间跳来跳去。qb-web 把添加入口做成了右下角一个悬浮按钮，点开就是一个干净的对话框（源码在src/components/AddForm.vue）。支持三种姿势：
- 粘贴URL或磁力链接
- 从本地拖入
.torrent文件（支持多选） - 从 RSS 或搜索结果里一键转存
对话框里还能顺手勾选「创建子文件夹」「开始种子」「跳过哈希校验」「按顺序下载」等高级选项，一次把下载策略定好，省得种子上车后再去单独配置。
RSS 自动化：让种子自己送上门
如果说主界面是门面，那 RSS 功能就是 qb-web 真正让人"回不去"的理由。很多玩家挂着 RSS 订阅，却苦于默认界面只能看不能筛。qb-web 的 RSS 模块（src/components/dialogs/RssDialog.vue）把订阅源、种子列表、详情预览放进同一个三栏视图：左侧选源、中间看种子、右侧看元数据，还带封面缩略图。
更进阶的是配套的RssRulesDialog.vue规则引擎。你完全可以对某个源设置"黑/白名单"式规则：必须包含哪些关键词、绝不能包含哪些词，支持正则表达式，甚至内置了智能剧集过滤——新一集发布后自动下载，还能自动分配分类。从此"自动下载最新一集"不再是梦话，而是几条规则的事。
内置搜索：不用再开十个标签页
下载列表管好了，资源从哪来？qb-web 在侧边栏里内置了搜索入口，搜索对话框（src/components/dialogs/searchDialog/）连的是 qBittorrent 自带的搜索插件机制。启用几个你常用的搜索插件后，输入关键词，所有已启用插件会并行开搜，结果统一汇总到一张表里，看中哪个直接转成下载任务。等于把"搜资源"和"下资源"焊死在同一个页面里，来回切换的功夫全省了。
手机适配与多语言：外出也能随手管理
qb-web 的响应式设计不是凑合——手机端会把表格压缩成更适合触屏的布局，分页和操作按钮重新排布，横屏竖屏都能用。再加上开箱即用的中英俄土多语言支持（语言文件在src/locale/目录），无论是给家里长辈配置远程管理，还是出国旅行时手机上远程控制家里 NAS 上的 qBittorrent，都毫无压力。
结尾：给你的种子管理界面一次"换新装"的机会
回到开头那个问题：qBittorrent 是不是真的只能顶着那张"老脸"？现在你知道了，答案当然是否定的。qb-web 用 TypeScript + Vue 把管理界面的体验拉回了现代水准——侧边栏多维筛选、批量操作、RSS 规则自动化、内嵌搜索，每一项都是冲着"让种子管理更省心"去的。
想动手试试？去项目的 Release 页面下载最新包，按上面的三步配置，十分钟内就能换装成功。如果你也想参与开发，把仓库https://gitcode.com/gh_mirrors/qb/qb-webclone 到本地，跑一遍DEV.md里的yarn install && yarn serve，改完代码提交一个 Pull Request，你的名字就会出现在这个好用工具的贡献者列表里。别让你的下载列表继续"将就"下去了。
【免费下载链接】qb-webA qBittorrent Web UI, write in TypeScript+Vue.项目地址: https://gitcode.com/gh_mirrors/qb/qb-web
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
