Motrix v2.0.4

2.0.4 - 2026-11-09

修复

• 显示 Rust 长时间运行测试的完整名称，便于调试和结果分析。
• 优化代理设置页面布局，改进保存交互体验。
• 修复英文设置菜单文字截断问题，侧栏宽度自适应提升可读性。
• 适配系统语言，向导界面随宿主语言切换并持久化用户选择。

下载与校验

请根据 fnOS 设备 CPU 架构选择对应的 FPK：

• x86_64：motrix_2.0.4_x86.fpk
• aarch64 / arm64：motrix_2.0.4_arm.fpk
• 校验文件：SHA256SUMS.txt
• SBOM：motrix_2.0.4_x86.fpk.spdx.json、motrix_2.0.4_arm.fpk.spdx.json

Motrix v2.0.3

2.0.3 - 2026-11-04

修复

• 统一任务列表与详情的下载进度计算，按实际下载数据更新，修复进度回退后仍显示旧值的问题；百分比统一保留一位小数，尚未完成的任务最高显示 99.9%。
• 总大小未知、磁链解析中或待确认文件时不再显示误导性的 0% 进度；暂停、完成等非下载状态不再显示残留速度和预计剩余时间。

改进

• 预计剩余时间支持天、小时、分、秒，最多显示相邻两级非零单位，并增加“约”提示，便于查看长时间下载任务。
• 优化桌面和手机端任务列表的大小、速度与剩余时间布局，分类信息保留在详情中，减少窄屏下的拥挤。
• 任务详情增加进度条与已下载 / 总大小展示，优化下载信息、文件信息和技术信息的排版，改善长文件名、链接及路径的换行与阅读体验。

下载与校验

请根据 fnOS 设备 CPU 架构选择对应的 FPK：

• x86_64：motrix_2.0.3_x86.fpk
• aarch64 / arm64：motrix_2.0.3_arm.fpk
• 校验文件：SHA256SUMS.txt
• SBOM：motrix_2.0.3_x86.fpk.spdx.json、motrix_2.0.3_arm.fpk.spdx.json

Motrix v2.0.2

2.0.2 - 2026-10-29

修复

• 修复保留已设管理密码的应用数据后重装仍需重复填写密码的问题，两项留空即可沿用原密码；首次安装或原数据尚未设密时仍须设置有效密码。
• 修复本地验证缓存因 RUST_LOG 日志设置变化而失效的问题，减少无关的重复检查。

改进

• 安装和升级向导使用粗体与换行整理说明，突出密码生效规则、任务兼容边界与备份要求。
• 升级向导增加默认未勾选的确认框，主动同意兼容性与备份说明后才能继续，并由升级脚本在替换文件前再次校验。2.x 不导入或续传 1.x 任务，旧记录和下载文件保留，密码、设置、目录授权及 RPC Token 沿用；升级前需自行备份，回滚须恢复配套旧版安装包与完整备份。
• 按前端、后端和脚本分类复用内容与工具链一致的本地验证结果，减少推送和本地打包中的重复测试与构建。
• 将耗时的重启、连接压力和真实退出超时专项移入扩展验证，日常保留核心稳定性检查。
• 后端发布构建改用 Thin LTO，缩短正式包编译时间。

文档

• 完善保留数据重装、升级确认、1.x 任务兼容边界与备份回滚说明，补充 fnOS 向导的平台依据及验收要求。

下载与校验

请根据 fnOS 设备 CPU 架构选择对应的 FPK：

• x86_64：motrix_2.0.2_x86.fpk
• aarch64 / arm64：motrix_2.0.2_arm.fpk
• 校验文件：SHA256SUMS.txt
• SBOM：motrix_2.0.2_x86.fpk.spdx.json、motrix_2.0.2_arm.fpk.spdx.json

Motrix v2.0.1

2.0.1 - 2026-10-27

修复

• 修正任务删除流程：普通删除仅移入回收站，保留下载文件、进度和恢复信息；永久删除或清空回收站默认保留文件，只有明确勾选才删除下载内容，需要清理文件时在清理成功后才移除任务记录。
• 优化解析中和待确认磁力任务的删除提示，仅有私有解析缓存时不再提示删除下载文件；清空回收站时按每条任务的实际情况处理。
• 修复引擎停止超时后无法正确收尾和重新启动的问题，避免重复发送停止信号，并在停止尚未完成时明确提示稍后重试。
• 修复下载设置与公网 RPC Token 同时保存时可能相互覆盖的问题，保持已保存配置与运行时状态一致。
• 修复引擎缺失或无法识别时的启动保护，保留管理和诊断入口，阻止下载操作并保留已有任务数据。
• 修复“全部、下载中、已完成、回收站、扩展”切换时内容区高度突变、跳动和闪烁的问题，改善桌面与手机端的过渡效果。

改进

• 减少任务监控和文件进度快照的重复数据库写入，降低无变化时的磁盘写入开销。
• 优化后端发布构建，缩小后端程序体积。

文档

• 整合维护手册中的开发、打包、备份回滚、远程接入和故障排查说明；README 区分使用帮助与开发者参考，完整接口文档保留并标明适用读者。

下载与校验

请根据 fnOS 设备 CPU 架构选择对应的 FPK：

• x86_64：motrix_2.0.1_x86.fpk
• aarch64 / arm64：motrix_2.0.1_arm.fpk
• 校验文件：SHA256SUMS.txt
• SBOM：motrix_2.0.1_x86.fpk.spdx.json、motrix_2.0.1_arm.fpk.spdx.json

Motrix v2.0.0

2.0.0 - 2026-10-24

改进

• 下载引擎由 Aria2 Next 2.5.5 升级至 2.8.6，适配原生下载状态与断点恢复；普通 HTTP/HTTPS 链接保持原文件下载方式，不自动转为媒体解析任务。
• 升级须知：2.0.0 不导入、不展示、不继续或恢复旧版任务，升级后任务列表重新开始；旧任务记录和下载文件保留原处，密码、设置、目录授权及 RPC Token 沿用，旧任务和未完成的旧操作不阻止升级。需要保留旧任务进度时，请先在旧版完成下载。
• 升级前请停止应用并手工备份整个应用私有数据目录，外部下载文件须另行保护；应用不自动备份或迁移旧任务。回退时须停止新版，配套恢复旧版安装包及升级前的完整备份，不能让旧版直接读取新版数据。
• 新版任务使用独立的原生恢复状态，暂停、回收站恢复和应用重启后保留原任务身份；暂停及回收站任务恢复时保持暂停，不自动下载或做种。
• HTTP 连接设置统一为单个连接上限，支持 1–64 个连接，移除旧分片设置，并统一网页与外部 JSON-RPC 的选项校验。
• 移除独立旧任务迁移检查程序，完善双架构安装包的引擎校验和、依赖清单及构建材料。

新增

• 增加“BT 使用代理”全局开关，种子和磁力任务统一使用应用代理，支持 HTTP、SOCKS4、SOCKS5；HTTP/HTTPS 下载继续使用各任务的代理开关。
• 诊断页增加原生下载状态占用展示；原生恢复数据不参与日志清理或诊断导出。

修复

• 修复普通链接下载及自动改名后的任务暂停后无法继续的问题，加强恢复时的文件路径与目录授权校验。
• 修复磁力任务的文件确认、重新下载和删除内容后从头恢复流程；确认文件时保持原 GID，全选和部分选择下载完成后均停止做种，恢复信息不完整时保留文件并明确报错。
• 修复 BT 中文路径被转为点号、产生多余目录及删除时遗漏实际下载文件的问题。
• 修复 IPv6 管理连接关闭后立即重新启用应用失败的问题，改进退出时长连接排空及引擎停止的超时处理。
• 在引擎联网前应用 BT 代理，代理切换失败或结果未确认时阻止受影响任务继续，避免静默直连；加强代理凭据脱敏。
• 隔离旧代任务和未完成操作后再解析内容，避免损坏旧记录阻止新版启动；隐藏旧任务不再阻止清除应用代理配置。

文档

• 已知引擎问题：2.8.6 遇到异常 Content-Range 响应时，任务可能持续显示下载中且普通暂停无效。应用在暂停确认超时后报错、保留文件并拒绝删除下载内容，请先停用并重新启用应用后再处理任务；强制终止后最近未提交的进度可能回退，此问题尚未修复。
• BT 代理限制：HTTP/SOCKS4 代理下部分域名仍依赖本机 DNS，需要代理端解析域名时应使用 SOCKS5；BT 自定义 HTTP Header 不会传递给 tracker 或 web-seed。
• 更正 ARM 包最低 fnOS 版本说明为 1.2.0401，与实际安装限制保持一致。

升级前必读

Motrix 2.0.0 使用 Aria2 Next 2.8.6，不支持继续或恢复 2.0.0 以下版本创建的任务。请先在旧版完成所有下载，包括暂停、失败、等待选择文件以及回收站中需要继续的任务。升级后任务列表重新开始，不导入或显示旧任务；下载文件、管理密码、授权、设置和 RPC Token 保留。旧任务状态保留原处，不自动备份或迁移。

升级前请停止应用并确认 server 与引擎已退出，备份整个应用私有数据目录（含 SQLite、session、原生状态和种子备份），记录旧包版本、架构及备份校验和；下载内容保持原位。升级失败时请保留原数据，并查看安装提示；不要依赖安装器自动回退。

已知限制

• 固定的 Aria2 Next 2.8.6 遇到某些错误的 Content-Range 响应时，可能一直显示下载中且无法暂停。应用在无法确认暂停时返回明确错误并保留原任务和文件，拒绝删除下载内容；请通过飞牛停止并重新启动应用，再核对任务和文件。停服可能需要强制终止引擎，最近未提交的进度可能回退，不代表完整下载成功；不要手动删除 session 或原生恢复状态。
• BT tracker/web-seed 使用 HTTP 或 SOCKS4 代理时，部分主机名解析可能依赖本机 DNS；需要由代理解析目标主机名时建议使用 SOCKS5。BT 的自定义 HTTP Header 不会传递给 tracker/web-seed，依赖这些 Header 认证的来源暂不支持。

需要回滚时

1. 停止新版并确认 server 与引擎已退出，另存新版新增任务状态及下载文件归属。
2. 下载与设备架构匹配的 Motrix v1.9.8 稳定恢复包，按该 Release 的 SHA256SUMS.txt 核对 FPK。
3. 配套恢复升级前的整个应用私有数据目录并安装原版本；原实例不是 v1.9.8 时须使用与备份匹配的原版本包，不能只换引擎或让旧引擎加载新 session。
4. 启动旧版后核对任务、密码、授权、设置、RPC Token 和下载文件。新版新增任务不能由旧快照继续；没有升级前完整备份时，先保留现有数据，不要反复切换版本。

下载与校验

请根据 fnOS 设备 CPU 架构选择对应的 FPK：

• x86_64：motrix_2.0.0_x86.fpk
• aarch64 / arm64：motrix_2.0.0_arm.fpk
• 校验文件：SHA256SUMS.txt
• SBOM：motrix_2.0.0_x86.fpk.spdx.json、motrix_2.0.0_arm.fpk.spdx.json

Motrix v1.9.8

1.9.8 - 2026-10-08

新增

• 任务列表增加全部任务状态筛选，可快速查看暂停和错误任务。
• 局域网 JSON-RPC 支持按需放行 RFC 6598 共享地址段（100.64.0.0/10），便于 Tailscale 等网络访问。

改进

• 管理密码改为在 fnOS 安装向导中设置并确认，安装完成即可登录；保留数据重装与正常升级沿用原密码，向导明确提示不同安装方式的密码生效规则。
• 移除网页首次设密表单与一次性初始化凭证，保留登录、语言选择和脱敏登录诊断，解决安装后难以获取凭证、无法完成初始化的问题（#30）。
• 本机 reset-web-auth 命令改为在应用停止后隐藏输入并确认新密码，直接完成重置并使旧登录凭据失效，保留下载任务、设置、RPC Token 和下载文件。
• 增加浏览器 E2E 冒烟、真实 Aria2 sidecar 集成和文件系统故障测试，并纳入发布前扩展验证。

修复

• 局域网 JSON-RPC 的 17082 端口被占用时，保留管理与回环 RPC 入口可用，并在设置、诊断和日志中提示占用情况。
• 修复 URL 任务输出文件名校验不足导致的路径越界风险，并在旧任务恢复前重新确认下载目录授权。
• 修复文件暂存失败时误删备份的问题，保留备份以便回滚。
• 修复密码验证限速与哈希资源控制问题，收紧局域网 JSON-RPC WebSocket 来源权限并限制连接资源。
• 修复清理任务后的迟到响应污染前端状态、认证请求迟到 401 清除新登录态，以及 SSE 重连后任务快照停止更新的问题。

下载与校验

请根据 fnOS 设备 CPU 架构选择对应的 FPK：

• x86_64：motrix_1.9.8_x86.fpk
• aarch64 / arm64：motrix_1.9.8_arm.fpk
• 校验文件：SHA256SUMS.txt
• SBOM：motrix_1.9.8_x86.fpk.spdx.json、motrix_1.9.8_arm.fpk.spdx.json

Motrix v1.9.7

1.9.7 - 2026-09-16

新增

• 支持设置最大并发下载数、单服务器连接数、默认分片、连接超时和重试次数。
• 诊断页新增应用存储空间和临时文件占用统计。

改进

• 优化任务列表和详情弹窗的信息层级，改善状态摘要、长文本与移动端展示。

修复

• 修复部分 FN Connect 环境中登录页无法确认管理访问状态的问题。

下载与校验

请根据 fnOS 设备 CPU 架构选择对应的 FPK：

• x86_64：motrix_1.9.7_x86.fpk
• aarch64 / arm64：motrix_1.9.7_arm.fpk
• 校验文件：SHA256SUMS.txt
• SBOM：motrix_1.9.7_x86.fpk.spdx.json、motrix_1.9.7_arm.fpk.spdx.json

Motrix v1.9.6

1.9.6 - 2026-09-08

新增

• 开放自定义 URL 功能，用户可自行配置系统访问地址。

修复

• 强制启用 Web 管理密码保护，删除关闭入口，确保 API/SSE 必须使用 JWT，升级时恢复保护并失效旧 JWT。

下载与校验

请根据 fnOS 设备 CPU 架构选择对应的 FPK：

• x86_64：motrix_1.9.6_x86.fpk
• aarch64 / arm64：motrix_1.9.6_arm.fpk
• 校验文件：SHA256SUMS.txt
• SBOM：motrix_1.9.6_x86.fpk.spdx.json、motrix_1.9.6_arm.fpk.spdx.json

Motrix v1.9.5

1.9.5 - 2026-09-07

新增

• 提供 IPv6 管理入口，用户可在系统中配置和使用 IPv6 地址。
• 在 JSON‑RPC 中支持授权目录的子目录推送，实现更细粒度的文件同步。

下载与校验

请根据 fnOS 设备 CPU 架构选择对应的 FPK：

• x86_64：motrix_1.9.5_x86.fpk
• aarch64 / arm64：motrix_1.9.5_arm.fpk
• 校验文件：SHA256SUMS.txt
• SBOM：motrix_1.9.5_x86.fpk.spdx.json、motrix_1.9.5_arm.fpk.spdx.json

Motrix v1.9.4

1.9.4 - 2026-09-02

新增

• 新增免登录排障诊断功能，帮助用户快速定位鉴权问题。

改进

• 采用 JWT 管理令牌并细分会话鉴权失败原因，提升鉴权可靠性。

下载与校验

请根据 fnOS 设备 CPU 架构选择对应的 FPK：

• x86_64：motrix_1.9.4_x86.fpk
• aarch64 / arm64：motrix_1.9.4_arm.fpk
• 校验文件：SHA256SUMS.txt
• SBOM：motrix_1.9.4_x86.fpk.spdx.json、motrix_1.9.4_arm.fpk.spdx.json