跳转到内容
StackVitals

环境变量

前端变量

Section titled “前端变量”

在你的托管平台的环境中设置这些变量。只有 VITE_* 变量会暴露给浏览器。

变量必需用途
VITE_SUPABASE_URL是你的仪表盘 Supabase 项目 URL
VITE_SUPABASE_ANON_KEY是你的仪表盘 Supabase anon key
VITE_DASHBOARD_ALLOWED_EMAIL是允许查看仪表盘的邮箱列表（逗号分隔）
VITE_DEMO_MODE否设为 true 可在无需认证的情况下渲染虚构的演示数据

采集器密钥

Section titled “采集器密钥”

这些由 npm run collect:status 和 GitHub Actions 工作流使用。

核心

Section titled “核心”
变量必需用途
PROJECTS_CONFIG_JSON仅 CI采集器配置 JSON（由 GitHub Actions 工作流使用）
HUB_SUPABASE_JWT_SERVICE_ROLE_KEY是仪表盘的 JWT service-role key，用于采集器写入

AWS

Section titled “AWS”
变量必需用途
AWS_REGIONAWS 适配器需要AWS 区域
AWS_ACCESS_KEY_IDAWS 适配器需要IAM access key
AWS_SECRET_ACCESS_KEYAWS 适配器需要IAM secret key

提供商专用

Section titled “提供商专用”
变量必需用途
RESEND_API_KEYResend 需要Resend API key
OPENAI_ADMIN_API_KEYOpenAI 需要OpenAI admin API key
GH_ACTIONS_TOKENGitHub Actions 需要具有 Actions read 权限的 GitHub PAT
CLOUDFLARE_API_TOKENCloudflare 需要只读 Cloudflare API token
CLOUDFLARE_ACCOUNT_ID可选启用注册商过期信息查询

HTTP 健康检查

Section titled “HTTP 健康检查”
变量必需用途
HTTP_HEALTH_CHECK_HEADER_NAME可选健康检查请求的自定义请求头名称
HTTP_HEALTH_CHECK_HEADER_VALUE可选自定义请求头值（用于 Cloudflare WAF 绕过）

每应用占位符

Section titled “每应用占位符”

projects.config.json 中的任何项目资源字段都可以使用 ${ENV_VAR} 占位符。为每个引用的变量创建一个密钥，并在工作流的 env 块中传递它们。常见的每应用变量：

  • ${MY_APP_SUPABASE_URL} — 被监控应用的 Supabase URL
  • ${MY_APP_SUPABASE_ANON_KEY} — 被监控应用的 anon key
  • ${MY_APP_SUPABASE_SERVICE_ROLE_KEY} — 被监控应用的 service-role key

使用 $$ 来转义配置值中的字面 $。