For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /guide/fnos.md.
  • 简体中文
  • 在飞牛OS 中使用 Octop

    Octop 支持在飞牛OS(FnOS)NAS 设备上运行。你可以直接在飞牛应用中心手动安装官方 .fpk 安装包,选择 Docker 版或原生本地版。完成首次设置向导后,即可在几分钟内启动并开始对话。

    选择安装包

    请前往对应版本的 GitHub Releases(例如 v1.0.3b5)下载 .fpk 安装包,并按 NAS 的 CPU 选择。

    安装包类型适用场景默认访问地址说明
    Docker 精简版(Octop-fnos-docker-lite-<版本>.fpk)已安装 Docker,且不需要虚拟桌面、OCR 或本地向量http://<NAS的IP>:8088首次启动拉取 ghcr.io/tencentcloud/octop:<版本>(精简标签)。
    Docker 完整版(Octop-fnos-docker-<版本>.fpk)需要在 Docker 里使用桌面、OCR 和本地向量http://<NAS的IP>:8088拉取 ghcr.io/tencentcloud/octop:<版本>-full。
    本地 amd64(Octop-fnos-native-amd64-<版本>.fpk)x86_64,不用 Dockerhttp://<NAS的IP>:8089直接在飞牛上运行,自带 Python、无头 Chromium 和远程桌面组件。
    本地 arm64(Octop-fnos-native-arm64-<版本>.fpk)ARM64,且没有 Dockerhttp://<NAS的IP>:8089内容与 amd64 本地包相同。
    说明

    官方发布包已固定版本号,不再提供滚动 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 终端中执行:
        docker exec -it octop octop user passwd <用户名> --password <新密码>
      • 本地版:SSH 登录 NAS 后执行:
        octop user passwd <用户名> --password <新密码>
        如提示找不到命令,可使用完整路径 /usr/local/bin/octop 或 /var/apps/octop-native/bin/octop-cli。
    • 忘记密码:详细重置流程请参阅 重置密码。

    服务启停与更新

    • 启停服务:在飞牛应用中心可以直接对应用进行启动、停止或卸载。
    • 版本更新:前往 GitHub Releases 下载新版本 .fpk,再次在应用中心手动安装即可覆盖升级,数据目录与配置会自动保留。本地版也可以在页面中升级。完整步骤见升级版本。