环境变量与服务开关

最小配置

本地站点地址应保持一致：

代码片段

BETTER_AUTH_URL=http://localhost:3000
NEXT_PUBLIC_APP_URL=http://localhost:3000
BETTER_AUTH_SECRET=替换为足够强的随机密钥

真实值只写在本地环境文件或部署 Secret 中。NEXT_PUBLIC_ 变量会参与客户端构建，不能用来保存 API Key。

能力	变量
平台 AI	`GOOGLE_GENERATIVE_AI_API_KEY`、`AI_PLATFORM_TEXT_ENABLED`、`AI_PLATFORM_IMAGE_ENABLED`
自定义文本端点扩展	`AI_PROVIDER_ALLOWED_HOSTS`
Google 登录	`GOOGLE_CLIENT_ID`、`GOOGLE_CLIENT_SECRET`
邮件	`RESEND_API_KEY`、`RESEND_AUDIENCE_ID`
对象存储	`NEXT_PUBLIC_AVATARS_BUCKET_NAME`、`STORAGE_REGION`、`STORAGE_ENDPOINT`、`STORAGE_ACCESS_KEY_ID`、`STORAGE_SECRET_ACCESS_KEY`
支付	`CREEM_API_KEY`、`CREEM_WEBHOOK_SECRET`、对应套餐与积分包的 Price ID
定时积分任务	`CRON_SECRET`

完整示例以 .env.example、.dev.vars.example 为准。自定义域名白名单的格式以 src/ai/core/models/provider-core.ts 的解析函数为准。

平台可用性同时要求密钥非空与对应开关严格等于字符串 true：

代码片段

AI_PLATFORM_TEXT_ENABLED=true
AI_PLATFORM_IMAGE_ENABLED=false

只有密钥而没有开关不会开放服务。公开接口只返回可用性标记，不能把服务端密钥传给页面。

更改公开变量后重新构建。Cloudflare 运行时配置检查 wrangler.jsonc，敏感值使用 Wrangler Secret。修改桶名时保持构建阶段与运行时一致。