跳到主要内容

环境变量

TGO 使用环境变量来配置各项服务。本页介绍主要的配置文件和常用环境变量。

配置文件结构​

TGO 的配置分为两层：

tgo/
├── .env                    # 全局配置（端口、主机等）
└── envs/                   # 各服务独立配置
    ├── tgo-api.env
    ├── tgo-ai.env
    ├── tgo-rag.env
    ├── tgo-platform.env
    ├── tgo-web.env
    ├── tgo-widget-app.env
    └── wukongim.env

全局配置（.env）​

根目录的 .env 文件包含全局配置：

变量说明默认值
SERVER_HOST服务器地址（IP 或域名）自动检测
VITE_API_BASE_URL前端 API 地址http://localhost
NGINX_PORTHTTP 端口80
NGINX_SSL_PORTHTTPS 端口443
POSTGRES_DB数据库名tgo
POSTGRES_USER数据库用户tgo
POSTGRES_PASSWORD数据库密码tgo

修改全局配置​

直接编辑 .env 文件：

vi .env

修改后需要重启服务：

./tgo.sh down
./tgo.sh up

服务配置（envs/）​

tgo-api.env​

API 服务配置：

变量说明默认值
SECRET_KEYJWT 密钥（自动生成）-
PORT服务端口8000
REDIS_URLRedis 连接地址redis://redis:6379/0
API_BASE_URLAPI 公开地址http://localhost:8000
MAX_FILE_SIZE最大文件上传大小10485760 (10MB)

tgo-ai.env​

AI 服务配置：

变量说明默认值
PORT服务端口8081
LOG_LEVEL日志级别DEBUG
API_SERVICE_URLAPI 服务地址http://tgo-api:8001
RAG_SERVICE_URLRAG 服务地址http://tgo-rag:8082
MCP_SERVICE_URLMCP 服务地址http://tgo-mcp-v4:8084

tgo-rag.env​

RAG 服务配置：

变量说明
EMBEDDING_MODEL向量化模型配置
CHUNK_SIZE文档分块大小
CHUNK_OVERLAP分块重叠大小

tgo-web.env / tgo-widget-app.env​

前端应用配置：

变量说明
VITE_API_BASE_URLAPI 地址
VITE_WS_URLWebSocket 地址

Kafka 配置​

消息队列相关配置（在 tgo-api.env 中）：

变量说明默认值
KAFKA_BOOTSTRAP_SERVERSKafka 服务器地址kafka:9092
KAFKA_TOPIC_INCOMING_MESSAGES消息接收主题tgo.messages.incoming
KAFKA_TOPIC_AI_RESPONSESAI 响应主题tgo.ai.responses

WuKongIM 配置​

即时通讯服务配置（在 tgo-api.env 中）：

变量说明默认值
WUKONGIM_SERVICE_URLWuKongIM 服务地址http://wukongim:5001
WUKONGIM_ENABLED是否启用true

配置最佳实践​

1. 不要直接修改 envs.docker/ 或 envs.example/​

这些是模板目录。安装时会自动复制到 envs/，请只修改 envs/ 中的文件。

2. SECRET_KEY 安全​

SECRET_KEY 会在首次安装时自动生成。如需手动设置，确保：

  • 长度至少 32 位
  • 使用随机字符串
  • 不要使用默认值

生成新密钥：

openssl rand -hex 32

3. 生产环境配置​

生产环境建议修改以下配置：

# .env
POSTGRES_PASSWORD=<强密码>

# envs/tgo-api.env
SECRET_KEY=<随机密钥>
LOG_LEVEL=INFO

4. 配置修改后重启​

任何配置修改后都需要重启对应服务：

# 重启所有服务
./tgo.sh down
./tgo.sh up

# 或只重启特定服务
docker compose restart tgo-api