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

# 7.1 命令与配置参考

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

本页列出的命令适用于当前 Compose 与源码流程。npm 原生安装器尚未发布，规划中的安装、启停、备份与升级命令暂不作为可执行参考。运行方式与本机操作范围见[安装指南](https://docs.teloa.ai/markdown/start/quickstart.md)。

## Compose 命令

在含 `compose.yaml` 的源码目录执行：

```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` | 源码宿主内部端口；Compose 内保持固定 |
| `TELOA_DSH_HOME` | `.runtime/dsh` | 源码模式 DSH 运行目录 |
| `TELOA_RUNTIME_ROOT` | `.runtime/teloa` | 源码模式业务运行目录 |
| `TELOA_WORKSPACE_ROOT` | 运行目录下 `workspace` | 工作文件与默认沙箱工作目录 |
| `TELOA_DSH_PROFILE` | `teloa` | 运行配置身份 |

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

模型凭据在设置中的来源配置，不使用这些端口变量传递。全部发行形态仍由用户自行承担模型调用费用。