growthbook/proxy

GrowthBook Proxy

镜像概述和主要用途

GrowthBook 是一个模块化的功能标志（Feature Flagging）和实验平台。GrowthBook Proxy 服务器部署于应用程序与 GrowthBook 之间，通过提供速度、可扩展性、安全性和实时功能部署能力，增强 GrowthBook 的实施效果。

核心功能和特性

主要特性

• 缓存 - 显著提升功能查询速度：
  • 内存缓存，可选分布式缓存层（Redis 或 MongoDB）
  • 当 GrowthBook 中的功能发生变更时，通过 WebHooks 自动失效缓存
• 流式更新 - 功能变更或切换时，实时更新应用程序（仅支持 Javascript 和 React）
• 安全性 - GrowthBook 与 GrowthBook Proxy 之间采用私钥认证
• 水平扩展 - 支持数百万并发用户

即将推出的功能

• 服务器端目标定位和功能评估
• 实时功能使用监控和告警
• 边缘部署额外支持
• 更多 SDK 的流式更新支持

使用场景和适用范围

GrowthBook Proxy 适用于以下场景：

• 需要提升功能标志查询性能，减少应用程序延迟的场景
• 要求功能配置变更后实时生效的应用
• 面临高并发用户访问，需要确保系统可扩展性的业务
• 需增强 GrowthBook API 通信安全性的企业环境

使用方法

Docker 安装

通过 Docker 拉取并运行 GrowthBook Proxy 镜像：

bash
docker pull growthbook/proxy:latest
docker run -d -p 3300:3300 \
  -e "GROWTHBOOK_API_HOST=https://growthbook-api.example.com" \
  -e "SECRET_API_KEY=key_abc123" \
  --name gbproxy growthbook/proxy

运行后，将 GrowthBook SDK 指向 GrowthBook Proxy，而非直接连接 GrowthBook API 即可。

配置说明

GrowthBook Proxy 支持通过环境变量进行配置，具体选项如下：

核心配置

• GROWTHBOOK_API_HOST - GrowthBook API 实例的主机和端口
• SECRET_API_KEY - 在 GrowthBook 中创建的 secret API 密钥，路径：设置 -> API 密钥
• NODE_ENV - 环境标识，设置为 "production" 可隐藏调试和信息日志

缓存配置

• CACHE_ENGINE - 缓存引擎，可选值：memory（内存）、redis 或 mongo
• CACHE_CONNECTION_URL - Redis 或 MongoDB 集群的连接 URL（如使用分布式缓存）
• CACHE_STALE_TTL - 缓存条目被视为过期的秒数
• CACHE_EXPIRES_TTL - 缓存条目失效的秒数

网络配置

GrowthBook Proxy 支持 SSL 终止，默认支持 HTTP/2（高性能流式更新所需）：

• USE_HTTP2 - 设置为 "true" 或 "1" 以启用 HTTP/2
• HTTPS_CERT - SSL 证书内容
• HTTPS_KEY - SSL 密钥内容