概述

NEXTDEVKIT 需要几个环境变量才能在不同的部署平台上正常运行。本指南说明如何为每个受支持的平台设置它们。

🚀 快速开始

在项目的根目录中创建 .env 文件，并且永远不要将其提交到版本控制中。

您可以复制示例文件作为起点，然后根据需要修改：

cp .env.example .env

cp .env.example .env.production

其中本地开发使用 .env 文件，其中配置本地开发环境变量，生产环境使用 .env.production 文件，其中配置生产环境变量，你可以将这个文件中的环境变量复制到 Vercel 等云平台中。

📋 特定平台配置

NEXTDEVKIT 支持多个部署平台，每个平台都有自己的环境配置要求：

Next.js 部署

适用于 Vercel, 传统托管、Docker 部署或开发环境。

Cloudflare Workers

适用于具有全球分发和成本效益扩展的边缘计算。

SST AWS

具有 AWS 服务和合规要求的企业级基础设施。

🔒 安全最佳实践

• 永远不要提交环境变量到版本控制
• 为开发、预发布和生产环境使用不同的值
• 定期轮换密钥，特别是 API 密钥和数据库凭据
• 为不同的部署阶段使用特定于环境的配置

📚 常见环境变量

大多数环境变量在平台之间共享，有一些特定于平台的附加项：

• 身份验证：Better Auth 配置和 OAuth 提供商
• 数据库：连接字符串和凭据
• 支付：用于计费的 Stripe 集成
• 邮件：邮件服务提供商配置
• 存储：文件上传和存储配置

选择上面的目标部署平台以获得详细的配置说明。