系统配置参数手册

CXMind 采用云原生架构理念设计，系统中所有的微服务（涵盖底层接入引擎、后台逻辑处理与管理界面）的运行参数，均通过环境配置（.env）进行隔离与管理。

1. 配置文件注入方式

在基于 Docker Compose 的标准部署中，所有相关环境变量统一维护在项目根目录下的 .env 文件。

当您第一次部署时，可以直接复制随项目附带的示例配置文件：

cp .env.example .env

随后，请使用您偏好的文本编辑器修改其中的关键参数。

2. 核心模块配置说明

2.1 基础引擎连接参数 (IE)

变量名	默认值	全局说明
REDIS_ADDR	redis:6379	实时告警、监控流与分布式的内存队列服务地址
DB_DSN	...	后端持久化数据库连接字符串，用于存储话单 (CDR)`
LISTEN_HEP	0.0.0.0:9060	Ingestion Engine 监听来自 Homer/PBX 的 HEP 封装数据流的 IP 与端口

2.2 JWT 及鉴权配置 (AS & AU)

为了保证通讯的安全性，管理台后端的 API 需要校验令牌：

• JWT_SECRET: （必需）用于签署与验证所有的授权令牌。在生产部署时，请务必将此值更改为一个强大且随机生成的字符串。
• ADMIN_EMAIL: 初始化部署时的默认网管邮箱账号。
• ADMIN_PASSWORD_HASH: 初始化部署时默认账号的密钥哈希。

2.3 跨源通信控制 (CORS)

在前后台分离的架构中，为防止安全攻击，通过配置项限定跨域策略：

• ALLOWED_ORIGINS: 允许访问管理台后端 API 的域名白名单。例如：http://localhost:5173,https://admin.yourdomain.com。

3. 面向 Pro 高级功能的特别配置选项

当您导入了有效的商业授权 LICENSE_KEY 时，下列配置将被激活生效：

• AI_PROVIDER: 语音情感及意图分析服务商接入选择（例如 OpenAI, Azure）。
• AUDIO_STORAGE_PATH: RTP 录音文件实体介质的挂载落盘路径。
• MAX_CONCURRENT_CALLS: 从 License 中读取的单节点最大 RTP 解析数软限制。

若需查看本版全部详尽和隐藏的开发时调试参数，请查阅源码仓根目录下的 docker-compose.yml 声明部分。