📌 项目地址agalwood/Motrix | ⭐ 52,947 颗星 | 🔧 TypeScript | 📜 未标注

这个项目解决什么问题

下载工具是每个用电脑的人都会碰到的需求。浏览器自带的下载管理在断点续传、大文件、BT 场景下往往不够用;传统的下载软件要么界面老旧,要么捆绑广告,要么只支持单一协议。Motrix 想做的是一款“干净、全功能但保持简单易用”的桌面下载管理器,同时支持 HTTP、FTP、BitTorrent、磁力链接,并提供了 Windows、macOS、Linux 桌面版和无头服务器模式。

Motrix 不是一个新项目,GitHub 上已有 52k+ Star。当前值得关注的是 Motrix Turbo (v2),它用 Electron、React、TypeScript 从零重写,下载核心与 UI 解耦,并引入了开放的 MDXP 协议(基于 JSON-RPC 2.0),浏览器扩展、命令行工具都通过它和应用通信。这意味着 Motrix 不只是“下载工具”,而是一个可扩展的下载基础设施。

核心特性:不止是下载

以下是 v2 里比较关键的能力:

  • BT/磁力支持:支持 BitTorrent 下载和磁力链接,并且可以在下载前选择文件。
  • Tracker 管理:内置 tracker 列表管理,支持自动更新和健康检查。
  • 端口映射:支持 UPnP 和 NAT-PMP,用于提升 BT 下载的连通性。
  • 速度限制:可以设置上传/下载限速,还支持多个限速配置档。
  • 会话持久化:基于 SQLite 保存会话,重启后可以恢复下载任务。
  • 插件系统:基于 QuickJS 的沙箱插件,有细粒度权限控制和应用内插件市场。
  • 浏览器集成:提供 Chrome 和 Firefox 扩展,一键把浏览器下载任务交给 Motrix。
  • 命令行客户端:官方提供 @motrix/cli,适合日常 shell 使用,也方便 AI agent 调用。
  • 无头服务器模式:支持 Docker 部署,在 NAS 或家用服务器上运行,并带有 Web UI。
  • 系统集成:托盘、开机启动、motrix://magnet: 协议关联、.torrent 文件关联。

注意到一个独特的点:Motrix v2 的下载核心不依赖 UI,所以同一套核心可以同时驱动桌面应用和无头服务器。对于有 NAS 或 Linux 服务器的用户,可以把 Motrix 当做一个常驻下载服务,通过 Web UI 或远程 CLI 操作,而不必在每台电脑上都装客户端。

实际用法:目前可以参考的入口

Motrix v2 目前处于 Beta 阶段。README 明确说明,请从 GitHub Releases 下载 v2.0.0-beta.18,并在安装前阅读完整发布说明。需要注意的是,从 Motrix v1 迁移数据尚未验证,因此不要使用唯一的 v1 备份数据来测试 v2。

实际的安装和使用命令,建议参考以下渠道:

  • 桌面应用:去官方 GitHub Releases 页面下载对应系统的安装包(macOS/Windows/Linux)。
  • Docker 部署:README 提到支持 Docker-ready headless server,但未给出具体命令,需要参考官方文档。
  • 命令行客户端:官方提供 @motrix/cli,具体安装和使用方式查阅官方文档。
  • 浏览器扩展:在 Chrome Web Store / Firefox Add-ons 中搜索 Motrix 扩展,一键接管浏览器下载。
  • 插件开发:MDXP 协议是开放的,可以基于 JSON-RPC 2.0 编写自己的插件或客户端。

由于 README 没给具体 CLI 命令,这里不凭空举例。想用命令行方式操作 Motrix 的读者,直接去官方仓库的文档目录或 npm 页面找 @motrix/cli 的说明即可。

和同类工具的区别

下载管理器的经典选择有 aria2、qBittorrent、迅雷等。Motrix 的位置比较特殊:

  • 对比 aria2:aria2 是纯 CLI/JSON-RPC 工具,功能强大但没有官方 GUI。Motrix 提供了完整的桌面界面,同时保留命令行和远程控制能力,适合既要界面又要可编程性的用户。
  • 对比 qBittorrent:qBittorrent 对 BT 支持成熟,但界面和功能面向重度 BT 用户;Motrix 更偏向“通用下载管理器”,HTTP/FTP/BT 都覆盖,UI 更简洁现代,而且自带插件系统和云原生部署形态。
  • 对比迅雷:开源、无广告、无限速(取决于你的网络环境),并且有跨平台支持。
  • MDXP 协议:这是 Motrix v2 的独特设计,下载客户端与 UI 解耦后,可以用统一协议对接多种前端、CLI、插件,理论上可以构建更丰富的自动化工作流。

需要注意的事项

  • 版本状态:Motrix v2 还是 beta,README 用“Beta testing”明确提示,并且警告 v1 数据迁移尚未验证。如果目前在生产环境稳定使用 v1,不要贸然升级到 v2,更不要用仅存的 v1 数据去测试。
  • 备份要求:测试 v2 前务必备份现有的 Motrix 数据和下载列表。建议在独立的操作系统账户、独立机器或独立的 Docker 数据目录中并行测试。
  • 许可证:README 正文没有指明具体开源许可证。项目仓库可能有 LICENSE 文件,实际使用或分发前请检查仓库根目录。
  • 插件安全:插件运行在 QuickJS 沙箱中,但第三方插件仍需以信任为前提交付,注意审视权限请求。

总结

Motrix 是一个定位清晰的下载管理器:它不想做最复杂的工具,而是想做“现代、全功能、简洁易用”的默认选择。v2 的重写让它架构上更先进,MDXP 协议、插件沙箱、无头模式都是值得关注的方向。如果你需要一款开源、跨平台、支持多种下载协议、还能在上面做自动化的下载工具,Motrix 值得尝试,但请等它走出 beta,或者做好隔离测试的准备。

这篇文章对你有帮助吗?

发表回复