本页目录
配置指南
运维人员使用目标部署包规定的配置入口，并核对各服务实际读取的值。环境文件、服务容器和数字员工运行时分别加载配置，生效方式以对应服务的配置流程为准。
配置范围
| 范围 | 重点 |
|---|---|
| 数据 | 数据库、Redis、对象存储地址和权限；备份与连接限制 |
| 身份 | 部署模式、本地登录、LDAP、认证回调与会话策略 |
| 模型与知识 | 模型服务、模型名、向量及重排、解析依赖、超时与出站 |
| 数字员工运行时 | 编排方式、资源与工作区、Gateway、沙箱和回收策略 |
| 插件 | 宿主兼容、Node/Python 运行器、网络声明、数据库及迁移 |
| 入口 | 正式公网或内网访问地址、TLS、WebSocket、跨域和对象代理 |
关键环境变量
下表列出服务端配置名称、要求和影响。运维人员通过部署包支持的受控环境或密钥引用提供配置值。
| 变量 | 要求和影响 |
|---|---|
NODE_ENV、DEPLOYMENT_MODE | 生产校验与 private/saas 行为；不能为绕过检查改为开发模式 |
DATABASE_URL | 数据库连接；变更前核对目标库、迁移和备份 |
TEGO_JWT_SECRET | 至少 32 字符；更换会影响已有认证状态 |
RSA_PUBLIC_KEY、RSA_PRIVATE_KEY | 密码传输使用的密钥对，须匹配并受控保存 |
AUDIT_MASTER_KEY | 生产必填，至少 32 字符；审计正文与签名依赖它 |
AUDIT_MASTER_KEY_PREVIOUS | 轮换时保留旧密钥，供历史正文与签名验证；不随意清空 |
TEGO_LICENSE、TEGO_LICENSE_FILE | 私有化许可，前者优先；变更后核对有效期与配额 |
OPENAPI_KEY_PEPPER | 对外 API Key 哈希参数；生产环境至少 16 字符，变更会影响既有 API Key 校验 |
TEGO_PUBLIC_BASE_URL | 外部可访问地址，影响回调和公开链接 |
CORS_ORIGINS | 按真实客户端来源配置，不以任意来源代替问题排查 |
TEGO_MCP_BASE_URL、TEGO_MCP_INTERNAL_BASE_URL、TEGO_MCP_CONTAINER_BASE_URL | 分别面向客户端、Server 和数字员工容器；容器不能直接使用宿主回环地址 |
TEGO_MCP_SERVICE_TOKEN | 服务间令牌，未配置不接受对应兑换，至少 32 字符 |
浏览器推送通知
浏览器推送由服务端环境配置启用。运维人员在部署包支持的受控环境或密钥引用中提供以下配置，再按变更后的检查核对生效结果。
| 变量 | 要求和影响 |
|---|---|
PUSH_NOTIFICATION_ENABLED | 值为 true 时初始化推送服务；未设置或为其他值时不启用推送。 |
WEB_PUSH_VAPID_PUBLIC_KEY | 浏览器订阅使用的 VAPID 公钥，与私钥成对配置。 |
WEB_PUSH_VAPID_PRIVATE_KEY | 推送发送使用的 VAPID 私钥，使用受控密钥配置，不写入客户端或工单。 |
WEB_PUSH_VAPID_SUBJECT | 推送服务可联系的 mailto: 或 https: 地址。 |
三项 WEB_PUSH_VAPID_* 配置缺少任一项时，服务端不启用浏览器推送。推送队列还依赖 Redis；队列初始化失败时，服务端关闭推送并记录错误。
服务端配置生效后，用户仍需在支持的浏览器中授权通知并完成订阅。实际接收结果在消息通知与用量中核对。
LDAP 与组织同步
LDAP 身份和组织同步统一配置。组织同步需要目录提供 OU 和二进制 objectGUID；组织范围与用户范围可以不同，目录范围外的用户不因此自动进入部门。
登录、搜索和同步使用统一身份规则，同名或同邮箱不会自动合并不同来源账号。
- 管理员在后台“权限与认证 → 认证设置”核对属性映射、同步范围、停用行为和席位。
- 管理员执行连接测试与获准账号的登录测试，再同步已确认的组织范围。
- 管理员检查公司、部门、直属成员和失败结果。
身份变更发生冲突时，管理员核验后修复来源关联，不通过删除并重建平台用户规避冲突。
变更后的检查
- 运维人员保留脱敏配置差异、操作者和变更时间，再按交付流程应用配置。
- 运维人员检查启动日志与依赖连接，并验证登录和受影响能力。
- 运维人员分别确认既有数字员工与新建数字员工的实际配置。
变更失败时，运维人员按原变更记录恢复；密钥回退前需验证历史数据的解密能力。