Octop 飞牛NAS部署：三步跑通你的专属AI助手
项目地址: https://gitcode.com/GitHub_Trending/oct/Octop Octop 是腾讯开源的自托管 AI 助手，把聊天、多专家 Agent、定时任务、IM 渠道接入全部打进一个进程里。它跑在你的 NAS 上，聊天记忆、专家数据都留在你自己的硬盘里，不出门。这篇文章带你做四件事：选对安装包、装到能登录、把模型配通、用三个小场景验证好不好用。
🧭 动手前花 2 分钟：选对包
下包之前先确认三件事，能避开大部分弯路：
- 飞牛有没有装 Docker。打开飞牛「应用中心」看一眼 Docker 是否已安装。这直接决定你选哪份包。
- 机器是什么 CPU 架构。在飞牛「系统信息」里看处理器型号，带
86字样基本是 x86，带aarch字样就是 ARM。 - 端口是否空闲。Docker 版占 8088，本地版占 8089，确认这两个端口没被别的应用用掉。
拿不准架构也别慌，直接选 Docker 版就行。它 x86 / ARM 通用，镜像按本机架构自动拉取。
| 安装包 | 体积 | 访问端口 | 前置条件 |
|---|---|---|---|
Octop-fnos-docker-<版本>.fpk | 约 340 KB | 8088 | 主机装 Docker，能访问 ghcr.io |
Octop-fnos-native-<版本>.fpk（x86） | 约 200 MB | 8089 | 无，自动关联飞牛「Python 3.12」 |
Octop-fnos-native-arm64-<版本>.fpk（ARM） | 约 200 MB | 8089 | 无，仅限 ARM 飞牛 |
三款包都挂在对应版本的发布包里，去发布页下载即可。
🚀 从包到登录：5 步跑起来
- 打开飞牛「应用中心 → 设置 → 手动安装应用」，选中刚下载的
.fpk文件。全程点选，不用碰命令行。 - 按安装向导创建管理员账号：
- 用户名：2-32 位，只能含字母、数字、
.、_、- - 密码：8-64 位，必须同时包含字母和数字，再输一次确认一致
- 显示名称、邮箱：可选；填了邮箱，之后能用邮箱登录
- 用户名：2-32 位，只能含字母、数字、
- 等应用中心状态变成「运行中」再往下走。Docker 版首次要拉镜像，通常 1-3 分钟；本地版跳过这步。
- 浏览器打开访问地址：Docker 版是
http://<设备IP>:8088，本地版是http://<设备IP>:8089。 - 用刚设的账号登录，就进 Web 控制台了。
🔑 模型配通：三步到位
装完第一件事就是配模型。不配它，聊天只会回你空话。
去哪找：左侧菜单进「设置 → 模型」。默认停在「预置提供商」标签页。
填什么：点一下 OpenAI、DeepSeek、Kimi、Anthropic 这些现成卡片，配置会自动填好。你只要补上 API Key。
怎么验证：点右下角「测试连通性」。提示通过后点「继续」，模型就算接上了。
两种特殊情况的走法：
- 想彻底离线：预置里有
Ollama (Local)。它默认指向本地地址、不用 API Key。前提是这台机器上跑着 Ollama。 - 你的 Key 不在预置列表里：切到「自定义提供商」，填名称、类型（如 OpenAI 兼容）、Base URL 和 API Key，再点「测试连接」验证。
🎯 三个小场景，验它能干
长文速读。贴进一篇长文，30 秒拿到要点。进「聊天」，点快速开始里的「总结长文」。把文章全文贴进去，发送。模型会逐段流式吐出摘要。这一步也是确认模型配没配通的最快方式。
活儿分给多位专家。不同的事，交给不同的专属 Agent。进「专家」，列表里有一批现成模板：通用助手、热点记者、办公自动化等。点「从此模板新建」复制一个出来。每个专家的记忆、渠道、定时任务彼此独立，互不串话。
每日天气简报。早上 9 点自动跑，不用你盯着。进「任务」页新建任务。调度方式选固定频率，比如「每天早上 9:00」。任务内容填一句自然语言指令。启用开关打开，到期它自己跑。
🩺 装不上？先看这 4 条
Docker 版一直不显示「运行中」：多是首次拉镜像卡住，网络到不了 ghcr.io。解法：给飞牛配代理或换网络环境，超 3 分钟没动静就查网络。拉取成功后重启不会重拉。
本地版显示启动失败：可能是架构装错或依赖缺失，别猜。解法：进飞牛「文件管理」，打开数据目录里的 octop-start-error.txt，错误直接写在里面。
用备份密码登不进：octop-login.txt 只记录安装时或应用「设置」窗口改的密码，网页「头像菜单 → 修改密码」改的不会同步进去。解法：直接用网页改后的新密码登录；真忘了就打开数据目录（一般在 /volX/@appshare/octop/data）查备份，或在应用「设置」窗口里重置。
端口被占、服务起不来：多半是手动执行过 octop run，它和应用中心托管的实例抢同一个端口。解法：Web 服务一律在应用中心启停；本地版想跑 octop version、octop provider list 这类管理命令，SSH 进飞牛直接敲就行。
想继续往下走
- fnos/README.md：飞牛安装的完整说明，含卸载、升级向导和 CLI 用法
- docs/user-guide.md：模型、渠道、远程桌面、浏览器 AI 的使用指南
- docs/configuration.md：服务器行为与环境变量配置，想改默认行为看它
- scripts/build-fpk.sh：想自己打
.fpk包的话，从这里入手
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
