> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# 在飞牛OS 中使用 Octop

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

## 选择安装包

请前往对应版本的 [GitHub Releases](https://github.com/TencentCloud/Octop/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，不用 Docker             | `http://<NAS的IP>:8089` | 直接在飞牛上运行，自带 Python、无头 Chromium 和远程桌面组件。         |
| **本地 arm64**（`Octop-fnos-native-arm64-<版本>.fpk`）  | ARM64，且没有 Docker              | `http://<NAS的IP>:8089` | 内容与 amd64 本地包相同。                                |


> **说明**
> 
> 官方发布包已固定版本号，不再提供滚动 `fnos-latest` 标签。更新时请下载对应新版本的 `.fpk` 文件。
> 


## 安装与快速上手


### 下载安装包

在 [GitHub Releases](https://github.com/TencentCloud/Octop/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 终端中执行：
    ```bash
    docker exec -it octop octop user passwd <用户名> --password <新密码>
    ```
  - **本地版**：SSH 登录 NAS 后执行：
    ```bash
    octop user passwd <用户名> --password <新密码>
    ```
    如提示找不到命令，可使用完整路径 `/usr/local/bin/octop` 或 `/var/apps/octop-native/bin/octop-cli`。
- **忘记密码**：详细重置流程请参阅 [重置密码](/guide/guides/reset-password.md)。

### 服务启停与更新

- **启停服务**：在飞牛应用中心可以直接对应用进行启动、停止或卸载。
- **版本更新**：前往 GitHub Releases 下载新版本 `.fpk`，再次在应用中心手动安装即可覆盖升级，数据目录与配置会自动保留。本地版也可以在页面中升级。完整步骤见[升级版本](/guide/guides/upgrade.md)。


[**快速开始**](/guide/quickstart.md)

在 macOS、Linux 或 Windows 上单行命令安装与运行。

[**Docker 部署**](/guide/quickstart-docker.md)

使用标准 Docker run 或 Docker Compose 部署。

[**模型提供商**](/guide/guides/llm-providers.md)

配置腾讯云混元、DeepSeek、OpenAI 等主流大模型。

[**IM 通道接入**](/guide/guides/im-channels.md)

扫码将专家接入飞书、微信、钉钉或企业微信。
