配置说明
环境变量、Feature Flags 和配置管理
环境变量
环境变量文件位于 apps/web/.env.local（从 .env.example 复制）。
必填配置
# 数据库连接字符串
DATABASE_URL="postgresql://username:password@host:port/database"
# Better Auth 密钥（用于签名 session）
# 生成方式: openssl rand -base64 32
BETTER_AUTH_SECRET="your-random-secret-key"
# 站点公开地址
NEXT_PUBLIC_SITE_URL="http://localhost:3000"可选配置
# S3 兼容存储（腾讯云 COS）
NEXT_PUBLIC_BUCKET_NAME=""
NEXT_PUBLIC_S3_ENDPOINT=""
# OAuth 社交登录
GITHUB_CLIENT_ID=""
GITHUB_CLIENT_SECRET=""
GOOGLE_CLIENT_ID=""
GOOGLE_CLIENT_SECRET=""
# 微信登录
WECHAT_APP_ID=""
WECHAT_APP_SECRET=""开发 vs 生产
| 配置项 | 开发环境 | 生产环境 |
|---|---|---|
| 文件位置 | apps/web/.env.local | Zeabur 环境变量面板 |
NEXT_PUBLIC_SITE_URL | http://localhost:3000 | https://your-domain.com |
DATABASE_URL | 本地或 Neon 免费版 | Zeabur/Neon 生产实例 |
| 社交登录 | 可选（可跳过） | 建议全部配置 |
安全提示
.env.local 已在 .gitignore 中，不要将包含密钥的文件提交到 Git。
Feature Flags
Feature flags 集中管理在 packages/config/src/index.ts，控制功能开关。
主要配置项
// i18n 配置
i18n: {
enabled: true,
defaultLocale: "zh",
locales: ["zh", "en"],
}
// 认证方式
auth: {
enableMagicLink: false,
enableSocialLogin: true,
enablePasswordLogin: true,
enablePhoneLogin: true,
}
// 组织功能
organizations: {
enable: true,
enableUserCreation: true,
}
// 支付
payments: {
enableStripe: false,
enableWechatPay: true,
}修改 Feature Flags
编辑 packages/config/src/index.ts 中的对应字段即可。修改后重启开发服务器生效。