agalwood / Motrix

查看原文 / View Original 编辑 / Edit

agalwood / Motrix

Motrix: A modern, full-featured download manager that stays simple to use. Motrix：一款现代、功能全面且保持简洁易用的下载管理器。

Overview

Motrix is a clean, full-featured desktop download manager for HTTP, FTP, BitTorrent, magnet links, and more. Motrix Turbo is Motrix v2, rebuilt from the ground up with Electron, React, and TypeScript while keeping the clean, straightforward experience of v1. The download core is independent of the UI. Browser extensions and command-line tools communicate with the app over MDXP (Motrix Download eXchange Protocol), an open protocol built on JSON-RPC 2.0, while plugins run in isolated sandboxes. The same core powers two ways to run Motrix:

  • Desktop app: Runs on macOS, Windows, and Linux
  • Headless server: Runs without a desktop environment, either directly on Node.js or in Docker, and includes a web UI for NAS devices and home servers

概述

Motrix 是一款界面简洁、功能全面的桌面下载管理器，支持 HTTP、FTP、BitTorrent、磁力链接等多种协议。Motrix Turbo 即 Motrix v2，基于 Electron、React 和 TypeScript 从零重构，同时保留了 v1 版本简洁直观的使用体验。下载核心与 UI 相互独立。浏览器扩展和命令行工具通过 MDXP（Motrix 下载交换协议）与应用通信，该协议基于 JSON-RPC 2.0 构建，插件则运行在隔离的沙箱中。同一核心支持两种运行方式：

  • 桌面应用： 可在 macOS、Windows 和 Linux 上运行。
  • 无头服务器（Headless server）： 无需桌面环境即可运行，可直接在 Node.js 或 Docker 中部署，并为 NAS 设备和家庭服务器提供 Web UI。

🧪 Beta testing

Motrix Turbo v2 is currently in beta. After its remaining release gates pass, download v2.0.0-beta.19 from GitHub Releases and read the full release notes before installing it. Back up your existing Motrix data and downloads before testing. Migration from Motrix v1 data has not yet been validated, so do not use your only copy of v1 data with this beta. When practical, test v2 in parallel using a separate OS account, machine, or Docker data directory.

🧪 Beta 测试

Motrix Turbo v2 目前处于 Beta 测试阶段。在通过剩余的发布流程后，请从 GitHub Releases 下载 v2.0.0-beta.19，并在安装前阅读完整的发行说明。测试前请务必备份现有的 Motrix 数据和下载内容。从 Motrix v1 的数据迁移尚未经过验证，因此请勿将 v1 数据的唯一副本用于此 Beta 版本。如果条件允许，请使用独立的操作系统账户、机器或 Docker 数据目录并行测试 v2。

✨ Features

  • 🕹 Clean, intuitive interface with dark mode
  • 🦄 BitTorrent downloads with per-file selection, plus magnet link support
  • 📡 Built-in tracker list management with automatic updates and health checks
  • 🔌 UPnP and NAT-PMP port mapping
  • 🚥 Upload and download limits with multiple speed-limit profiles
  • 💾 SQLite-backed sessions that restore downloads after a restart
  • 📊 Customizable Dashboard with transfer stats, live activity, and task tiles
  • 🔔 System notifications when downloads finish, plus an in-app notification center
  • 🧩 QuickJS-based plugin sandboxing, fine-grained permissions, and an in-app marketplace
  • 🌐 Chrome and Firefox extensions that hand browser downloads off to Motrix in one click
  • ⌨️ Official @motrix/cli client for everyday shell use and AI agents
  • 🐳 Docker-ready headless server with secure device-code pairing for remote CLI and agent clients
  • 🎬 Extensible URL Resolver plugins for extracting media from supported sites
  • 🤖 System tray integration and launch at startup
  • 🌍 Simplified Chinese and English UI, with more languages planned
  • 🔗 Handlers for motrix:// and magnet: links, plus .torrent file associations

✨ 功能特性

  • 🕹 简洁直观的界面，支持深色模式
  • 🦄 支持 BitTorrent 下载及单文件选择，支持磁力链接
  • 📡 内置 Tracker 列表管理，支持自动更新和健康检查
  • 🔌 支持 UPnP 和 NAT-PMP 端口映射
  • 🚥 支持上传和下载限速，并可设置多种限速配置
  • 💾 基于 SQLite 的会话管理，重启后可恢复下载
  • 📊 可自定义的仪表盘，显示传输统计、实时活动和任务卡片
  • 🔔 下载完成系统通知，内置应用内通知中心
  • 🧩 基于 QuickJS 的插件沙箱，支持细粒度权限控制和应用内插件市场
  • 🌐 Chrome 和 Firefox 扩展，一键将浏览器下载任务接管至 Motrix
  • ⌨️ 官方 @motrix/cli 客户端，适用于日常 Shell 使用和 AI 代理
  • 🐳 支持 Docker 的无头服务器，通过安全设备码配对远程 CLI 和代理客户端
  • 🎬 可扩展的 URL 解析插件，用于从支持的站点提取媒体资源
  • 🤖 支持系统托盘集成和开机自启
  • 🌍 支持简体中文和英文界面，未来计划支持更多语言
  • 🔗 支持 motrix:// 和 magnet: 链接协议处理，以及 .torrent 文件关联

🧩 Ecosystem

Motrix extends beyond the desktop app with a shared protocol library, command-line client, browser extensions, and a complete plugin toolchain.

🧩 生态系统

Motrix 不仅仅是一个桌面应用，它还拥有共享协议库、命令行客户端、浏览器扩展以及完整的插件工具链。

CLI quick start

npm install -g @motrix/cli # Requires Node.js 22 or later
motrix add https://example.com/file.iso --save-dir ~/Downloads
motrix list # List downloads
motrix watch --stats # Stream live progress as NDJSON
motrix pair --name my-nas # Pair with a remote or headless instance

CLI 快速入门

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 # 与远程或无头实例配对

Build a plugin

The Motrix Plugin SDK provides the TypeScript API, manifest schema, project scaffolder, and CLI used throughout the plugin development workflow. Plugins are bundled as a single ES2020 module and run inside a QuickJS sandbox without Node.js APIs or direct file and network access.

构建插件

Motrix 插件 SDK 提供了在整个插件开发工作流中使用的 TypeScript API、清单架构、项目脚手架和 CLI。插件被打包为单个 ES2020 模块，并在 QuickJS 沙箱中运行，无法直接访问 Node.js API 或直接进行文件和网络操作。

📦 Installation

Desktop app: Download Motrix from motrix.app and choose the package for your operating system. Most Mac users should choose the Apple Silicon build; Intel builds are available for older Macs with Intel processors.

📦 安装

桌面应用： 从 motrix.app 下载 Motrix 并选择适合您操作系统的安装包。大多数 Mac 用户应选择 Apple Silicon 版本；Intel 处理器老款 Mac 可使用 Intel 版本。

← 返回新闻列表 / Back to news list