环境与配置

配置存储在 .env 文件中，该文件从 .env.example 复制而来。应用启动时会验证配置值，因此缺失或格式不正确的值会快速失败。

核心

APP_URL：你实例的公开 URL。
NODE_ENV：development 或 production。

数据库

DATABASE_URL：PostgreSQL 连接字符串。PostgreSQL 必须安装 pgvector 扩展。

认证

BETTER_AUTH_SECRET：强随机密钥。生产环境请更换此值。
BETTER_AUTH_URL：认证基础 URL，通常与 APP_URL 相同。
GOOGLE_CLIENT_ID、GOOGLE_CLIENT_SECRET、GITHUB_CLIENT_ID、GITHUB_CLIENT_SECRET：可选的社交登录。留空则仅使用邮箱和密码登录。

存储

STORAGE_DRIVER：minio 用于自托管默认存储，或 s3 用于云存储桶。
S3_ENDPOINT、S3_REGION、S3_BUCKET、S3_ACCESS_KEY、S3_SECRET_KEY、S3_FORCE_PATH_STYLE：存储连接配置。

计费

BILLING_ENABLED：自托管时设为 false，这将使所有配额无限并跳过支付处理。只有当你启用计费时，才需要填写 STRIPE_* 系列值。

邮件

EMAIL_PROVIDER：console 在开发时将邮件记录到日志，smtp 通过你的邮件服务器发送，resend 使用托管服务。
EMAIL_FROM，以及用于 SMTP 的 SMTP_HOST、SMTP_PORT、SMTP_USER、SMTP_PASS。

AI 与素材库

AI_VECTOR：pgvector，因此 AI 搜索使用你的 PostgreSQL 数据库。
STOCK_UNSPLASH_KEY、STOCK_PEXELS_KEY、STOCK_PIXABAY_KEY：可选的素材媒体搜索密钥。

多租户

MULTI_TENANT：false 用于单组织的自托管部署。

仅将密钥保存在 .env 中

切勿提交真实的密钥。请将它们保存在 .env 文件中，该文件已被版本控制忽略，并轮换任何已泄露的密钥。