☰
飞牛 NAS 装好 Octop:一个 .fpk 包,5 分钟跑起自托管 AI 助手
2026/10/30 4:43:30 网站建设 项目流程

飞牛 NAS 装好 Octop:一个 .fpk 包,5 分钟跑起自托管 AI 助手

【免费下载链接】OctopA smarter, self-hosted AI assistant — multi-user, multi-agent.项目地址: https://gitcode.com/GitHub_Trending/oct/Octop

把 Octop 的.fpk包装进飞牛 NAS:应用中心选包、向导建管理员账号,服务显示「运行中」后配置一个模型 API Key,就能开始对话。全程图形界面,不碰命令行。

谁适合装

Octop 装完是一个单进程服务,数据全部落在 NAS 硬盘上。下面三种情况,装它正合适:

  • 家里或团队想在局域网里放一个随时能用的 AI 入口。登录 Web 控制台即可多轮对话,长文总结、写邮件、列计划都能干;按任务给不同专家(Agent)开账号,各自的记忆、IM 渠道、定时任务互相隔离,互不干扰。
  • 希望助手直接出现在 IM 里。接入飞书、钉钉等即时通讯软件后,在聊天窗口里直接派活;定时任务支持 Cron 表达式或一句自然语言描述,到点自动执行并推送结果。
  • 数据不想出 NAS。对话、记忆、知识库都存在数据共享目录,重启不丢;跑在自家设备上,也方便按离线推理路线配置模型。

飞牛 NAS 上 Octop 版本怎么选

仓库随正式版产出三款.fpk,按下表对号入座:

包文件名体积端口适用
Docker 版Octop-fnos-docker-<版本>.fpk约 340 KB8088x86 与 ARM 通用,首次启动按本机架构自动下载镜像
本地版Octop-fnos-native-<版本>.fpk约 200 MB8089x86_64专用
本地版 ARMOctop-fnos-native-arm64-<版本>.fpk约 200 MB8089ARM 飞牛专用

规则一句话:装了 Docker 选 Docker 版;没有 Docker 的 x86 飞牛选 native;ARM 飞牛没装 Docker 才用 native-arm64。

方向定下来后,下载前自查四项:

自查项确认方式说明
能否访问ghcr.io飞牛网络正常即可Docker 版首次启动要从中拉镜像;拉取超 3 分钟时检查网络或代理
Docker 是否就绪飞牛「Docker」应用能正常打开决定装哪一款包、后续是否要等镜像下载
CPU 架构「设置 → 系统信息」看处理器本地版按架构编译,装错直接失败
包与版本是否对得上到对应版本发布页下载三款包对应不同端口和依赖,混装不生效

安装三步走

  1. 应用中心装包。飞牛「应用中心 → 设置 → 手动安装应用」,选中下载好的.fpk。装完桌面多出 Octop 图标,安装向导随之启动。
  2. 向导里创建管理员账号。用户名2–32 位,只允许字母、数字、.、_、-,默认admin;密码8–64 位,必须同时含字母和数字,并再输一次做一致性校验;显示名称、邮箱均可选,填了邮箱就能用邮箱登录。不符合规则的输入在点「下一步」时当场拦下,不会装到一半才报错。
  3. 等状态变「运行中」再访问。Docker 版首次启动会从ghcr.io下载与包版本一致的tencentcloud/octop镜像,通常 1–3 分钟,稍慢属正常;本地版没有这一步,直接就绪。状态变为「运行中」后,浏览器访问http://<设备IP>:8088(Docker 版)或http://<设备IP>:8089(本地版),用向导里的用户名或邮箱加密码登录。

Octop 模型密钥怎么配

这一步独立做,不做的话对话功能不工作。

登录控制台,进入「设置 → 模型」,选一个预置提供商(OpenAI、DeepSeek、Kimi 等),填入 API Key,点「测试连通性」。通过后即可开始对话。想在 NAS 上完全离线跑模型,系统还支持 Ollama、ONNX 本地推理和自定义 Base URL,走本地推理路线即可。

三个位置要记牢

项目值
服务端口Docker 版 8088、本地版 8089,写死在应用清单里,桌面入口与端口映射都基于此
数据目录飞牛 />

卡住了先看这里

症状原因处理
Docker 版首次启动一直不显示「运行中」正在下载镜像,网络不通时卡得更久1–3 分钟内正常;超过则检查飞牛能否访问ghcr.io,必要时走代理;之后重启不会重新下载
本地版启动失败架构不匹配或依赖缺失打开数据目录的octop-start-error.txt看具体报错
忘记密码备份文件与网页改密不同步进 Octop 数据目录看octop-login.txt;或在应用「设置」窗口直接改密
端口被占用或冲突手动执行过octop run不要手动跑octop run,它会和应用中心托管的实例抢 8089 端口;Web 服务一律在应用中心启停

参考

  • 飞牛安装说明
  • 用户指南
  • 打包脚本

【免费下载链接】OctopA smarter, self-hosted AI assistant — multi-user, multi-agent.项目地址: https://gitcode.com/GitHub_Trending/oct/Octop

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询