使用Infisical管理Next.js + Vercel应用的环境变量

使用Infisical管理Next.js + Vercel应用的环境变量

infisical ♾ Infisical is the open-source secret management platform: Sync secrets across your team/infrastructure and prevent secret leaks. 项目地址: https://gitcode.com/gh_mirrors/in/infisical

在现代Web应用开发中，环境变量的管理是一个关键环节。本文将详细介绍如何使用Infisical这一专业的秘密管理工具，来高效管理Next.js应用在Vercel平台上的环境变量，从本地开发到生产环境的全流程。

为什么选择Infisical

Infisical提供了比Vercel原生环境变量管理更强大的功能：

• 完整的审计日志记录
• 版本控制和时间点恢复
• 团队成员间的变量覆盖
• 跨环境统一管理
• 更细粒度的访问控制

这些功能使得团队协作更加安全高效，特别是在处理敏感信息时。

初始项目设置

1. 创建Infisical项目

首先需要在Infisical中创建一个新项目。项目创建后，我们可以为不同环境添加不同的密钥：

• 开发环境：添加NEXT_PUBLIC_NAME密钥，值为YOUR_NAME
• 生产环境：添加同名的NEXT_PUBLIC_NAME密钥，但值为ANOTHER_NAME

这种环境隔离确保了开发和生产使用不同的配置，避免意外影响线上服务。

2. 初始化Next.js应用

使用以下命令创建一个新的Next.js应用：

npx create-next-app@latest --use-npm infisical-nextjs
cd infisical-nextjs

对于TypeScript项目，可以添加--ts标志：

npx create-next-app@latest --ts --use-npm infisical-nextjs
cd infisical-nextjs

本地开发环境配置

1. 安装Infisical CLI

Infisical提供了跨平台的命令行工具，支持多种操作系统：

• MacOS：通过Homebrew安装
• Windows：使用Scoop包管理器
• Linux：支持Alpine、RedHat/CentOS、Debian/Ubuntu等多种发行版

安装完成后，使用infisical login命令登录你的账户。

2. 初始化项目连接

在项目根目录运行：

infisical init

这会创建一个infisical.json文件，将本地项目与Infisical平台上的项目关联起来。

3. 启动开发服务器

使用以下命令启动开发服务器并注入环境变量：

infisical run -- npm run dev

此时，在pages/_app.js中添加的console.log会输出开发环境配置的值：

console.log('Hello, ', process.env.NEXT_PUBLIC_NAME);
// 输出: Hello, YOUR_NAME

生产环境部署配置

1. 部署到Vercel

首先将Next.js应用部署到Vercel平台。部署完成后，我们需要配置Infisical与Vercel的集成。

2. 配置Infisical-Vercel集成

在Infisical项目的集成页面，选择Vercel集成并授权访问。需要注意：

• 此集成会暂时禁用端到端加密，因为需要将密钥同步到Vercel
• 密钥在传输和存储过程中仍然保持加密状态

3. 同步生产环境变量

选择生产环境作为源环境，Vercel的生产环境作为目标环境，然后创建集成。这样Infisical中的生产环境变量就会自动同步到Vercel。

注意事项

Vercel保留了一些环境变量名称，无法通过Infisical同步，包括：

• AWS相关的密钥和配置变量
• 函数运行时相关变量
• 区域和时间设置等

常见问题解答

Q: 为什么要在Vercel之外使用Infisical管理环境变量？

A: Infisical提供了更专业的秘密管理功能，如审计日志、版本控制、团队成员变量覆盖等，这些都是Vercel原生功能所不具备的。

Q: 禁用端到端加密是否安全？

A: 是的。虽然集成期间禁用了端到端加密，但密钥仍然保持加密存储状态。实际上，大多数秘密管理工具都不支持完全的端到端加密。

最佳实践建议

1. 环境隔离：严格区分开发、测试和生产环境，使用不同的密钥值
2. 命名规范：为环境变量建立统一的命名规范，便于管理
3. 定期审计：利用Infisical的审计日志功能定期检查密钥访问情况
4. 最小权限：为团队成员分配最小必要的访问权限
5. 备份策略：利用版本控制功能建立密钥的备份和恢复策略

通过本文的指导，你应该已经掌握了使用Infisical管理Next.js应用在Vercel上环境变量的完整流程，从本地开发到生产部署的全生命周期管理。

infisical ♾ Infisical is the open-source secret management platform: Sync secrets across your team/infrastructure and prevent secret leaks. 项目地址: https://gitcode.com/gh_mirrors/in/infisical