Motrix现代、功能丰富且易用的下载管理器Motrix是一款简洁、功能全面的桌面下载管理器支持HTTP、FTP、BitTorrent、磁力链接等多种协议。Motrix Turbo即Motrix v2它基于Electron、React和TypeScript全新重构同时保留了v1简洁直观的使用体验。下载核心与UI相互独立浏览器扩展和命令行工具通过MDXPMotrix Download eXchange Protocol基于JSON - RPC 2.0的开放协议与应用程序进行通信而插件则在独立的沙箱中运行。Motrix有两种运行方式均由同一核心驱动一是桌面应用程序支持在macOS、Windows和Linux系统上运行二是无头服务器可在无桌面环境的情况下运行既可以直接在Node.js上运行也能在Docker中运行还为NAS设备和家庭服务器提供了Web UI。 测试版信息Motrix Turbo v2当前处于测试阶段。待剩余发布流程完成后可从GitHub Releases下载v2.0.0 - beta.18版本并在安装前阅读完整的发布说明。在进行测试前需备份现有的Motrix数据和下载文件。由于从Motrix v1迁移数据的功能尚未得到验证因此请勿使用v1数据的唯一副本进行此测试版的测试。条件允许时可使用单独的操作系统账户、计算机或Docker数据目录并行测试v2。截图包括仪表盘、下载列表、设置界面。✨ 功能特性Motrix具有众多功能特性有简洁直观的界面支持暗黑模式操作界面简洁易懂暗黑模式让用户在不同环境下都能舒适使用支持BitTorrent下载可按文件选择支持磁力链接方便下载种子文件和磁力链接资源内置跟踪器列表管理自动更新并检查健康状态确保下载资源的可用性支持UPnP和NAT - PMP端口映射优化下载速度支持上传和下载限速提供多种限速配置文件满足不同网络环境下的使用需求基于SQLite的会话管理重启后可恢复下载避免因意外中断而丢失下载进度有可定制的仪表盘显示传输统计信息、实时活动和任务卡片让用户实时了解下载状态下载完成时提供系统通知内置应用内通知中心不错过任何重要下载基于QuickJS的插件沙箱细粒度权限控制内置应用内插件市场可根据需求扩展功能有Chrome和Firefox浏览器扩展一键将浏览器下载任务转交至Motrix提高下载效率官方motrix/cli客户端适用于日常shell使用和AI代理方便进行命令行操作支持Docker的无头服务器通过安全的设备代码配对供远程CLI和代理客户端使用便于远程管理下载任务有可扩展的URL解析器插件用于从支持的网站提取媒体资源轻松获取所需媒体支持系统托盘集成可设置开机自启使用更加便捷提供简体中文和英文界面计划支持更多语言满足不同地区用户的需求支持motrix://和magnet:链接处理关联.torrent文件方便快捷地启动下载。 生态系统Motrix不仅仅是一个桌面应用程序还拥有共享协议库、命令行客户端、浏览器扩展和完整的插件工具链项目发布形式功能描述motrix/mdxpnpm包定义了MDXP的共享JSON - RPC 2.0线路模式和Zod类型提供双向连接辅助工具motrix/clinpm包提供motrix命令可自动发现本地桌面应用程序并与远程实例配对Motrix浏览器扩展浏览器扩展拦截Chrome和FirefoxManifest V3中的下载任务将其转交至Motrix并通过原生消息与桌面应用程序安全配对Motrix插件SDK四个npm包包括motrix/plugin - manifest - schema、motrix/plugin - api、motrix/plugin - cli和create - motrix - plugin用于开发、测试和打包插件内置插件签名的.moext包包括三个官方插件Filename Template用于在文件保存前根据模板重命名Page Scraper用于从HTML页面提取直接文件链接URL Resolver是特定网站媒体解析的基础插件注册表公共JSON源在dl.motrix.app/registry/plugins.json发布插件列表和安装元数据供网站和应用内插件市场使用CLI快速入门使用以下命令进行操作npm install -g motrix/cli # 需要Node.js 22或更高版本motrix add https://example.com/file.iso --save-dir ~/Downloadsmotrix list # 列出下载任务motrix watch --stats # 以NDJSON格式流式传输实时进度motrix pair --name my - nas # 与远程或无头实例配对构建插件Motrix插件SDK提供了在插件开发工作流程中使用的TypeScript API、清单模式、项目脚手架和CLIpnpm create motrix - plugin my - plugincd my - plugin pnpm installpnpm dev # 监视构建并使用插件启动Motrixpnpm exec motrix - plugin validate # 验证motrix - plugin.jsonpnpm run pack # 创建dist/-.moextpnpm exec motrix - plugin lint # 检查打包后的捆绑包默认的脚手架从beforeCreate URL解析器开始。在项目名称后传递post - action可改为从afterComplete通知插件开始。插件可以挂钩到beforeCreate、beforeFinalize、afterComplete和onError事件提供可调用的命令和设置并通过motrix:plugin - api虚拟模块访问运行时。插件被打包为单个ES2020模块在QuickJS沙箱中运行没有Node.js API以及直接的文件和网络访问权限。在motrix - plugin.json中声明激活事件、所需功能和URL范围的主机权限Motrix会在授予访问权限之前向用户显示这些请求。请参阅插件SDK文档以了解模板、清单和运行时API参考、本地化、沙箱约束、打包和分发等内容。 安装安装方式如下桌面应用程序从motrix.app下载Motrix并选择适合你操作系统的软件包。大多数Mac用户应选择Apple Silicon版本较旧的搭载Intel处理器的Mac可选择Intel版本。待剩余发布流程完成后当前的测试版桌面软件包将通过上述GitHub预发布版本进行分发。此测试版不发布Snap包预发布标签运行在源代码验证后停止不会构建或发布Snap工件。请选择与你的操作系统和架构匹配的软件包macOS 12支持arm64Apple Silicon和x64Intel架构提供.dmg和.zip格式。建议使用与你的Mac匹配的.dmg包仅在基于Intel的Mac上选择x64版本。Windows支持x64架构提供.exeNSIS安装程序和.zip格式。使用.exe安装程序进行正常安装或使用.zip包进行手动提取。Linux支持x64和arm64架构提供.deb和.rpm格式。在Debian或Ubuntu系统上使用.deb包在Fedora或openSUSE系统上使用.rpm包。此测试版不发布AppImage或Snap包Flatpak单独验证不通过发布标签发布。Windows arm64和所有32位软件包均不可用。Windows x64软件包未签名可能会触发Windows SmartScreen警告。命令行客户端可以使用npm install -g motrix/cli进行全局安装也可以在桌面应用程序的“设置”→“集成”→“命令行工具”中进行安装。使用Docker的无头服务器标记版本会将多架构的服务器镜像发布到Docker Hub和GHCR。测试版仅发布不可变的版本标签不会更新latest标签包含的compose.yaml文件将服务器状态与下载资源分开保存mkdir -p motrix - data downloadssudo chown 1000:1000 motrix - data downloadsexport MOTRIX_IMAGEdocker.io/motrixapp/motrix - server:2.0.0 - beta.18export MOTRIX_PUBLIC_URLhttp://nas.example.lan:8080docker compose pull serverdocker compose up -d --wait运行时以非root用户身份运行支持只读根文件系统在接受任务前验证挂载权限并在容器替换时保留下载文件、会话和已安装的插件。标准的直接LAN设置会在端口8080上发布Web服务在端口16801上发布MDXP服务。将MOTRIX_PUBLIC_URL设置为远程客户端实际可以访问的Web审批URLCompose文件不会替换误导性的localhost URL。如果Web审批URL暂时不可用SSH操作员可以列出并批准确切的客户端代码而无需暴露另一个端口docker compose exec server motrix - admin pairing pendingdocker compose exec server motrix - admin pairing approve ABCD - EFGH远程CLI和代理客户端通过设备代码流程进行配对。浏览器扩展通过原生消息与桌面应用程序配对无头服务器不提供扩展首次配对功能。仅在受信任的LAN上适合使用直接HTTP访问。互联网或不受信任的LAN访问需要TLS反向代理和围绕源端口的防火墙规则。有关所有权设置、Docker Hub/GHCR镜像和标签选择、DSM 7和fnOS安装、端口、诊断以及备份/升级说明请参阅Docker服务器部署指南。 开发开发需要Node.js 22或更高版本以及pnpm。请使用package.json中packageManager字段指定的pnpm版本。git clone https://github.com/agalwood/Motrix.gitcd Motrixpnpm install # 安装依赖项为你的平台下载aria2并重新构建原生模块pnpm start # 在开发模式下启动Electron应用程序渲染器中使用Vite HMRpnpm test # 运行Vitest单元测试pnpm test:e2e # 运行Playwright E2E测试pnpm run lint # 运行Biome检查pnpm build # 获取签名的内置插件然后构建原生主机和四个Vite目标在macOS上预览窗口内应用程序菜单Windows和Linux系统会在Motrix窗口内渲染应用程序菜单。若要在macOS开发时预览该界面请在启用预览标志的情况下启动应用程序MOTRIX_PREVIEW_MAC_MENU 1 pnpm start该标志会隐藏主窗口的macOS交通灯按钮并启用渲染器下拉菜单。更改标志后请重启开发进程因为Electron和Vite都会在启动时读取该标志。此模式用于布局和命令项调试。由于Electron通过AppKit的原生菜单路由macOS角色项因此从预览下拉菜单调用诸如“窗口”→“最小化”等基于角色的操作时其行为可能与原生操作不完全相同。请在Windows或Linux上验证这些原生角色操作。有关可用的打包命令请参阅package.json中的脚本。macOS、Windows和Linux的特定平台设置位于electron - builder.json中。 技术栈领域技术栈桌面外壳Electron 43UIReact 19 Tailwind CSS 4 shadcn/ui语言严格模式的TypeScript构建系统Vite 8具有独立的主进程、预加载、工作进程和渲染器目标验证Zod 4用于设置、IPC有效负载和线路模式下载引擎Motrix维护的aria2分支与应用程序捆绑在一起持久化better - sqlite3用于下载会话存储和恢复插件沙箱quickjs - emscripten服务器运行时Node.js Fastify WebSocket国际化i18next react - i18next质量工具Biome、Vitest和Playwright代码库分为四个严格的层次。持续集成CI会强制执行它们之间的依赖边界确保核心具有可移植性并为未来的Rust重写留出清晰的路径renderer (React UI)│IPC via window.motrix│app core (tasks, settings, plugins, bridge)│engine adapter│aria2 (download engine)Electron桌面应用程序和Node.js无头服务器共享相同的核心。诸如通知和秘密存储等特定平台功能有独立的实现但行为保持一致。 许可证Motrix采用MIT许可证版权所有 © 2018至今Dr_rOot。有关第三方许可证信息请参阅THIRD_PARTY_NOTICES.md。发布软件包还会在legal/目录下包含生成的依赖项清单、合并的许可证文本和SPDX 2.3 SBOM。Motrix Turbo v2有如此多的特性和功能它在未来能否满足更多用户的需求成为下载管理器中的佼佼者呢
