← 返回项目库

qui BT 下载管理平台

集中管理多个 qBittorrent 实例、种子状态与下载任务的轻量 Web 管理平台。

qui 以 Go 单文件服务提供仪表盘、自动化规则、跨站辅种、备份恢复、RSS 和搜索索引器等工作流,适合自部署的 BT 运营与维护场景。

真实界面

项目截图

共 8 张

仪表盘
种子
辅种
自动化
备份
RSS 订阅源
搜索索引器
设置

Capabilities

核心功能

统一查看多个 qBittorrent 实例的种子、速度与分享率
按分类、标签、Tracker 和状态筛选种子
通过规则自动执行种子管理动作
跨站匹配相同资源并辅助做种
提供备份、恢复和备份策略配置
管理 RSS 订阅与自动化下载规则
配置搜索索引器、通知和实例连接参数

适用场景

在家庭服务器上集中维护多个 qBittorrent 下载实例
按分享率、分类或标签自动整理长期做种任务
为跨站辅种、备份恢复和 RSS 自动下载提供统一操作入口

适合谁

需要统一维护多个 qBittorrent 实例的个人用户、家庭服务器维护者和小型技术团队。

商业化思路

开源源码交付,适合自部署和二次开发;不包含 qBittorrent 托管实例、Tracker 资源、下载内容或第三方服务额度。

你会拿到什么

  • qui 中文界面源码包与上游 GPL-2.0-or-later LICENSE
  • 本地构建、服务启动、qBittorrent 兼容演示和 8 个运行界面验证记录

部署流程

  1. 1准备 qBittorrent 4.3.0+,从源码目录执行 make build,或按 distrib/docker 文件构建容器
  2. 2执行 ./qui serve --config-dir /config,访问默认 http://localhost:7476 并添加 qBittorrent 实例

真实验证结果

已完成 make build、前端 919 项测试、i18n 检查、Go race 全量测试运行,并通过 1440x900 下 8 个真实运行中文功能页面的 HTTP、可见内容、控制台、破图和横向溢出质量门。make precommit 的 golangci-lint 子步骤因本机未安装该命令未完成。

部署前须知

本次运行证据使用仅监听 127.0.0.1:18080 的本地 qBittorrent API 兼容演示夹具,实际部署需要用户提供可访问的 qBittorrent 实例;高级搜索、RSS 和主题能力依赖相应外部服务或授权配置。

部署难度

中等

最低配置

Linux、macOS 或 Windows;qBittorrent 4.3.0+;建议至少 512MB 可用内存。可使用 Go 构建环境和 Node.js/pnpm 完成前端构建;Docker 部署文件随源码提供。

开源许可证

GPL-2.0-or-later

最后验证

2026-09-01

技术栈

GoReactTypeScriptViteSQLiteqBittorrent Web API

授权说明

保留上游 LICENSE 与版权声明。GPL-2.0-or-later 要求分发修改版本时继续提供相应许可与源码权利;本交付包含中文界面适配,修改方不主张上游源码权利。

Release notes

版本记录

1 个已发布版本

vcn-2adfd140eacb 当前推荐

保留上游 qui 功能并完成中文运行界面验证;采集仪表盘、种子、辅种、自动化、备份、RSS、搜索索引器和设置共 8 个功能状态。

部署要求:qBittorrent 4.3.0+;Linux/macOS/Windows;建议 512MB 以上可用内存;高级功能按需配置外部服务。

已知问题:本交付不包含 qBittorrent 服务、下载内容、Tracker 资源或外部搜索/RSS 服务;生产使用前需由部署者自行配置并验证这些依赖。

登录后领取