飞牛 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.fpk | Motrix-VERSION-fnos-x64.fpk.sha256 |
ARM64(aarch64) | Motrix-VERSION-fnos-arm64.fpk | Motrix-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
- 使用管理员账号登录飞牛。
- 打开应用中心 → 手动安装,选择下载的
.fpk,按向导完成安装。 - 客户端连接端口默认保留
16802,除非与其他服务冲突。此端口供 CLI 和可选的浏览器扩展连接使用。 - 启动 Motrix,从飞牛桌面打开。网页界面通过 fnOS 网关提供,无需使用 Docker 版的
8080端口。 - 阅读应用使用说明,选择或授权下载目录,然后添加下载任务。
Note
安装 FPK 不会自动迁移另一份桌面或 Docker 实例。请保留并备份原实例的数据,不要让两个应用同时使用同一份正在运行的任务数据库。
下载目录与权限
安装包声明了 motrix/downloads 共享目录。使用其他共享目录时,请通过飞牛目录选择器选择并授权。Motrix 还会检查当前管理员的文件权限。
- 直接粘贴路径不会自动获得该目录的访问权限。
- 通过飞牛文件关联打开
.torrent时,种子文件必须位于已授权且当前用户可读的目录中;也可以在浏览器内上传种子文件。 - 磁盘或共享目录不可用时,应先恢复访问,再继续任务。Motrix 不会在未挂载的卷上重新创建不可用的共享目录。
- 撤销下载目录授权前,请先停止 Motrix。撤销授权会阻止后续路径检查,但不会立即停止引擎已经打开的文件。
浏览器扩展
在浏览网页的电脑上安装 Motrix 浏览器扩展。连接 NAS 是可选功能,默认关闭。
- 在飞牛的 Motrix 应用设置中,启用浏览器扩展连接。
- 将扩展连接地址设为扩展能够访问的地址,例如
ws://nas.local:16802。通过 TLS 反向代理连接时使用wss://。 - 将 Motrix 网页地址设为浏览器实际使用的完整地址,包含
/app/motrix/,例如https://nas.example/app/motrix/。如果在受信任网络中使用 HTTP,需在同一设置中明确允许 HTTP 配对页面。填写 HTTPS 地址不会授权 HTTP 页面。 - 保存后重启 Motrix。
- 在扩展中添加远程 Server 连接,填写配置好的 WS/WSS 地址并开始配对。
- 使用飞牛管理员账号打开 Motrix,领取配对请求,再将显示的配对码输入扩展。客户端会绑定到领取请求的管理员账号。
禁用该账号、移除管理员身份或撤销客户端授权后,客户端将失去访问权限。其他管理员不能直接查看已被领取的请求的配对码。可选扩展设置无效时,正常的 fnOS 网页界面和 CLI 仍可使用。
命令行客户端
在需要发送命令的电脑上安装 Motrix CLI。连接 NAS 配置的客户端端口,默认为 16802,并在飞牛管理员的 Motrix 网页界面中批准配对。凭据使用该管理员的权限,飞牛浏览器 Cookie 不是 CLI 凭据。
原生包的客户端端口与 Docker 指南中的默认 16801 不同。在飞牛应用设置中修改端口后,需要重启 Motrix。
升级与备份
- 暂停下载并停止 Motrix,再备份应用数据和下载目录,保证备份一致。
- 下载相同 NAS 架构的新版 FPK,并校验摘要。
- 使用飞牛手动安装原位升级已有应用。飞牛提供数据保留选项时,请保留应用数据。
- 打开 Motrix,检查任务、目录授权和已连接客户端,再恢复下载。
飞牛要求新安装包的版本高于已安装版本。不要通过卸载绕过同版本安装提示:卸载可能清除目录授权,即使保留了任务数据。授权被清除时,请重新选择并授权目录。请保留引擎生成的升级前数据库备份,旧引擎无法打开较新的数据库格式。
常见问题
| 现象 | 检查方法 |
|---|---|
| 安装包无法安装 | 确认 NAS 架构、fnOS 版本、文件摘要,以及安装包版本是否更高。 |
| 打开 Motrix 时提示无权访问 | 使用未被禁用的飞牛管理员账号,当前不支持普通用户。 |
| 下载目录被拒绝 | 使用飞牛目录选择器重新授权,检查当前账号权限,并确认磁盘已挂载。 |
| 浏览器扩展无法配对 | 检查客户端端口、可访问的 WS/WSS 地址、准确的网页地址、HTTP 许可,以及是否重启过 Motrix;使用预期管理员领取请求。 |
| CLI 无法连接 | 使用原生包配置的客户端端口,而非网页网关或 Docker 端口,并排查端口冲突。 |
| NAS 系统没有原生安装包 | 若设备支持 Docker,可使用 Docker 部署指南;FPK 只能安装在 fnOS 上。 |