部署指南

密钥与 API 获取

Google OAuth、Stripe、R2、PostHog 等第三方密钥获取步骤速查。

敏感配置写入 .dev.vars（本地）或 wrangler secret put（生产）。需要 DNS 验证、分步说明 的集成请查看左侧 第三方集成 专题。

集成专题（推荐阅读）

集成文档
Resend 邮件完整接入指南 — API Key、域名 DNS、DMARC、验证

BETTER_AUTH_SECRET

bash
openssl rand -base64 32
pnpm wrangler secret put BETTER_AUTH_SECRET

用于 JWT 会话 Cookie 签名。泄露后立即轮换并强制用户重新登录。

Google OAuth

  1. Google Cloud Console → 凭据
  2. 创建 OAuth 客户端 ID → Web 应用
  3. 添加授权重定向 URI（本地 + 生产）
  4. 复制 Client ID / Secret → 环境变量

Stripe

  1. Stripe Dashboard → Developers → API keys
  2. 复制 Secret key → STRIPE_SECRET_KEY
  3. Webhooks → 添加 endpoint → 复制 whsec_...

本地 Webhook 转发：

bash
stripe listen --forward-to localhost:3000/api/stripe/webhook

Cloudflare R2

  1. 创建 bucket + API Token（Object Read & Write）
  2. 配置 wrangler.jsonc binding
  3. 设置 R2_* 环境变量

详见 Cloudflare 资源。

PostHog

变量获取位置
VITE_POSTHOG_TOKENProject settings → Project API Key
POSTHOG_PERSONAL_API_KEYPersonal API Keys → phx_...
POSTHOG_PROJECT_ID项目数字 ID

Google Analytics 4

  • 客户端：VITE_GA_MEASUREMENT_ID（数据流衡量 ID）
  • 管理端：GCP 服务账号 + pnpm ga4:grant <PROPERTY_ID>，见 docs/ga4-admin-spec.md

须知

生产环境 Stripe 使用 live 密钥；测试密钥仅用于开发。GOOGLE_REDIRECT_URI 必须与 Google 控制台字符级一致。