flagsmith/edge-proxy

Flagsmith边缘代理镜像

镜像概述和主要用途

该镜像为Flagsmith的官方边缘代理组件，用于在边缘节点部署特性标志（Feature Flag）和远程配置服务。作为Flagsmith生态的核心扩展，它与Flagsmith SaaS或自托管服务无缝集成，支持在分布式环境中高效管理、同步特性标志及配置信息，旨在提升访问性能并优化分布式系统的配置管理流程。

核心功能和特性

• 完整功能支持：实现Flagsmith特性标志和远程配置的全量功能，包括标志切换、用户细分、配置版本控制等
• 边缘优化部署：针对边缘环境设计，减少与中心服务的通信延迟，提升本地配置访问速度
• 无缝服务集成：与Flagsmith核心服务深度联动，支持配置自动同步和状态一致性维护
• 轻量级容器：资源占用低，适配边缘节点（如IoT网关、边缘服务器）的有限计算资源
• 灵活配置：通过环境变量自定义缓存策略、日志级别等参数，满足多样化部署需求

使用场景和适用范围

• 低延迟敏感场景：实时数据处理、用户交互系统等对配置访问延迟要求严苛的应用
• 分布式架构：跨地域微服务集群，需在各区域边缘节点维护一致配置状态的场景
• 边缘计算环境：IoT设备网络、边缘服务器等资源受限但需本地配置管理的场景
• 高可用设计：作为中心服务的分流/备份节点，提升系统整体可用性和容错能力

使用方法和配置说明

前提条件

• 已部署Flagsmith核心服务（SaaS版或自托管版）
• 具备Docker环境（推荐Docker 19.03+或Docker Compose 2.0+）
• 获取Flagsmith环境密钥（从Flagsmith控制台的目标环境设置中获取）

基础部署命令

通过docker run快速启动容器，需指定Flagsmith服务地址和环境密钥：

bash
docker run -d \
  --name flagsmith-edge-proxy \
  -e FLAGSMITH_API_URL=https://api.flagsmith.com \  # Flagsmith API地址（自托管版需替换为实际地址）
  -e FLAGSMITH_ENVIRONMENT_KEY=your-environment-key \  # 替换为实际环境密钥
  -p 8000:8000 \  # 映射容器端口至主机（默认8000）
  flagsmith/edge-proxy:latest

关键环境变量配置

持久化缓存配置

如需持久化缓存数据（避免容器重启后缓存丢失），可挂载本地目录至容器缓存路径：

bash
docker run -d \
  --name flagsmith-edge-proxy \
  -e FLAGSMITH_API_URL=https://api.flagsmith.com \
  -e FLAGSMITH_ENVIRONMENT_KEY=your-environment-key \
  -v ./local-cache-dir:/app/cache \  # 本地缓存目录映射
  -p 8000:8000 \
  flagsmith/edge-proxy:latest

Docker Compose部署示例

创建docker-compose.yml文件简化部署：

yaml
version: '3'
services:
  flagsmith-edge-proxy:
    image: flagsmith/edge-proxy:latest
    container_name: flagsmith-edge-proxy
    restart: always
    ports:
      - "8000:8000"
    environment:
      - FLAGSMITH_API_URL=https://api.flagsmith.com
      - FLAGSMITH_ENVIRONMENT_KEY=your-environment-key
      - CACHE_TTL=60
      - LOG_LEVEL=INFO
    volumes:
      - ./proxy-cache:/app/cache  # 可选：持久化缓存

启动命令：docker-compose up -d

完整配置参考

更多高级配置（如HTTPS启用、自定义CA证书、集群部署）请参见官方文档：
Flagsmith边缘代理官方文档