7.1 命令与配置参考
普通使用优先按安装指南操作；只有明确运行位置和影响范围后才调整配置。
以下 Compose 命令适用于本版本下载配置与源码流程；使用 npm 时，请运行 teloa --help 查看本版本的安装、启停、备份与升级选项。运行方式与本机操作范围见安装指南。
当前稳定版为 0.2.31，数据版本为 18，直接兼容 [18]。原生维护使用同版 CLI；升级沿用原 home 并保留自动备份，见备份与升级。
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，见运行配置与数据位置 |
Compose 将运行目录放在 /data，由持久卷保存。切换目录或 profile 不会自动迁移旧数据；验收隔离需同时设置完整的隔离参数，使用专用启动器。
模型密钥在设置中配置，不通过这些端口变量传递。无论哪种版本，模型调用费用都由用户自行承担。