快速开始
环境配置
运行时变量分层与关键配置说明。
配置分层
- 前端运行时(
apps/ship) - API 运行时(
apps/ship-api) - 认证与 OAuth
- 支付与 webhook
- 存储与 AI 供应商
关键变量
- 认证:
BETTER_AUTH_SECRET、BETTER_AUTH_URL、GITHUB_*、GOOGLE_* - 数据:
DATABASE_URL、REDIS_URL - 支付:
STRIPE_SECRET_KEY、STRIPE_WEBHOOK_SECRET - 价格:
STRIPE_PRICE_SUB_*、STRIPE_PRICE_CREDITS_*(也可使用 seed 默认写入的lookup:xxx引用) - 存储:
BETTER_UPLOAD_PROVIDER、S3_* - 站点:
NEXT_PUBLIC_SITE_URL、NEXT_PUBLIC_SERVER_URL
安全建议
- 生产密钥不要以明文落库或提交仓库。
- OAuth 回调域名要与部署域严格一致。
- staging 与 production 的 webhook secret 必须隔离。