README

Motrix
  简洁易用、功能丰富的现代下载管理器


 !Build/release !Total Downloads

English | 简体中文

 简介

Motrix 是一款界面简洁、功能丰富的桌面下载管理器，可处理 HTTP、FTP、BitTorrent 和磁力链接（Magnet）等多种下载任务。

Motrix Turbo 是 Motrix 的 v2 版本。它保留了 v1 简洁易用的特点，并使用 Electron、React 和 TypeScript 重新开发。下载内核与界面相互独立；浏览器扩展和命令行工具通过开放协议 MDXP（Motrix Download eXchange Protocol，采用 JSON-RPC 2.0）与应用通信，插件则在独立的沙箱中运行。

同一套内核既可用于桌面应用，也可作为 Headless server 运行：

- 桌面应用：可在 macOS、Windows 和 Linux 上运行；
- Headless server：无需桌面环境，可直接使用 Node.js 运行或通过 Docker 部署，并提供 Web 界面，适合安装在 NAS 和家庭服务器上。

 Motrix 2.4.1

Windows 下载在一个服务器地址连接失败时，现在会继续尝试其他已解析的地址。
本版还更新了桌面端、Web UI 和 Server 命令行使用的翻译组件。
从 GitHub Releases 下载 v2.4.1，
并阅读完整发布说明。

升级前请备份现有 Motrix 配置和下载文件。捆绑引擎会将 SQLite 数据库升级至
schema 6，并保留升级前备份；旧引擎无法打开 schema 6，如需降级必须保留该备份。
桌面端迁移助手会将选中的 v1 任务导入为暂停记录，并保留原文件；恢复下载需要
单独明确操作。Windows 原位激活 BitTorrent 任务要求使用受支持的本地 NTFS 卷，
并明确授权。支持的磁盘类型、文件权限和恢复方式见
迁移指南。请保留原始 v1 配置。

 应用截图

 仪表盘


  
  
  


 下载任务


  
  
  


 设置


  
  
  


 ✨ 主要功能

- 🕹 简洁直观的图形界面，支持深色模式
- 🦄 支持 BT 和磁力链接任务，可按需选择种子中的文件
- 📡 内置 Tracker 列表，可自动更新并检查可用性
- 🔌 支持 UPnP 和 NAT-PMP 端口映射
- 🚥 可限制上传和下载速度，并在多档限速模式之间切换
- 💾 下载会话保存在 SQLite 中，重启应用后可自动恢复任务
- 📊 Dashboard 支持自定义布局，可展示传输统计、实时活动和任务磁贴
- 🔔 下载完成时发送系统通知，应用内也可集中查看通知
- 🧩 插件采用 QuickJS 沙箱隔离和细粒度能力授权，并可直接从应用内插件市场安装
- 🌐 Chrome、Edge 和 Firefox 上的 Motrix Extension 可一键将浏览器下载任务交给 Motrix
- ⌨️ 官方命令行客户端 @motrix/cli 既适合日常操作，也可供 AI agent 调用
- 🐳 Headless server 可通过 Docker 部署，远程 CLI 和 agent 可使用 device-code 安全配对
- 🎬 URL Resolver 插件可解析站点媒体页面，并可扩展对更多站点的支持
- 🤖 可驻留系统托盘，并支持开机自启动
- 🌍 界面支持简体中文和英语，后续将加入更多语言
- 🔗 注册 motrix:// 和 magnet: 协议处理程序，并关联 .torrent 文件

 🧩 周边生态

除了桌面应用，Motrix 还提供协议库、命令行客户端、浏览器扩展和插件开发工具。这些项目与应用本身共同组成 Motrix 生态：

| 项目 | 形式 | 说明 |
|------|------|------|
| @motrix/mdxp | npm 包 | 集中定义 MDXP 的 JSON-RPC 2.0 wire schema 和 Zod 类型，并提供双向连接工具，让通信两端使用同一套协议 |
| @motrix/cli | npm 包 | 命令行客户端，可执行命令为 motrix。它能自动发现并控制本地桌面应用，也能与远程实例配对 |
| Motrix Extension | 浏览器扩展 | 面向 Chrome、Edge 和 Firefox 的 MV3 扩展，可接管浏览器下载任务，并通过 native messaging 与桌面应用安全配对 |
| Motrix Plugin SDK | 4 个 npm 包 | 包括 @motrix/plugin-manifest-schema、@motrix/plugin-api、@motrix/plugin-cli 和 create-motrix-plugin，提供插件开发、调试和打包所需的工具 |
| Builtin Plugins | 已签名的 .moext | 官方提供三个内置插件：Filename Template（保存文件时按模板自动重命名）、Page Scraper（从 HTML 页面提取实际文件链接）和 URL Resolver（为站点媒体解析提供基础能力） |
| Plugin Registry | 公共数据源 | 维护插件列表和安装信息，并生成 dl.motrix.app/registry/plugins.json，供官网插件目录和应用内插件市场使用 |

 CLI 快速上手

bash
npm install -g @motrix/cli     需要 Node.js = 22

motrix add https://example.com/file.iso --save-dir ~/Downloads
motrix list                    查看任务列表
motrix watch --stats           以 NDJSON 流式输出实时进度
motrix pair --name my-nas      通过 device-code 配对远程或 headless 实例


 编写插件

Motrix Plugin SDK 提供 TypeScript API、manifest schema、项目脚手架和 CLI，覆盖完整的插件开发流程：

bash
pnpm create motrix-plugin my-plugin
cd my-plugin && pnpm install
pnpm dev                          监听构建，并启动 Motrix 加载插件
pnpm exec motrix-plugin validate  校验 motrix-plugin.json
pnpm run pack                     生成 dist/-.moext
pnpm exec motrix-plugin lint      检查打包产物


默认脚手架会创建一个使用 beforeCreat

Top issues

Discussions

Latest release

Motrix 2.4.0

English | 简体中文

 Changes since 2.3.0

- Choose File → Create Torrent File to create a BitTorrent v1 .torrent from a file or folder. Desktop users can select local files. In the Server Web UI, select a source within your account’s readable download roots and save the torrent to your browser. Enable seeding after saving to verify and seed the original files.
- Install the experimental native Synology SPK through Package Center on supported x86_64 and ARM64 models running DSM 7.2.2-72806 or later. Local administrators share the same tasks and settings. See the Synology installation