1.2 使用 Docker 安装 Teloa

使用 Docker Compose 在自己的设备上运行 Teloa 和 PostgreSQL，数据保存在持久卷中。本机无需安装 Node.js、pnpm 或 OrbStack。

开始前

• 安装并启动 Docker Desktop 或带 Compose 插件的 Docker Engine。
• 已取得 Teloa 源码，进入含 compose.yaml 的目录。当前从源码构建，不提供猜测的官方镜像名。
• 网络能够下载镜像和软件依赖；模型服务与 API 密钥由你自备。

源码获取以 官网 正式发布信息为准。尚未取得源码时，通过官网联系渠道确认预览版获取方式。

docker info
docker compose version

前者应返回运行中的引擎信息，后者显示 Compose 版本。使用当前维护的 Docker，确保支持健康检查和初始化服务的依赖条件。

1. 启动

在源码根目录执行：

docker compose up -d --build

首次启动依次构建镜像、生成数据库口令、初始化数据库并启动 Teloa。口令保存在独立卷中，不需要填写演示密码。

2. 查看状态

docker compose ps

等待 db 与 app 健康。init 是一次性初始化服务，成功退出属于正常行为。持续重启时先检查错误，不要删除数据卷。

默认 Web 端口为本机 3100，数据库不发布到宿主。已有服务占用时，在本目录 .env 中填写 TELOA_PORT=3101，再启动；不要结束无关服务。

3. 打开认证链接

docker compose logs --tail=50 app

在自己的终端找到本次启动输出的完整认证链接。更改过端口时，将链接的端口改为你设置的宿主端口，并保留完整认证参数。

重启后使用新链接。认证链接不是模型密钥，也不要把含认证参数的日志贴到公开问题中。

4. 开始工作

首次进入时可能会提示添加 API 密钥；可以当场配置，也可以选择“稍后配置”，再进入 设置 → 模型。按模型指南验证一次回应。页面可用和模型可用是两个不同结果。

首次配置提示，尚未填写密钥。这里需要模型服务商的 API 密钥，不是上一步的本机认证链接。

接着完成第一项任务或组建第一支团队。初始环境可能为空，不要求先导入演示数据。

停止与继续

docker compose stop
docker compose start

数据保留在持久卷中。电脑休眠、关机或 Docker 退出后，本机任务和自动化无法继续执行。升级前先备份；修改源码请看本地开发。