---
title: 运行配置与数据位置
description: 明确哪些配置由 Teloa 保存，哪些由 Harness 管理。
lastVerified: 2026-09-23
---

# 5.1 运行配置与数据位置

当前源码模式让 Teloa 和 DSH 在本机 Node.js 中运行，默认只有 PostgreSQL 使用 Docker；Compose 模式把三者放入容器。两种现有流程都使用标准 Docker，不要求 OrbStack。npm 原生安装尚未发布，下面的数据路径均针对现有流程。

## 文件与程序在哪里执行

原生模式使用本机工作目录和已接入、已授权的工具；Compose 模式使用容器内的工作目录与程序。默认 Compose 配置没有挂载用户整台电脑的文件系统，也不能直接调用宿主的桌面应用。

需要容器访问某个宿主目录时，要自行配置明确的挂载范围与读写权限。挂载路径属于 Docker 引擎所在机器；连接远端引擎不会把客户端电脑的文件自动传过去。详见 [Docker 文件挂载说明](https://docs.docker.com/engine/storage/bind-mounts/)。

## 配置分工

| 配置 | 管理位置 | 注意事项 |
| --- | --- | --- |
| 业务、同事、任务与授权 | Teloa 对应页面与数据库 | 不通过直接改库绕过校验 |
| 模型、凭据、MCP、运行配置 | 设置转入 DSH 配置来源 | 保存后做实际调用验证 |
| 插件组合 | 源码中的组合配置与 setup:dsh | 修改后需重新准备并构建 |
| 浏览器认证 | 启动器生成的当次认证链接 | 重启后变化，不公开保存 |

## Compose 数据位置

| 持久卷 | 容器路径 | 保存内容 |
| --- | --- | --- |
| `app-data` | 应用 `/data` | DSH 会话、模型配置、Teloa 工作文件和资料 |
| `postgres-data` | 数据库 `/var/lib/postgresql/data` | PostgreSQL 业务数据 |
| `database-secret` | 应用和数据库 `/run/teloa-secrets` | 自动生成的数据库口令 |

实际卷名带 Compose 项目前缀，例如默认 `teloa_app-data`。使用 `-p` 指定其他项目时前缀随之变化，不与源码模式的固定容器混用。

DSH 配置在 `/data/dsh`，业务运行目录在 `/data/teloa`，工作目录在 `/data/teloa/workspace`。数据库只通过 Compose 内网服务 `db` 访问，宿主不开放数据库端口。

## 源码模式数据位置

使用 Node.js 直接运行时，数据库卷是 `teloa-postgres-data`；Teloa 运行目录是 `.runtime/teloa`，DSH 目录为 `.runtime/dsh`。适配日志在运行目录内的 `harness.log`，分享前应脱敏。

两种运行方式都需要同时备份数据库和工作文件。仅复制源码或连接配置不是完整备份。

## npm 安装的数据规划

npm 安装计划将程序版本、应用数据和用户工作目录分开保存，更新 npm 包不自动迁移数据或重启服务。默认使用 Docker PostgreSQL；计划中的已有数据库选项仅接本机独立数据库。这些安装与维护命令尚未交付，当前请按所用运行方式的路径维护数据。

## 修改配置后

依次核对保存结果、运行对象和实际调用。修改插件代码或组合配置后，开发模式可能需要构建并重启；不要把浏览器刷新当成服务已加载新代码。

环境变量清单见[命令与配置参考](https://docs.teloa.ai/markdown/reference/configuration.md)，维护流程见[备份、恢复与升级](https://docs.teloa.ai/markdown/deploy/backup.md)。