# light-frame-config

**Repository Path**: cdlvyh/light-frame-config

## Basic Information

- **Project Name**: light-frame-config
- **Description**: 分布式配置中心
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-03-27
- **Last Updated**: 2026-01-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## light-frame-config

![license](https://img.shields.io/badge/license-Apache--2.0-green.svg)

light-frame-config 是一款轻量级的分布式配置中心，能够集中化管理应用不同环境的配置，配置修改后能够实时推送到应用端，并且具备权限管理、版本回退、灰度配置等特性，适用于常见分布式应用配置场景。

![架构设计](https://gitee.com/cdlvyh/light-frame-config/raw/master/doc/image/architecture_design.png)

## 一、功能简介

light-frame-config 是一款简洁明了的分布式配置系统，主要提供以下能力：

- 多层级结构，满足各种环境需要
- 秒级下发配置项，客户端系统动态更新配置项无需重新发布
- 多用户管理，权限管理
- 对指定的配置项或全部的配置提供监听，在线更新
- 兼容原生的Spring@Value注解，同时支持自定义注解和Api获取配置项
- 支持灰度配置，可让部分服务器使用灰度配置
- 记录配置文件操作历史，提供版本回滚，减少误操作带来的影响
- 代码侵入性低，集成、部署简单


## 二、快速开始

请查看项目文档中[快速开始](https://gitee.com/cdlvyh/light-frame-config/blob/master/quickstart.md)来了解如何快速上手使用 light-frame-config 。

## 三、如何贡献

light-frame-config 欢迎广大开发者创建Pull Request来贡献代码，代码通过审核后会被合并到master主分支。

light-frame-config 编译环境要求为JDK8或以上版本，需要采用 [Apache Maven 3.5.0](https://archive.apache.org/dist/maven/maven-3/3.5.0/binaries/) 或者更高的版本进行编译。

## 四、感谢

light-frame-config 部分借鉴参考了 XXL-CONF 和 Apollo 等业界知名分布式配置管理平台关于服务端和客户端设计思路，在此表示感谢！

同时，结合行业共性需求进一步抽象配置多层级结构，以满足各种环境需要。

另外，对于常见的配置痛点，比如版本回滚、灰度配置等也提供了较为简洁的功能实现。

## 五、示例

light-frame-config 的示例工程，详见 light-frame-config-sample 。

## 六、开源许可

light-frame-config 基于Apache License 2.0协议，light-frame-config 依赖了一些第三方组件，其开源协议参见[依赖组件版权说明](https://gitee.com/cdlvyh/light-frame-config/blob/master/NOTICE.md)。