GO Feature Flag Relay Proxy

镜像概述

GO Feature Flag Relay Proxy 使用 thomaspoignant/go-feature-flag SDK 获取功能标志配置文件，并暴露 API 以获取标志变体。它允许多台服务器连接到单个配置文件，适用于前后端需要使用同一功能标志配置文件的场景，通过标准协议实现语言无关性。

核心功能与特性

• 自托管解决方案：可在私有环境中部署，确保数据安全性
• 轻量级设计：资源占用低，部署简单
• 100% 开源：基于开源协议，代码透明可审计
• 多服务器共享配置：多台服务器可连接到同一配置文件，简化管理
• 语言无关：通过标准 API 实现，支持各种编程语言的前后端应用

使用场景

• 前后端统一配置：需要前端和后端使用相同功能标志配置文件的场景
• 跨语言项目：多语言开发环境中，通过标准协议实现功能标志统一管理
• 私有部署需求：对数据隐私和控制权有较高要求的企业级应用

使用方法

基本要求

GO Feature Flag 需要配置文件才能运行。默认情况下，容器期望配置文件位于 /goff 目录，文件名为 goff-proxy.yaml。服务默认端口为 1031。

基本使用命令

shell
docker run \
  -v $(pwd)/goff-proxy.yaml:/goff/goff-proxy.yaml \
  gofeatureflag/go-feature-flag:latest

本地测试步骤

以下是在本地运行 GO Feature Flag 的示例：

1. 下载示例配置文件：

   shell
   curl [***] -o goff-proxy.yaml
   

2. 启动容器：

   shell
   docker run \
     -p 1031:1031 \
     -v $(pwd)/goff-proxy.yaml:/goff/goff-proxy.yaml \
     gofeatureflag/go-feature-flag:latest
   

3. 调用 API 测试：

   shell
   curl -X 'POST' \
     'http://localhost:1031/v1/feature/flag-only-for-admin/eval'  -H 'accept: application/json'  -H 'Content-Type: application/json' \
     -d '{ "user": { "key": "***", "anonymous": true, "custom": { "admin": true, "email": "***" }}, "defaultValue": "false"}'
   

支持的标签及说明

GO Feature Flag 提供以下标签：

• latest
• bookworm
• v1
• v1-bookworm

标签说明

• 编号版本（如 v1、1.29 等）：基于 distroless 基础镜像，确保最小镜像体积和高安全性
• 带 -bookworm 后缀的版本：基于 debian-slim bookworm 镜像，便于扩展安装额外工具

许可证

查看此镜像包含软件的许可信息：LICENSE

如何贡献

本项目开放贡献，详见 贡献者指南。