返回文档

环境变量

环境变量用于配置应用运行时的参数,如 API 密钥、数据库连接等。

配置方式

  1. 进入项目详情页
  2. 点击「环境变量」标签
  3. 添加或修改变量
  4. 点击「保存并重新部署」

⚠️ 注意

修改环境变量后需要重新部署才能生效。

系统变量

以下变量由系统自动注入:

变量名说明
PORT应用监听端口
DATABASE_URL数据库连接字符串(如已添加)
NODE_ENVNode.js 环境(production)

最佳实践

敏感信息

API 密钥、数据库密码等敏感信息应通过环境变量配置, 不要硬编码在代码中。

命名规范

  • 使用大写字母和下划线
  • 使用有意义的名称
  • 例如:OPENAI_API_KEYREDIS_URL

本地开发

本地开发时使用 .env 文件, 部署时通过平台配置。

# .env.local
OPENAI_API_KEY=sk-xxx
DATABASE_URL=postgresql://...

示例

OpenAI API

OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx

Supabase

SUPABASE_URL=https://xxx.supabase.co
SUPABASE_ANON_KEY=eyJxxx

自定义配置

APP_NAME=MyApp
DEBUG=false
MAX_UPLOAD_SIZE=10485760