飞牛 fnOS(原生 FPK)

fnOS 原生安装包可让 Motrix 直接运行在 NAS 上,无需 Docker。从飞牛桌面打开后,即可在浏览器中管理 HTTP、FTP、BitTorrent 和磁力下载。安装包已包含下载引擎和运行环境,无需在 NAS 上另装 Node.js 或 aria2。

这是管理员共享实例。 请使用飞牛管理员账号登录。所有管理员共同管理同一份任务和应用设置,普通用户无法访问;任务不会按管理员账号隔离。

选择安装包

打开下载页 → NAS,下载同一版本的 FPK 和 SHA-256 校验文件。请按 NAS 的处理器架构选择,不要按当前浏览器所在电脑的架构选择。

NAS 处理器安装包校验文件
Intel/AMD,x64(x86_64)Motrix-VERSION-fnos-x64.fpkMotrix-VERSION-fnos-x64.fpk.sha256
ARM64(aarch64)Motrix-VERSION-fnos-arm64.fpkMotrix-VERSION-fnos-arm64.fpk.sha256

VERSION 是下载文件名中的版本号,不含开头的 v。安装包直接通过官方 GitHub Releases 分发。Motrix 尚未上架飞牛应用中心目录,请使用手动安装。

安装包声明要求 fnOS 1.2.0401 及以上。x64 和 ARM64 原生构建均通过自动化打包和生命周期检查;实机验收已覆盖 fnOS 1.2.0903 ARM64,x64 硬件、声明的最低 fnOS 版本及移动端/FN Connect 仍需实机覆盖。

校验下载文件

将 FPK 和对应的 .sha256 文件放在同一目录。在 Linux 上,将 VERSION 替换为下载的版本号后运行:

sha256sum -c Motrix-VERSION-fnos-x64.fpk.sha256

macOS 使用 shasum -a 256 -c 替代 sha256sum -c。Windows PowerShell 可运行:

Get-FileHash .\Motrix-VERSION-fnos-x64.fpk -Algorithm SHA256

将结果与 .sha256 文件中的摘要对比。ARM64 安装包请把 x64 替换为 arm64。如果不一致,请重新下载两个文件后再安装。

安装并打开 Motrix

  1. 使用管理员账号登录飞牛。
  2. 打开应用中心 → 手动安装,选择下载的 .fpk,按向导完成安装。
  3. 客户端连接端口默认保留 16802,除非与其他服务冲突。此端口供 CLI 和可选的浏览器扩展连接使用。
  4. 启动 Motrix,从飞牛桌面打开。网页界面通过 fnOS 网关提供,无需使用 Docker 版的 8080 端口。
  5. 阅读应用使用说明,选择或授权下载目录,然后添加下载任务。

Note

安装 FPK 不会自动迁移另一份桌面或 Docker 实例。请保留并备份原实例的数据,不要让两个应用同时使用同一份正在运行的任务数据库。

下载目录与权限

安装包声明了 motrix/downloads 共享目录。使用其他共享目录时,请通过飞牛目录选择器选择并授权。Motrix 还会检查当前管理员的文件权限。

  • 直接粘贴路径不会自动获得该目录的访问权限。
  • 通过飞牛文件关联打开 .torrent 时,种子文件必须位于已授权且当前用户可读的目录中;也可以在浏览器内上传种子文件。
  • 磁盘或共享目录不可用时,应先恢复访问,再继续任务。Motrix 不会在未挂载的卷上重新创建不可用的共享目录。
  • 撤销下载目录授权前,请先停止 Motrix。撤销授权会阻止后续路径检查,但不会立即停止引擎已经打开的文件。

日常下载操作见新建任务和管理任务。

浏览器扩展

在浏览网页的电脑上安装 Motrix 浏览器扩展。连接 NAS 是可选功能,默认关闭。

  1. 在飞牛的 Motrix 应用设置中,启用浏览器扩展连接。
  2. 将扩展连接地址设为扩展能够访问的地址,例如 ws://nas.local:16802。通过 TLS 反向代理连接时使用 wss://。
  3. 将 Motrix 网页地址设为浏览器实际使用的完整地址,包含 /app/motrix/,例如 https://nas.example/app/motrix/。如果在受信任网络中使用 HTTP,需在同一设置中明确允许 HTTP 配对页面。填写 HTTPS 地址不会授权 HTTP 页面。
  4. 保存后重启 Motrix。
  5. 在扩展中添加远程 Server 连接,填写配置好的 WS/WSS 地址并开始配对。
  6. 使用飞牛管理员账号打开 Motrix,领取配对请求,再将显示的配对码输入扩展。客户端会绑定到领取请求的管理员账号。

禁用该账号、移除管理员身份或撤销客户端授权后,客户端将失去访问权限。其他管理员不能直接查看已被领取的请求的配对码。可选扩展设置无效时,正常的 fnOS 网页界面和 CLI 仍可使用。

命令行客户端

在需要发送命令的电脑上安装 Motrix CLI。连接 NAS 配置的客户端端口,默认为 16802,并在飞牛管理员的 Motrix 网页界面中批准配对。凭据使用该管理员的权限,飞牛浏览器 Cookie 不是 CLI 凭据。

原生包的客户端端口与 Docker 指南中的默认 16801 不同。在飞牛应用设置中修改端口后,需要重启 Motrix。

升级与备份

  1. 暂停下载并停止 Motrix,再备份应用数据和下载目录,保证备份一致。
  2. 下载相同 NAS 架构的新版 FPK,并校验摘要。
  3. 使用飞牛手动安装原位升级已有应用。飞牛提供数据保留选项时,请保留应用数据。
  4. 打开 Motrix,检查任务、目录授权和已连接客户端,再恢复下载。

飞牛要求新安装包的版本高于已安装版本。不要通过卸载绕过同版本安装提示:卸载可能清除目录授权,即使保留了任务数据。授权被清除时,请重新选择并授权目录。请保留引擎生成的升级前数据库备份,旧引擎无法打开较新的数据库格式。

常见问题

现象检查方法
安装包无法安装确认 NAS 架构、fnOS 版本、文件摘要,以及安装包版本是否更高。
打开 Motrix 时提示无权访问使用未被禁用的飞牛管理员账号,当前不支持普通用户。
下载目录被拒绝使用飞牛目录选择器重新授权,检查当前账号权限,并确认磁盘已挂载。
浏览器扩展无法配对检查客户端端口、可访问的 WS/WSS 地址、准确的网页地址、HTTP 许可,以及是否重启过 Motrix;使用预期管理员领取请求。
CLI 无法连接使用原生包配置的客户端端口,而非网页网关或 Docker 端口,并排查端口冲突。
NAS 系统没有原生安装包若设备支持 Docker,可使用 Docker 部署指南;FPK 只能安装在 fnOS 上。