零命令行,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 件事:
- NAS 能正常联网,Docker 版首次启动必须能访问
ghcr.io拉镜像 - 飞牛是否装了 Docker——这决定你下哪个包
- 你的 CPU 架构是 x86_64 还是 ARM,本地版安装包按架构区分
官方提供 3 款 .fpk 包:
| 安装包 | 体积 | 端口 | 依赖 | 适用对象 |
|---|---|---|---|---|
Octop-fnos-docker-<版本>.fpk | 约 340 KB | 8088 | 主机有 Docker,可访问ghcr.io | x86 / ARM 通用 |
Octop-fnos-native-<版本>.fpk | 约 200 MB | 8089 | 复用飞牛「Python 3.12」,无需 Docker | x86_64 NAS |
Octop-fnos-native-arm64-<版本>.fpk | 约 200 MB | 8089 | 同上 | 仅 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) | 否 |
| 数据目录 | 飞牛 />常见问题1. Docker 版首次启动长时间不「运行中」
2. 管理员密码忘了
3. 本地版安装或启动时报错
4. 升级后账号密码会变吗
继续深入
【免费下载链接】OctopA smarter, self-hosted AI assistant — multi-user, multi-agent. 创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考 |