Motrix 2.0.0-beta.1 发布说明解读:Motrix Turbo v2 的初始 Beta 范围、分发矩阵与源码级验证

Motrix 2.0.0-beta.1 发布说明解读:Motrix Turbo v2 的初始 Beta 范围、分发矩阵与源码级验证 Motrix 2.0.0-beta.1 发布说明解读Motrix Turbo v2 的初始 Beta 范围、分发矩阵与源码级验证【免费下载链接】MotrixA full-featured download manager.项目地址: https://gitcode.com/GitHub_Trending/mo/MotrixMotrix 2.0.0-beta.1 是 Motrix Turbov2 重构版计划中的首个公开 Beta本文基于仓库中的发布说明 2.0.0-beta.1.md 完整还原其规划范围host-neutral 下载核心、MDXP 集成、QuickJS 插件沙箱与多架构 Server 容器。读完本篇你可以掌握该 Beta 的完整能力边界、各平台分发形态并用当前仓库源码逐项验证文档声明的技术栈与实现事实。重要提示beta.1 的两次 tag 触发的发布流水线都在对外分发前中止因此 beta.1 没有 GitHub Release、R2 更新源、Docker Hub / GHCR 镜像或 Snap Store 修订版官方引导使用 Motrix 2.0.0-beta.2 代替。本文保留 beta.1 的完整章节内容作为其预期 Beta 范围的历史记录。一、核心亮点桌面端重构与共享下载核心发布说明列出六大亮点下面逐项给出仓库源码层面的印证。1. Electron 43 React 19 TypeScript 7 的桌面重构文档声称 beta.1 采用基于 Electron 43、React 19 与 TypeScript 7 的地面级重构包含可自定义的 Dashboard、暗色模式、跨平台应用菜单和更清晰的 task-inspector 反馈。当前 package.json 可确认这套技术栈仍然延续beta.28 阶段electron: 43.4.0package.json#L98react: ^19.2.8package.json#L142typescript: ~7.0.2package.json#L105quickjs-emscripten: ^0.32.0package.json#L141即插件沙箱的运行时打包侧的配置同样印证了桌面端重构的工程细节见 electron-builder.jsonmacOS 最低系统版本为 12.0electron-builder.json#L95与文档中macOS 12 or later的发布矩阵完全一致注册了motrix/mo自定义协议与magnet协议electron-builder.json#L79-L88支撑浏览器/CLI 一键转存到 Motrix的 handoff 能力Windows 目标为 NSIS 安装器.exe ZIP、仅 x64 架构electron-builder.json#L141-L145与文档Windows 只提供 x64的限制吻合Electron Fuses 启用了onlyLoadAppFromAsar、禁用runAsNode等安全加固electron-builder.json#L69-L78这是 beta.1 规划中重建的发布流水线的一部分。2. 桌面端与 Node/Web Server 共享的 host-neutral 下载核心文档强调一个 host-neutral 下载核心同时服务桌面应用与新的 Node/Web Server并提供 SQLite 会话恢复、tracker 管理、UPnP/NAT-PMP 以及 HTTP、FTP、BitTorrent、magnet 支持。从仓库结构看核心逻辑全部位于src/core/与宿主解耦SQLite 会话持久化motrix-database.ts 与 session-manager.ts依赖better-sqlite3package.json#L123对应SQLite session recoveryTracker 管理tracker-manager.ts、tracker-syncer.ts 等一整套模块对应tracker managementUPnP/NAT-PMPsettings-nat-provider.ts 从设置读取enabled、preferredProtocol、mappingTtl、STUN 服务器与端口可达性检查等配置settings-nat-provider.ts#L15-L27底层封装于motrix/nat包下载引擎为 aria2 分支通过 fetch-engine.mjs 拉取目标平台的aria2_motrix二进制。3. MDXP 集成官方 CLI 与浏览器 handoff、设备码配对文档声明通过 MDXP 实现官方 CLI 与浏览器 handoff包括安全的本地发现与针对远程 Server 实例的设备码配对。当前仓库中依赖motrix/mdxppackage.json#L115WebSocket 桥接服务 web-socket-bridge-server.ts 负责本地发现与配对device-code-service.ts 实现轮询式、无连接的设备码流程device-code-service.ts#L10-L13并内置限流保护RateLimiteddevice-code-service.ts#L138对应文档remote Server instances 的设备码配对仓库还带有 Rust 编写的 native-host 包 packages/native-host用于浏览器原生消息通道。4. QuickJS 插件沙箱文档称插件系统为带能力授权capability consent、签名内置插件与应用内插件市场。源码印证了 QuickJS 沙箱的实现quick-js-worker.ts 的头部注释完整描述了沙箱生命周期——主线程通过worker_thread启动 WorkerWorker 内加载 QuickJS WASM、注入受限全局对象带配额的setTimeout等、将插件 bundle 中import { x } from motrix:plugin-api重写为globalThis.__motrix_plugin_api__后再以 ES module 方式求值。能力调用被分为 effectful 代理调用前assertEffectfulAllowed校验与本地注册的 hook/command 句柄正是capability consent的落地方式。相关实现位于 src/core/plugin/host/ 与 src/core/plugin/capabilities/签名验证逻辑在 trusted-extension-registry.ts。5. 持久化、多架构 Server 容器文档规划用于 NAS 与家庭服务器部署的持久化多架构容器计划发布到 Docker Hub 与 GHCR。当前仓库的 Dockerfile 展示了该 Server 的构建方式基于锁定摘要的node:24-alpine镜像按TARGETARCH选择amd64/arm64拉取对应引擎并执行pnpm run build:server随后经 stage-server-app.mjs 与 verify-server-package.mjs 完成打包与校验Dockerfile#L37-L52。部署细节存储挂载/data与/downloads、网络发布模式、tag 策略详见 docs/docker-server.md其中也明确镜像同时发布到docker.io/motrixapp/motrix-server与ghcr.io/agalwood/motrix-server两个注册表——正是 beta.1 文档中intended的两个镜像名。6. 重建的发布流水线文档列出的流水线能力——隔离的 macOS 签名、可选的 Windows Authenticode 签名、包校验、第三方声明与 SPDX SBOM——在当前仓库脚本中均有对应物第三方声明与 SBOM 生成generate-third-party-notices.mjselectron-builder.json#L46-L68 将sbom.spdx.json与THIRD_PARTY_LICENSES目录打进extraResources包校验before-pack-verify.mjs、verify-electron-package.mjs、verify-server-package.mjs容器发布校验verify-container-publication.mjs、verify-update-artifacts.mjs仓库根目录的 THIRD_PARTY_LICENSES 目录与 THIRD_PARTY_NOTICES.md 即为该流程产物。二、测试前须知Before testing这是发布说明中面向测试者的关键安全提示原文完整保留这是预发布软件。安装前请备份现有的 Motrix 应用数据与下载内容。由于从 Motrix v1 数据的迁移尚未验证不要用唯一的 v1 数据副本直接跑这个 Beta条件允许时请用独立的 OS 账号、独立机器或独立 Docker 数据目录并行测试 v2不要把这个 Beta 当作重要下载的唯一副本。三、测试范围What to test官方给出的测试清单也是理解 beta.1 能力边界的最好索引HTTP、FTP、BitTorrent、magnet 下载包括暂停/恢复与会话恢复桌面集成、通过 MDXP 的浏览器与 CLI handoff、沙箱化插件Headless Server 部署、持久化存储与远程配对。四、计划中的下载渠道Intended downloads实际未发布以下为文档原文的完整分发矩阵分发渠道架构计划产物macOS 12 或更高arm64Apple Silicon、x64IntelDMG 和 ZIPWindowsx64NSIS 安装器.exe和 ZIPLinuxx64、arm64DEB 和 RPMDocker Hub / GHCRlinux/amd64、linux/arm64两个注册表中的不可变2.0.0-beta.1tagSnap Storeamd64、arm64latest/edge计划中的容器镜像名为docker.io/motrixapp/motrix-server:2.0.0-beta.1与ghcr.io/agalwood/motrix-server:2.0.0-beta.1均未发布。存储、网络与升级方面的部署指导请见 Docker Server 部署指南。五、已知的分发限制Known distribution limits文档明确列出的限制逐条与仓库配置相互印证AppImage 不随本 Beta 发布。注意 electron-builder.json#L197-L201 中 Linux target 目前包含 AppImage说明该限制是 beta.1 当时的流水线决策而非打包配置缺失Flatpak 独立验证不由 release tag 发布相关脚本见 prepare-flatpak-project.mjs 与 verify-flatpak-packaging.mjs无 Windowsarm64与任何 32 位包——与 electron-builder.json#L141-L145 中 NSIS/ZIP 均只列x64一致Windows 包计划不做 Authenticode 签名可能触发 SmartScreen 警告且 beta.1 的 Windows 包实际未发布签名能力对应 electron-builder.signing.jsonBeta 容器 tag 不可变不会推进latest、stable或其他稳定的浮动 tag——docs/docker-server.md 中的 tag 语义表不可变x.y.z、浮动x.y/x/stable/latest预发布绝不更新浮动 tag延续了这一策略。六、问题反馈发布说明要求通过 GitHub Issues 报告可复现的问题并附操作系统、架构、包类型与复现步骤。在当前仓库内可直接定位问题归属的方式是桌面端 UI 问题看 src/renderer组件、hooks、路由下载核心问题看 src/coretask、session、bridge、tracker、nat等子模块均有同名*.test.ts单元测试Server 端问题看 src/server端到端行为有 Playwright 用例覆盖playwright.config.ts 与 e2e 目录如 e2e/pair-and-submit.spec.ts 覆盖 MDXP 配对提交流程。七、小结beta.1 虽然未走到对外分发但这份发布说明完整定义了 Motrix Turbo 的初始 Beta 范围一个同时服务桌面与 Server 的共享下载核心、MDXP 驱动的 CLI/浏览器集成、QuickJS 能力授权式插件沙箱以及多架构 Server 容器与重建的签名/SBOM 发布流水线。上述每一项声明都可以从当前仓库的 package.json、electron-builder.json、Dockerfile、src/core 与 scripts 中找到对应的实现证据如需实际安装与部署请以 Motrix 2.0.0-beta.2 及后续版本的发布说明为准。【免费下载链接】MotrixA full-featured download manager.项目地址: https://gitcode.com/GitHub_Trending/mo/Motrix创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考