ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

零命令行,10 分钟在 NAS 自托管多用户 AI 助手:Octop 飞牛部署完整指南

零命令行,10 分钟在 NAS 自托管多用户 AI 助手:Octop 飞牛部署完整指南

零命令行,10 分钟在 NAS 自托管多用户 AI 助手:Octop 飞牛部署完整指南

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

Octop 是腾讯开源的多用户、多智能体自托管 AI 助手。装好后可与它聊天、为不同任务创建专家智能体、接入 IM 渠道、运行定时任务,数据全部留在你自己的 NAS。本文用官方 .fpk 包,在飞牛应用中心完成 Octop 的 fnOS 部署与模型配置,全程点选,不用命令行。

为什么值得放进 NAS

NAS 本身就是常开设备,AI 助手放进去就不用手动开机;对话、记忆、知识库都写在数据共享目录里,隐私可控。Web 控制台、CLI、IM 渠道、定时任务合在一个进程里,不用自己搭多套组件。

使用场景你将得到什么
日常问答、总结长文一个常开、家里任何设备都能访问的 Web 助手
在意数据隐私数据全部落在本地共享目录,不经过第三方
要每日自动简报定时任务按计划触发,如早上推送天气
多成员共用多用户账号,各看各的数据

准备工作与安装包选型

先确认 3 件事:

  1. NAS 能正常联网,Docker 版首次启动必须能访问ghcr.io拉镜像
  2. 飞牛是否装了 Docker——这决定你下哪个包
  3. 你的 CPU 架构是 x86_64 还是 ARM,本地版安装包按架构区分

官方提供 3 款 .fpk 包:

安装包体积端口依赖适用对象
Octop-fnos-docker-<版本>.fpk约 340 KB8088主机有 Docker,可访问ghcr.iox86 / ARM 通用
Octop-fnos-native-<版本>.fpk约 200 MB8089复用飞牛「Python 3.12」,无需 Dockerx86_64 NAS
Octop-fnos-native-arm64-<版本>.fpk约 200 MB8089同上仅 ARM NAS,装到 x86 会报错

装了 Docker 就选 Docker 版(x86/ARM 通用);不装 Docker 按 CPU 架构选对应本地版,架构必须对上。

阶段一:安装 .fpk 并创建管理员账号

应用中心手动安装 .fpk

打开飞牛「应用中心 → 设置 → 手动安装应用」,选中你下载的 .fpk 文件确认安装。装完桌面出现 Octop 图标,应用自动进入安装向导。

安装向导的管理员账号表单

向导只有一步关键表单(字段定义见 fnos/docker/wizard/install):

字段要求说明
用户名2-32 位,仅字母、数字、.、_、-默认admin
密码8-64 位,须同时含字母和数字常见密码如Octop123会被拒绝
确认密码与上次输入一致点「下一步」时当场校验
显示名称 / 邮箱可选填了邮箱之后可用邮箱登录

密码不符合规则会被向导当场拦下,不会装到一半才失败。

阶段二:等「运行中」再打开控制台

两种部署方式的地址与端口

装完别急着开浏览器:Docker 版首次启动要拉取与本包同版本的ghcr.io/tencentcloud/octop镜像,通常 1-3 分钟;本地版没有这一步。应用中心显示「运行中」后,按下表访问:

部署方式访问地址首次注意
Docker 版http://<设备IP>:8088拉镜像 1-3 分钟,之后重启不再重拉
本地版http://<设备IP>:8089直接打开即可

进入后用向导里设置的用户名(或邮箱)加密码登录:

阶段三:配置模型开始对话

设置 → 模型 配置流程

模型是装完必配的一环,入口在「设置 → 模型」:

配置项怎么填
提供商选一个预置(OpenAI、DeepSeek、Kimi 等),也可用自定义 Base URL
API Key从对应提供商官网复制填入
测试连通性点击测试,通过后即可对话
本地推理(可选)Ollama、ONNX 本地模型,NAS 上彻底离线跑

必须记牢:关键配置

配置项说明可改
服务端口Docker 版 8088、本地版 8089,写死在应用清单(见 fnos/docker/manifest、fnos/native/manifest)否
数据目录飞牛 />
  • 定时任务:新建一条「每天早上 9 点查天气并推送简报」,确认任务列表出现该条目
  • 常见问题

    1. Docker 版首次启动长时间不「运行中」

    • 原因:正在从ghcr.io拉镜像,1-3 分钟属正常;超过则大概率网络不通
    • 处理:检查 NAS 能否访问ghcr.io,必要时走代理;之后的重启不会重拉

    2. 管理员密码忘了

    • 原因:密码改在网页端时备份文件不会更新,容易记混
    • 处理:优先用最近一次网页密码登录;实在找不到就进数据目录看octop-login.txt,或在应用「设置」窗口直接改密

    3. 本地版安装或启动时报错

    • 原因:包内扩展与 CPU 架构绑定,装到不匹配的架构上必挂
    • 处理:核对 NAS CPU 架构,x86 用native、ARM 用native-arm64,重新下对应包

    4. 升级后账号密码会变吗

    • 原因:升级向导不改动网页密码(见 fnos/README.md 中的向导说明)
    • 处理:升级后用原账号登录即可,数据目录不受影响

    继续深入

    • fnos/README.md:飞牛安装完整说明,含卸载、升级向导与 CLI 命令清单
    • docs/user-guide.md:模型、IM 渠道、远程桌面等功能的使用指南
    • docs/configuration.md:服务器行为与环境变量配置参考
    • docs/architecture.md:单进程架构与模块分层说明
    • scripts/build-fpk.sh:本地构建 .fpk 的打包脚本

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

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

    RELATED READING

    延伸阅读

    更多一线实战笔记与深度复盘,助您持续精进