配置参考
本页是部署使用者常用配置清单。完整事实来源仍以应用版本中的示例配置、运行时设置页和实际代码为准。
环境变量
| 变量 | 用途 | 建议 |
|---|---|---|
PUBLIC_BASE_URL | 对外访问地址 | 生产环境设置为 HTTPS 域名 |
CORS_ORIGINS | 允许跨域来源 | 只填写可信前端来源 |
DATABASE_URL | 数据库连接 | 使用强密码，避免暴露到公网 |
REDIS_URL | Redis 连接 | 生产环境使用密码或内网隔离 |
APP_SECRET_KEY | 业务密钥加密 | 必须备份，不要随意更换 |
JWT_SECRET_KEY | 登录令牌签名 | 必须保密，泄露后轮换 |
MEETING_DISPATCH_MODE | 会议任务分发 | Docker 部署通常使用 redis |
MESSAGE_TASK_QUEUE_MODE | 消息过滤队列 | Docker 部署通常使用 redis |
TC_RUN_MIGRATIONS | 启动时迁移 | 默认 true |
TC_RUN_MESSAGE_SUBSCRIPTION_LISTENER | 消息监听进程 | 默认 true |
运行时设置
| 设置类型 | 内容 | 生效方式 |
|---|---|---|
| AI 提供商 | Base URL、API key、模型 | 保存后通常立即用于新请求 |
| 代理 | HTTP/SOCKS 代理和测试 | 依赖具体使用方，必要时重启 |
| 日志 | 日志级别、轮转、噪声过滤 | 部分配置需要重启 |
| 应用设置 | 业务开关和默认值 | 由对应用例读取 |
| 密钥 | 外部服务凭据 | 加密保存 |
AI 配置模板
| 字段 | 示例 | 说明 |
|---|---|---|
| Provider name | openai-compatible | 便于识别 |
| Base URL | https://api.example.com/v1 | OpenAI 兼容接口根路径 |
| API key | sk-... | 保存后加密 |
| Model | gpt-... | 用于会议或过滤 |
| Proxy | 可选 | 仅在部署网络需要代理时配置 |
Telegram 配置
| 配置 | 说明 |
|---|---|
| App ID / App Hash | MTProto 登录所需，来自 Telegram developer app |
| Phone | 登录手机号 |
| Session | 登录后保存的会话载荷 |
| Bot Token | Bot 投递或命令场景使用 |
| Channel Ref | @public_channel 或可解析频道引用 |
配置变更记录
生产环境建议记录每次配置变更：
- 变更时间。
- 变更人。
- 变更项。
- 旧值摘要和新值摘要。
- 验证结果。
- 回滚方式。