qBittorrent开源 BitTorrent 客户端

qBittorrent / 项目研究站

qBittorrent：开源 BT 客户端怎么选、怎么配、怎么安全下载

qBittorrent 是用 C++ / Qt 写的开源 BitTorrent 客户端，底层用 libtorrent（libtorrent-rasterbar），官方定位是「其它 BT 客户端的良好替代品」。它自带 Web UI 与完整 WebAPI，能跑成无界面的 qbittorrent-nox，因此在 NAS、Docker、远程下载场景里被大量使用。本站只做三件事：帮你选对客户端、查清来源是否可信、下载前后做安全检查；本站不提供盗版资源导航，也不给任何「绝对安全」的承诺。

选择下载客户端浏览合法资源
最新稳定版 v5.2.3（2026-07-07）2026-07-07 发布 5.2.3 / 5.3.0beta1 已出源码 GPLv2+ / 二进制 GPLv3+Windows / macOS / Linux / 无界面 nox

项目来源

qbittorrent/qBittorrent · 约 4.0 万 Star / 4,879 Fork（2026-09-20 采集，数字会随社区变化）

qbittorrent/qBittorrent GitHub 仓库页面截图：仓库名、About 简介、顶层目录与 Star/Fork 数 查看源码 ↗
GitHub 公开仓库页截图（2026-09-20 采集，1600×1100）。官方项目站点是 qbittorrent.org，官方 wiki / 论坛 / bug 跟踪分别是 wiki / forum / bugs.qbittorrent.org。本站不把任何第三方中文下载站称作「官网」。
What it solves

能解决哪些问题

它不负责「帮你找资源」，只负责把 BT 任务跑好。下面这些是它能实际解决的问题，以及对应的官方事实。

你要解决的问题qBittorrent 的做法依据注意点
桌面端要一个好用的 BT 客户端C++ / Qt 图形界面，底层用 libtorrentREADME 原文：C++ / Qt，使用 libtorrent（libtorrent-rasterbar）图形界面与无界面版是同一份代码的两个构建目标
NAS / 服务器上没有桌面环境构建时 -DGUI=OFF 得到 qbittorrent-nox，只跑后台 + Web UIINSTALL 第 2b 节原文命令nox 版没有图形界面，只能通过 Web UI 或 API 操作
想远程看进度、加任务内置 Web UI（src/webui/www）与 WebAPI仓库目录结构 + WebAPI_Changelog（当前 API 版本 2.16.2）暴露到公网前必须先看远程访问安全那一页
要自动化 / 接自己的脚本WebAPI 提供 preferences、torrents、transfer、sync、search、rss 等端点WebAPI_Changelog 端点清单API 版本会随版本演进，写脚本前先核对你的版本
要按规则自动下载订阅内容RSS 自动下载规则，并可用 API 导出/导入规则rss/exportRules、rss/importRules规则里放什么源由你决定，本站不提供资源源
要限制速度、连接数、时段内置限速与调度、连接数上限等设置客户端「速度」「连接」设置项限速不是万能的，速度问题的定位见排查页
要验证下载物没被篡改官方对源码包与二进制提供 PGP 签名README：自 v3.3.4 起签名，密钥 4096R/5B7CC9A2，指纹 D8F3DA77AAC6741053599C136E4A2D025B7CC9A2这是本站安全检查页的核心依据，见安全检查清单
它不负责的三件事：①不提供资源，BT 协议本身只负责传输；②不判断内容是否合法，合法性由你下载的东西决定；③不保证匿名，BT 默认会把你的 IP 暴露给 peer（除非你另做网络层处理）。
Concepts

三步建立心智模型：种子、磁力、节点发现

90% 的「下载没速度 / 磁力打不开」问题，都是这三个概念没分清。

  1. 种子文件（.torrent）= 一份目录清单

    它记录的是文件名、大小、分块哈希与 tracker 地址，本身不含内容。所以「种子文件很小」是正常的——它只是一张地图。

  2. 磁力链接（magnet:）= 用哈希找清单

    磁力只带一个 infohash（20 字节）加可选参数。客户端拿到它之后要先向 peer 询问元数据，这个过程（metadata 交换）期间显示「下载元数据中」是正常的，不是卡死。qBittorrent 的 Changelog 里还有一条针对磁力 so 参数的支持，说明磁力参数也在持续跟进。

  3. Tracker / DHT = 两种找人方式

    Tracker 是中心化协调服务器，DHT 是分布式节点表。两者可同时工作：tracker 连不上时 DHT 往往是唯一的出路，这也是「为什么私密站点必须用 Tracker、公开资源更依赖 DHT」的原因。

概念一句话解释对使用的影响相关页面
Infohash对种子元数据算出的 20 字节摘要，是资源的唯一标识同名资源可能是不同 infohash，即不同内容BT 基础
Tracker告诉你「谁有这个资源」的服务器Tracker 失效不等于资源失效排查页
DHT去中心化的节点表，不需要 tracker公开资源的主要发现方式；内网/禁 DHT 环境会变慢同上
做种 / 分享率你上传给别人的比例分享率长期低于 1 通常会被私密站点限制BT 基础
端口连通性别人能否主动连上你端口不通通常表现为「能下载但很慢、几乎不上传」排查页
Task routes

按你的问题直接进对应页面

六个入口覆盖从「完全不懂」到「NAS 自动化」的常见路径。

1. 磁力和种子有什么区别

先把 infohash、Tracker、DHT、做种、分享率这几个词弄清，后面的问题基本都会自解。这一页不含任何资源链接。

看 BT 基础 →

2. 我该装哪个客户端

本客户端、Transmission、Deluge、aria2 四款的定位差别很大：一个偏图形界面全能、一个偏轻量稳定、一个是 Python 生态、一个纯命令行。

看客户端对比 →

3. 怎么装、装在哪个平台

Windows / macOS / Linux 都有官方发布物；源码编译有明确的依赖下限（Qt 6.6+、libtorrent 1.2.19+ 或 2.0.10+），NAS 常用 nox 构建。

看安装与平台 →

4. 想让手机也能看进度

Web UI 与 WebAPI 是同一套后端。远程可达的代价是暴露面变大，所以这一页把「怎么开」和「怎么别被扫到」放在一起讲。

看 WebUI 与 API →

5. 速度为 0 / 连接数为 0

先分清是「没人做种」「端口不通」「Tracker 连不上」还是「磁力还没拿到元数据」——四类问题的处理路径完全不同。

看速度与连接排查 →

6. 下载的东西安全吗

提供一份可执行的安全检查清单：扩展名与双扩展名、密码压缩包、哈希与官方 PGP 签名比对、下载后的隔离扫描顺序。

看安全检查清单 →

Clients

四款主流客户端：先看事实，再看取舍

下表数字来自各自 GitHub 公开接口（2026-09-20 采集）。注意 star 数不等于质量，且其中一个仓库只是镜像。

客户端形态Star / Fork最新发布适合谁关键提醒
本客户端C++ / Qt 图形界面 + 无界面 nox40,217 / 4,879v5.2.3（2026-07-07）要图形界面、要 WebUI/API、要 NAS 部署仓库约 310 MB，issue 数很高（2,699），说明社区活跃也说明报 bug 前要自己先排查
TransmissionC++，轻量，多平台15,222 / 1,4464.1.3（2026-06-30）要「装了就不管」的稳定优先派仓库自述是「Official Transmission BitTorrent client repository」
DelugePython，守护进程 + 瘦客户端1,796 / 364GitHub 无 release喜欢 Python 生态、要插件化该仓库自述是镜像（“Git mirror, PRs only”），star 数不代表真实热度
aria2纯命令行，多协议下载器42,541 / 3,923release-1.37.0（2023-11-15）脚本党、要 RPC 自动化、要 HTTP+FTP+BT 一个工具它不只是 BT 客户端；最新 release 距今较久，新功能看仓库提交
看 12 项维度逐条对照看安装方式
Boundary

本站做什么、不做什么

BT 协议本身中立，用它的场景却不都合法。这一节把边界写清楚，避免误会。

领域本站收录本站不收录为什么
Linux 发行版镜像官方提供的 BT/磁力分发入口来源不明的二次打包镜像官方 ISO 自带校验值，可验证
开源软件与字体项目官方发布页的种子/直链破解版、注册机、激活工具后者属侵权且常捆绑恶意程序
公共领域与 CC 作品明确标注公版或 CC 授权的作品标注含糊的「合集」授权不清的内容无法核验合法性
学术与开放数据集官方或机构发布的公开数据集入口绕过访问控制的镜像绕过授权即有法律风险
影视/音乐/游戏官方授权的分发渠道未经授权的影视、音乐、软件、游戏传播与聚合这是明确划出的红线
规避手段—规避版权保护的技术教程与工具不提供
三条不许承诺的话：本站不会写「绝对安全」「百分百无毒」「永久稳定」「官方唯一入口」。能写的是「截至某时间页面可正常访问」「当前检测未发现明显异常」「建议从官方地址下载，并自行核验文件」。
FAQ

关于 qBittorrent 的高频问题

答案以官方 README / INSTALL / COPYING / WebAPI_Changelog 与 GitHub 公开数据为依据；本站未在本机安装运行，命令请以官方为准。

本客户端 是免费的吗？许可是什么？

免费且开源。许可有一处容易被忽略的细节：源码是 GPLv2+，而二进制发行版是 GPLv3+（因为它打包了 GPLv3+ 的资源文件，比如图片），两种情况都额外附加了链接 OpenSSL 的例外条款。这也解释了为什么 GitHub 的许可证字段显示 NOASSERTION 而不是单一 SPDX 标识。以仓库 COPYING 为准。

官方站点到底是哪个？我看到很多自称中文官方的站。

官方项目站点是 qbittorrent.org，配套的官方站点还有 wiki.qbittorrent.org（文档）、forum.qbittorrent.org（求助）、bugs.qbittorrent.org（报 bug），以及 IRC 频道 #qbittorrent（irc.libera.chat）。本站不把任何第三方中文下载站称为「官方站点」——从第三方站拿安装包会跳过官方的 PGP 签名校验环节。

我该用哪个版本，beta 能用吗？

GitHub 上最新稳定发布是 v5.2.3（2026-07-07），同时存在 release-5.3.0beta1 标签，Changelog 里还记录着 v5.3.0alpha1 的未发布改动。稳妥做法是用稳定版；测试版适合能自己看日志、能接受回归的人。另外注意官方安全策略：只修最新稳定分支上的漏洞——这是「为什么要及时升级」的官方依据。

能装在 NAS 上吗？

可以，官方支持无图形界面构建：cmake -B build -DCMAKE_BUILD_TYPE=Release -DGUI=OFF 后得到 qbittorrent-nox，之后通过 Web UI 或 WebAPI 操作。具体到某个 NAS 系统该用哪个包，请以该系统与官方文档为准——本站不代任何第三方镜像背书。

下载速度很慢，是客户端的问题吗？

多数情况不是。先按四类原因分：①做种人数太少（别人没有数据可给）；②端口不通导致只能被动连接；③Tracker/DHT 都连不上（对等节点发现失败）；④磁力仍在拉取元数据。诊断顺序见速度与连接排查。

本站会推荐资源站吗？

不会列第三方资源站。原因不是「不能提」，而是本站无法持续检测它们的可用性、跳转风险和版权状态，推荐了就等于替不可验证的东西背书。本站只给官方自建分发渠道的入口形态，以及下载前如何自验的方法。

用 BT 下载本身违法吗？

BT 只是一种传输协议，本身中立；合法性取决于你下载和分发的具体内容以及所在法域的规定。本站不提供法律意见，也不提供任何侵权资源的获取方式；如果你的用途涉及受版权保护的作品，请先确认授权情况。

下一步：先弄清磁力和种子的区别

把 infohash、Tracker、DHT、做种、分享率这几个词分清，绝大多数「打不开 / 没速度」的问题都会自己找到方向。

看 BT 基础先看安全检查