Motrix - A full-featured download manager
Motrix 是一款现代化、功能全面的跨平台下载管理器，支持 HTTP、FTP、BitTorrent、磁力链接等协议，拥有简洁界面、深色模式、插件系统、命令行客户端与 Docker 无头服务器，适用于日常下载与 NAS 部署。
社区作者 · zZz
它解决什么问题
Motrix 是一个简洁易用的全功能桌面下载管理器，支持 HTTP、FTP、BitTorrent、磁力链接等下载协议。Motrix Turbo（即 Motrix v2）使用 Electron、React 和 TypeScript 从头构建，下载核心与 UI 独立，通过 MDXP（Motrix Download eXchange Protocol）协议连接浏览器扩展和命令行工具，插件在隔离沙箱中运行。桌面应用运行于 macOS、Windows 和 Linux，同时提供无桌面环境的 headless 服务器，可直接在 Node.js 或
Docker 中运行，并附带 Web UI，适合 NAS 和家庭服务器。主要功能包括深色模式、BitTorrent 每文件选择、磁力链接支持、内置 tracker 列表管理、UPnP/NAT-PMP 端口映射、多档限速、SQLite 会话恢复、可自定义仪表盘、系统通知、QuickJS 插件沙箱、浏览器扩展一键接管下载、官方 CLI 客户端、Docker 部署等。项目生态包含协议库（@motrix/mdxp）、CLI（@motrix/cli）、浏览器扩展、插件 SDK、三个官方插件以及插件注册表。技术栈为 Electron 43、React 19、Tailwind CSS 4、TypeScript、Vite 8、Zod 4、aria2 分支、better-sqlite3、quickjs-emscripten、Fastify + WebSocket、i18next。适合需要跨平台下载管理、NAS 远程下载、命令行下载管理或插件扩展能力的用户。许可证为 MIT。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
桌面应用安装：访问 motrix.app 下载对应操作系统的安装包。macOS 12+ 提供 arm64（Apple Silicon）和 x64（Intel）两种 .dmg/.zip，大多数 Mac 用户应选择 Apple Silicon 构建；Windows 提供 x64 的 .exe（NSIS 安装器）或 .zip；Linux 提供 x64/arm64 的 .AppImage、.deb、.rpm，.AppImage 可便携运行，.deb 适用于 Debian/Ubuntu，.rpm 适用于 Fedora/openSUSE。Linux .AppImage 首次启动会询问是否注册桌面项和 URL 协议处理，可在“设置 → 集成”中随时启用或移除。Windows x64 包未签名，可能触发 SmartScreen 警告。注意：若安装 v2.0.0-beta.25 测试版，请先备份现有 Motrix 数据和下载内容，v1 数据迁移尚未验证，建议在独立账户、机器或
Docker 数据目录中并行测试。命令行客户端安装：
npm install -g @motrix/cli（要求 Node.js 22 或更高版本），也可以从桌面应用“设置 → 集成 → 命令行工具”安装。
Docker 无头服务器部署：先创建数据目录并设置权限：mkdir -p motrix-data downloads && sudo chown 1000:1000 motrix-data downloads；然后导出镜像和公共 URL 变量：
export MOTRIX_IMAGE='docker.io/motrixapp/motrix-server:2.0.0-beta.25' 和 export MOTRIX_PUBLIC_URL='http://nas.example.lan:8080'；最后拉取并启动：
docker compose pull server && docker compose up -d --wait。容器以非 root 运行，支持只读根文件系统，数据、会话和插件在容器替换后保留。标准直连 LAN 部署将 Web 服务发布在 8080 端口，MDXP 发布在 16801 端口。若 Web 审批地址临时不可用，可通过 SSH 操作审批：
docker compose exec server motrix-admin pairing pending 和 docker compose exec server motrix-admin pairing approve ABCD-EFGH。远程 CLI 和 Agent 客户端使用设备码配对；浏览器扩展通过 native messaging 与桌面应用配对，headless 服务器不提供首次扩展配对。互联网或不信任 LAN 访问需配置 TLS 反向代理和防火墙。开发环境安装：要求 Node.js 22 或更高版本和 pnpm；克隆仓库后执行
git clone https://github.com/agalwood/Motrix.git && cd Motrix，然后运行 pnpm install 安装依赖并下载对应平台的 aria2，最后 pnpm start 以 Vite HMR 模式启动 Electron 应用。常用开发命令：
pnpm test 运行单元测试，
pnpm test:e2e 运行 Playwright 端到端测试，
pnpm run lint 运行 Biome 检查，
pnpm build 构建。在 macOS 上预览 Windows/Linux 菜单栏可设置环境变量 MOTRIX_PREVIEW_MAC_MENU=1 pnpm start。构建插件：使用 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 打包 .moext 文件，
pnpm exec motrix-plugin lint 检查打包产物。插件以单个 ES2020 模块打包，在 QuickJS 沙箱中运行，无 Node.js API，无法直接访问文件或网络；权限在 motrix-plugin.json 中声明，授予前会向用户展示。
