在飞牛OS 中使用 Octop
Octop 支持在飞牛OS(FnOS)NAS 设备上运行。你可以直接在飞牛应用中心手动安装官方 .fpk 安装包,选择 Docker 版或原生本地版。完成首次设置向导后,即可在几分钟内启动并开始对话。
选择安装包
请前往对应版本的 GitHub Releases(例如 v1.0.3b5)下载 .fpk 安装包,并按 NAS 的 CPU 选择。
说明
官方发布包已固定版本号,不再提供滚动 fnos-latest 标签。更新时请下载对应新版本的 .fpk 文件。
安装与快速上手
下载安装包
在 GitHub Releases 中找到目标版本,按 NAS 的 CPU 架构下载 Docker 版 或 本地版 .fpk 文件。
从应用中心手动安装
在飞牛OS 桌面中打开 应用中心 → 设置 → 手动安装应用,选择下载好的 .fpk 文件并确认安装。
完成安装向导
安装向导会引导你完成基础环境配置:
- 管理员用户名:输入管理员用户名。
- 管理员密码:推荐选择自动生成随机密码(系统生成高强度随机密码),也可自行输入(须至少 8 位且同时包含字母和数字)。
- 高级配置:可设置日志级别,并可选填大模型 API 密钥。
打开 Octop 页面
安装完成后,点击飞牛OS 桌面图标 Octop AI 助手,或在浏览器中访问对应版本的 URL:
- Docker 版:
http://<NAS的IP>:8088 - 本地版:
http://<NAS的IP>:8089
首次登录与修改密码
使用向导中配置的管理员账号和密码登录页面。
- 查看初始密码:打开应用的 设置 窗口可随时查看用户名和密码。数据目录下的
octop-login.txt会保留一份备份(Docker 版同时写入容器内/data/.octop/credential.txt)。 - 修改密码:登录后,请立即在页面右上角头像菜单中点击修改密码。
配置模型并开始对话
登录后,进入 管理 → 模型,填入你的模型 API 密钥(如腾讯云混元、DeepSeek、OpenAI 等)并启用。随后进入 对话 页面,即可向默认专家 main 发送第一条消息。
注意
如果你的 NAS 开启了公网访问或处于多设备局域网环境,请勿长期使用初始生成的随机密码,请在首次登录后及时修改。
常用管理与运维
查看凭据与重置密码
- 查看初始凭据:在飞牛应用中心打开 Octop 应用的 设置 窗口查看。
- 命令行修改密码:
- Docker 版:在 NAS 终端中执行:
- 本地版:SSH 登录 NAS 后执行:
如提示找不到命令,可使用完整路径
/usr/local/bin/octop或/var/apps/octop-native/bin/octop-cli。
- Docker 版:在 NAS 终端中执行:
- 忘记密码:详细重置流程请参阅 重置密码。
服务启停与更新
- 启停服务:在飞牛应用中心可以直接对应用进行启动、停止或卸载。
- 版本更新:前往 GitHub Releases 下载新版本
.fpk,再次在应用中心手动安装即可覆盖升级,数据目录与配置会自动保留。本地版也可以在页面中升级。完整步骤见升级版本。

