环境变量

环境变量负责连接数据库、切换版本能力、配置 API 基础地址以及各种外部服务。推荐用分环境配置文件维护，而不是在容器中手工修改。

最重要的几类配置

• 应用基础 URL 与 API 地址
• 数据库连接地址
• 网站底部备案号与联系信息（如大陆站使用的 NEXT_PUBLIC_ICP_RECORD、公安备案号 NEXT_PUBLIC_PUBLIC_SECURITY_RECORD、联系邮箱 NEXT_PUBLIC_CONTACT_EMAIL）
• AI Provider 相关配置
• 认证、短信、邮件服务配置
• DEPLOYMENT_EDITION 这类版本开关

配置建议

• 把生产与测试环境彻底隔离
• 不要把密钥提交进仓库
• 修改环境变量后，记得重启相应服务并验证关键流程

排错思路

当出现“服务能启动但功能不可用”的情况时，优先检查环境变量拼写、值格式和服务重启是否生效。