---
title: 命令与配置参考
description: 查找 Compose、源码启动和运行目录选项。
lastVerified: 2026-11-05
---

# 7.1 命令与配置参考

普通使用优先按安装指南操作；只有明确运行位置和影响范围后才调整配置。

以下 Compose 命令适用于本版本下载配置与源码流程；使用 npm 时，请运行 `teloa --help` 查看本版本的安装、启停、备份与升级选项。运行方式与本机操作范围见[安装指南](https://docs.teloa.ai/v/0.2.12/markdown/start/quickstart.md)。

当前稳定版为 `0.2.12`，数据版本为 `17`，直接兼容 `[17]`。原生维护使用同版 CLI；升级沿用原 home 并保留自动备份，见[备份与升级](https://docs.teloa.ai/v/0.2.12/markdown/deploy/backup.md)。

## Compose 命令

在含 `compose.yaml` 的安装目录执行（使用 Hub 镜像时以 `docker compose up -d --no-build` 启动；源码构建才使用 `--build`）：

```sh
docker compose up -d --build
docker compose ps
docker compose logs --tail=50 app
docker compose stop
docker compose start
```

日志可能含当次认证地址，只在自己的终端查看，不直接贴到公开问题中。`stop` 保留容器和数据卷；不要使用删除数据卷的选项作为常规重启手段。

## 配置项

| 名称 | 默认值 | 用途 |
| --- | --- | --- |
| `TELOA_PORT` | `3100` | Compose 映射到本机的 Web 端口 |
| `TELOA_DSH_PORT` | `3100` | 源码模式下 Web 端口（默认 3100）；Compose 容器内固定监听，映射到本机端口用 `TELOA_PORT` |
| `TELOA_DSH_HOME` | `.runtime/dsh` | 源码模式 DSH 运行目录 |
| `TELOA_RUNTIME_ROOT` | `.runtime/teloa` | 源码模式业务运行目录 |
| `TELOA_WORKSPACE_ROOT` | 运行目录下 `workspace` | 工作文件与默认沙箱工作目录 |
| `TELOA_DSH_PROFILE` | `teloa` | 运行配置身份 |
| `TELOA_OAUTH_PUBLIC_CALLBACK_URL` | 无 | 服务器部署的 OAuth 公开 HTTPS 回调地址；仅在运行目录 `config.json` 未设置 `oauth.publicCallbackUrl` 时使用；npm 安装的 `teloa` 命令不传递此变量，须写在 `config.json`，见[运行配置与数据位置](https://docs.teloa.ai/v/0.2.12/markdown/deploy/configuration.md#oauth-%E8%BF%9E%E6%8E%A5%E7%9A%84%E5%9B%9E%E8%B0%83%E5%9C%B0%E5%9D%80) |

Compose 将运行目录放在 `/data`，由持久卷保存。切换目录或 profile 不会自动迁移旧数据；验收隔离需同时设置完整的隔离参数，使用专用启动器。

模型密钥在设置中配置，不通过这些端口变量传递。无论哪种版本，模型调用费用都由用户自行承担。