快速开始
环境变量与服务开关
按认证、AI、存储和支付能力配置运行环境。
最小配置
本地站点地址应保持一致:
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 的解析函数为准。
平台 AI 开放条件
平台可用性同时要求密钥非空与对应开关严格等于字符串 true:
AI_PLATFORM_TEXT_ENABLED=true
AI_PLATFORM_IMAGE_ENABLED=false只有密钥而没有开关不会开放服务。公开接口只返回可用性标记,不能把服务端密钥传给页面。
构建与运行时
更改公开变量后重新构建。Cloudflare 运行时配置检查 wrangler.jsonc,敏感值使用 Wrangler Secret。修改桶名时保持构建阶段与运行时一致。
实现入口
src/config/index.ts:产品、套餐与集成配置。src/ai/core/models/platform-availability.ts:AI 开放判断。src/ai/core/models/provider-core.ts:允许域名扩展解析。