Octop AI 官网入口：腾讯云开源自托管 AI 助手官方下载与部署

Octop AI 的官方入口是 Octop 独立官网和 TencentCloud 组织下的 Octop 开源仓库，桌面安装包应从该仓库的 Releases 页面下载。部署时可以选择桌面版、官方安装脚本、PyPI 或 Docker Compose；个人电脑优先选桌面版或安装脚本，长期运行的服务器更适合使用 Docker 并持久化数据目录。

Octop AI 是什么

Octop 是腾讯云开源的自托管 AI 助手平台。自托管意味着应用服务、会话、工作区和主要配置由用户部署在自己的电脑或服务器上，而不是只能使用第三方托管网页。

官方项目面向个人、家庭和小型团队，支持多用户与多智能体。一个进程可以同时提供 Web Dashboard、命令行、即时通信渠道、定时任务以及 HTTP、SSE 和 WebSocket 接口，默认使用 SQLite 控制平面，也可配置 PostgreSQL。

如何确认官方下载入口

下载前先确认页面位于 TencentCloud 官方 GitHub 组织的 Octop 仓库。仓库的 About 信息会指向 Octop 独立官网，README、许可证、发布记录和源码也应属于同一个项目。

需求	官方入口	适用场景
了解产品	Octop 独立官网	查看定位和主要能力
阅读文档与源码	TencentCloud/Octop 仓库	核对安装、配置和开发说明
下载桌面端	官方 Releases 页面	Windows、macOS、Linux 与 FnOS
服务器部署	仓库中的 Docker 目录	容器化运行和数据持久化

不要仅凭“Octop”或“Octopus”名称下载文件。同名项目很多，应同时核对维护组织、仓库名、版本发布者和文件命名。

下面是本主题对应的官方入口，均以纯文本形式列出，可复制到浏览器地址栏打开：

Octop 官网：
https://octop.cloud

官方开源仓库：
https://github.com/TencentCloud/Octop

官方下载与版本发布：
https://github.com/TencentCloud/Octop/releases

官方中文说明：
https://github.com/TencentCloud/Octop/blob/main/README_CN.md

官方项目文档：
https://github.com/TencentCloud/Octop/tree/main/docs

选择哪种安装方式

选择安装方式时，先看是否需要图形界面、是否长期运行以及是否已经管理 Python 环境。四种官方路径并不是功能完全不同的产品，而是面向不同运行环境的交付方式。

桌面安装包

桌面版适合不想使用终端的个人用户。官方 Releases 会按 Windows、macOS、Linux 和 FnOS 提供产物，并区分常见的 AMD64 与 ARM64 架构。下载前应在系统信息中确认处理器架构。

官方安装脚本

macOS、Linux 和 Windows 用户可以按 README 选择对应脚本。脚本会使用 uv 在 .octop 目录中准备隔离的 Python 运行环境，并把 octop 命令包装器放入该目录的 bin 子目录，不要求提前安装 Python。

在线脚本能够简化安装，但执行前应在官方仓库检查脚本内容与当前版本说明。对生产服务器，建议先下载脚本、审阅后再执行，而不是直接把网络响应交给 shell。

PyPI 安装

已经自行管理 Python 环境的用户可以通过 PyPI 安装：

pip install octop

需要浏览器自动化能力时，可以选择带 browser 可选依赖的安装形式。该路径适合熟悉虚拟环境和依赖管理的用户。

Docker Compose

需要让 Octop 长期运行在服务器上的用户，优先考虑仓库提供的 Docker Compose 配置。容器方式便于固定运行环境、重启服务并隔离依赖，但必须正确持久化数据目录。

本地安装后的初始化步骤

安装完成后，先重新打开终端，或按安装提示重新加载 shell 配置。能够执行下面的帮助命令，说明命令入口已经加入当前环境：

octop --help

第一次运行需要初始化控制平面：

octop init

初始化向导会创建数据库、JWT 密钥和首个管理员账户。交互式初始化要求设置管理员密码，凭据不应写入公开脚本、截图或代码仓库。

如何启动 Web Dashboard

初始化完成后，可以在前台启动 Octop：

octop run

需要指定地址和端口时使用：

octop run --host 0.0.0.0 --port 8088

默认控制台使用 8088 端口。只在本机使用时应保持环回地址；设置为 0.0.0.0 会允许其他网络接口接收连接，必须配合防火墙、反向代理、TLS 和强密码。

需要让服务随系统运行时，可以使用：

octop service start

是否支持系统服务以及实际服务管理方式取决于操作系统，应以当前版本的 CLI 帮助和官方 README 为准。

Docker Compose 部署步骤

Docker 部署需要先取得官方仓库源码，并确认主机已经安装 Docker 与 Compose 插件。在仓库根目录执行：

docker compose -f docker/docker-compose.yml up -d

容器启动后，通过 8088 端口访问 Web Dashboard。第一次启动会创建管理员账户；未显式提供默认密码时，系统会生成随机密码并写入容器数据目录下的 credential.txt。

查看运行状态和日志可以使用：

docker compose -f docker/docker-compose.yml ps
docker compose -f docker/docker-compose.yml logs --tail=200

如果容器处于运行状态但网页无法访问，依次检查端口映射、防火墙、容器日志和健康状态。不要反复删除数据卷来解决启动问题，否则可能同时删除数据库、配置和工作区数据。

数据目录为什么必须持久化

Octop 的默认数据根目录是当前用户目录下的 .octop，其中包含配置、数据库、密钥、工作区和其他运行状态。Docker 部署会把相应目录映射到持久化存储。

升级、重建容器或迁移服务器前，应先执行官方备份命令并确认备份文件可用：

octop backup

只保留镜像而不保留数据卷，无法恢复用户、智能体和会话。备份文件也可能包含敏感信息，应限制读取权限并妥善保存。

部署完成后如何验证

成功部署不能只看安装命令是否退出。至少应验证命令入口、服务进程、控制台登录和数据持久化四个层面。

1. 运行 octop --help，确认 CLI 可以启动。
2. 完成 octop init，确认初始化没有遗留错误。
3. 启动服务并打开 Web Dashboard，确认登录页可以访问。
4. 使用管理员账户登录，检查模型提供商和智能体配置入口。
5. 重启服务或容器，确认用户和配置仍然存在。

Octop 需要配置可用的模型提供商后才能正常完成对话。网页能打开只代表服务层启动成功，不代表模型密钥、网络和模型名称已经配置正确。

首次配置的安全要点

Octop 能访问文件、工具、浏览器和通信渠道，部署权限应与实际用途匹配。不要使用弱管理员密码，不要直接向公网暴露未配置 TLS 的管理端口，也不要把模型密钥和渠道凭据提交到源码仓库。

• 个人本机使用时优先绑定环回地址。
• 远程访问时使用可信反向代理、HTTPS 和网络访问控制。
• 为工具审批和命令防护保留合理限制。
• 定期备份数据目录，并在升级前额外备份一次。
• 只从官方仓库和 Releases 获取脚本、源码与安装包。

升级 Octop

通过官方安装方式部署后，可以使用更新命令替换程序版本：

octop update

官方说明表示，更新会保留 .octop 中的数据库、工作区、密钥和配置，并在下次启动时处理架构迁移。即便如此，跨版本升级前仍应先执行备份，并阅读目标版本的 Release 说明和变更记录。

Docker 用户应按照目标版本重新拉取或构建镜像，再重建容器。不要删除持久化数据卷；升级后检查日志、登录、模型连接和一项真实对话任务。

常见部署问题

安装后找不到 octop 命令

先打开新的终端窗口，或重新加载当前 shell 配置。仍然找不到时，检查用户目录下的 .octop/bin 是否存在，以及该目录是否进入 PATH。

8088 端口无法访问

先确认进程或容器仍在运行，再检查实际地址、端口占用、防火墙和 Docker 端口映射。远程主机只环回地址时，外部设备无法直接连接。

Docker 首次登录不知道密码

未设置默认密码时，检查持久化数据目录中的 credential.txt。读取后应妥善保存或修改密码，不要把凭据输出到公开日志。

网页能打开但 AI 不回复

服务启动与模型调用是两个阶段。进入设置检查模型提供商、模型名称、密钥和网络连通性，再查看服务日志中的具体错误。

应该下载 AMD64 还是 ARM64

根据操作系统显示的处理器架构选择。Intel 和 AMD 的常见桌面与服务器通常使用 AMD64，Apple Silicon 以及部分 Windows、Linux 和 NAS 设备使用 ARM64。

总结

下载 Octop AI 时应认准 Octop 独立官网、TencentCloud/Octop 官方仓库和该仓库的 Releases 页面。个人电脑可选择桌面版或官方安装脚本，已有 Python 环境可用 PyPI，服务器长期运行则优先考虑 Docker Compose；部署后完成初始化、控制台访问、模型配置、重启持久化和备份验证，才能确认自托管环境真正可用。