环境变量

必需变量

数据库

DATABASE_URL="postgresql://user:password@host/db?sslmode=require"

认证

BETTER_AUTH_SECRET="至少32字符的随机密钥"
BETTER_AUTH_URL="http://localhost:3000"

应用 URL

NEXT_PUBLIC_APP_URL="http://localhost:3000"

服务集成

火山引擎（AI 功能）

对话、图像生成和视频生成必需：

VOLCANO_ENGINE_API_KEY="your-volcano-engine-api-key"
VOLCANO_ENGINE_API_URL="https://ark.cn-beijing.volces.com/api/v3"

Creem（支付）

订阅和一次性购买必需：

CREEM_API_KEY="your-creem-api-key"
CREEM_WEBHOOK_SECRET="whsec_..."

测试模式（跳过真实支付）：

CREEM_SIMULATE="true"

ZeptoMail（邮件）

认证邮件和通知必需。请在 ZeptoMail 创建 Mail Agent、验证发信域名，并将 Send Mail Token 仅保存在服务端：

ZEPTOMAIL_SEND_MAIL_TOKEN="your-zeptomail-send-mail-token"
ZEPTOMAIL_BASE_URL="https://api.zeptomail.com.cn/v1.1"
ZEPTOMAIL_SENDER_EMAIL="Your App <noreply@mail.yourdomain.com>"

根据 ZeptoMail 账号所在区域填写 API 基础地址。发件人必须属于已验证域名/Mail Agent，Token 不得提交到 Git。

Google OAuth（可选）

AUTH_GOOGLE_ID="your-google-client-id"
AUTH_GOOGLE_SECRET="your-google-client-secret"

定时任务

CRON_SECRET="your-cron-secret"

可选分析工具

NEXT_PUBLIC_POSTHOG_KEY="phc_..."
NEXT_PUBLIC_GOOGLE_ANALYTICS_ID="G-..."
NEXT_PUBLIC_CLARITY_PROJECT_ID="..."

可选存储（S3 兼容）

STORAGE_ENDPOINT="https://..."
STORAGE_BUCKET="your-bucket"
STORAGE_REGION="auto"
STORAGE_ACCESS_KEY_ID="..."
STORAGE_SECRET_ACCESS_KEY="..."
STORAGE_PUBLIC_URL="https://..."

On this page