外观
配置参考
约 457 字大约 2 分钟
完整变量清单见 deploy/.env.example 和 deploy/.env.external-middleware.example。生产环境将真实值放入受控 .env 或密钥管理系统，不要提交到仓库。
基础与入口
| 配置 | 用途 |
|---|---|
APP_DOMAIN | 用户端域名；裸 IP 部署可保持 _。 |
ADMIN_DOMAIN | 管理端域名。 |
PUBLIC_BASE_URL | 公共访问根地址，影响回调与外部可访问媒体链接。 |
BACKEND_PORT / GATEWAY_PORT | 后端与 Gateway 运行端口。 |
TZ | 统一运行时区，默认 Asia/Shanghai。 |
数据与认证
| 配置 | 用途 |
|---|---|
MYSQL_* 或 MYSQL_DSN | 内置或外部 MySQL 连接配置。 |
AUTH_ACCESS_SECRET | 用户访问令牌签名密钥。 |
ADMIN_AUTH_ACCESS_SECRET | 管理员访问令牌签名密钥。 |
USER_INTERNAL_*_TOKEN | 业务服务调用 user-service 的内部认证令牌。 |
GATEWAY_*_SERVICE_TOKEN | Gateway 到各领域服务的认证令牌。 |
AI、媒体与对象存储
| 配置 | 用途 |
|---|---|
GENERATION_* | 生成工作进程、轮询、超时、回调和并发。 |
MEDIA_ANALYSIS_* | 可选媒体分析模型、下载限制、时长限制与轮询。 |
QINIU_* | 七牛对象存储、Bucket、上传端点与公开访问域名；QINIU_PUBLIC_DOMAIN 专用于浏览器/API 的稳定 CDN 地址，QINIU_UPSTREAM_DOMAIN 保留为服务端/AI 上游源站。 |
AGENT_* | Agent 工作进程、媒体调用、RAG/Qdrant、嵌入与重排能力。 |
计费与支付
| 配置 | 用途 |
|---|---|
BILLING_PAYMENT_ENABLED | 是否启用真实支付。验证完成前保持 false。 |
BILLING_PAYMENT_CONFIG_ENCRYPT_KEY | 服务端支付配置加密密钥。 |
BILLING_WECHAT_* | 微信支付商户配置与通知地址。 |
BILLING_ALIPAY_* | 支付宝商户配置与通知地址。 |
变更机密配置后，应只重启受影响服务并验证其健康状态。生产密钥更换需制定兼容与回滚策略，避免一次性造成用户会话或内部服务认证全部失效。