gofeatureflag/go-feature-flag

GO Feature Flag Relay Proxy

https://github.com/thomaspoignant/go-feature-flag/blob/main/LICENSE

镜像概述

GO Feature Flag Relay Proxy 使用 https://github.com/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 https://raw.githubusercontent.com/thomaspoignant/go-feature-flag/main/cmd/relayproxy/testdata/dockerhub-example/goff-proxy.yaml -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": "contact@gofeatureflag.org", "anonymous": true, "custom": { "admin": true, "email": "contact@gofeatureflag.org" }}, "defaultValue": "false"}'
   

支持的标签及说明

GO Feature Flag 提供以下标签：

• https://github.com/thomaspoignant/go-feature-flag/blob/main/cmd/relayproxy/DockerfileGoreleaser
• https://github.com/thomaspoignant/go-feature-flag/blob/main/cmd/relayproxy/DockerfileGoreleaserBookworm
• https://github.com/thomaspoignant/go-feature-flag/blob/main/cmd/relayproxy/DockerfileGoreleaser
• https://github.com/thomaspoignant/go-feature-flag/blob/main/cmd/relayproxy/DockerfileGoreleaserBookworm

标签说明

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

许可证

查看此镜像包含软件的许可信息：https://github.com/thomaspoignant/go-feature-flag/blob/main/LICENSE

如何贡献

本项目开放贡献，详见 https://github.com/thomaspoignant/go-feature-flag/blob/main/CONTRIBUTING.md%E3%80%82