Flipt
产品介绍
Flipt 是一个 Git 原生的功能开关管理平台，可通过 Web UI、HTTP API 和 gRPC API 管理与评估功能开关。此应用使用 Flipt 官方镜像，以一个 Flipt service 和本地 Git 存储运行。
主要功能
- 在 Web UI 中管理命名空间、功能开关、变体、规则和分群
- 通过 HTTP 与 gRPC API 在应用中评估功能开关
- 将功能开关状态保存为本地 Git 数据，保留可审计的修订历史
访问说明
- HTTP/UI 容器端口为
8080，安装表单可修改对应主机端口。 - gRPC 容器端口为
9000，安装表单可修改对应主机端口。 - 默认安装不启用身份认证。不要把管理界面直接暴露到不受信任的公网；应使用 1Panel 反向代理、访问控制或上游支持的认证配置保护实例。
部署拓扑
- 默认包只有一个 Flipt service，不依赖数据库、Redis 或 1Panel Runtime。
- Flipt v2 未显式配置存储时使用易失的
in-memory后端。本包设置FLIPT_STORAGE_DEFAULT_BACKEND_TYPE=local，将功能开关状态持久化到本地 Git 存储。 - 本包关闭上游的版本检查与遥测：
FLIPT_META_CHECK_FOR_UPDATES=false、FLIPT_META_TELEMETRY_ENABLED=false。 - Flipt 可连接外部 Git 仓库并支持更复杂的环境配置，但这些能力不属于当前单机默认包。
数据与升级
安装表单选择的数据目录会挂载到 /var/opt/flipt，其中：
storage→/var/opt/flipt/storage，保存本地 Git 仓库及功能开关状态state→/var/opt/flipt/state，保存实例级状态文件
容器以 UID 100、GID 1000 运行。安装和升级脚本会创建上述目录、设置所有者并收紧为 0700。升级前请备份完整数据目录。生产环境建议使用固定版本；latest 包跟随上游 v2 浮动标签，适合明确接受自动获取新 minor/patch 版本的场景。
许可证
- Flipt v2 服务端使用 source-available 的 Fair Core License
FCL-1.0-MIT，不是标准 OSI 开源许可证。 - 许可证允许内部使用、非商业教育与研究等用途，但禁止构成 Competing Use 的商业产品或服务。使用者应自行确认用途符合上游条款。
- 每个版本在发布日的 second anniversary 起获得 MIT future license；在对应日期之前，不能把当前服务端版本视为 MIT 软件。
- RPC 客户端代码和 Go SDK 使用 MIT，并不改变当前服务端的 FCL 授权状态。
安全扫描快照
维护侧于 2026-07-15 使用 Trivy 0.72.0 扫描固定镜像 v2.10.0 与浮动镜像 v2；两者当时解析到同一 digest，结果均为 Critical=0、High=6。High 项包括上游二进制依赖中的 Moby、Go 标准库，以及 Alpine OpenSSL 软件包；其中部分已有修复版本，部分扫描时尚无修复版本。该结果是随漏洞库和镜像变化的时间点快照，部署者应持续跟踪上游镜像更新并在生产使用前重新扫描。
Introduction
Flipt is a Git-native feature flag management platform with a Web UI, HTTP API, and gRPC API. This package runs the official image as one service and explicitly selects persistent local Git storage instead of Flipt v2's default in-memory backend.
The selected data directory is mounted at /var/opt/flipt; flag state is stored under /var/opt/flipt/storage and instance state under /var/opt/flipt/state. Update checks and telemetry are disabled by default. The package does not depend on a database, Redis, or a 1Panel Runtime.
The Flipt v2 server is source-available under FCL-1.0-MIT, including a Competing Use restriction and an MIT future license effective on the second anniversary of each version's release. Review the upstream license before deployment.
Features
- Manage namespaces, feature flags, variants, rules, and segments from the Web UI
- Evaluate flags through HTTP and gRPC APIs
- Persist flag state in a local Git repository with auditable revisions