后端: Go + Gin + xorm + MySQL
前端: Vue 2 + Vite 5 + Element UI 2
客户端: Go / Java（Spring Boot 2.x & 3.x）/ Python / Node.js / PHP / .NET / C / C++ / Lua / Kotlin / Rust / Ruby

项目结构

kenaito-conf/
├── server/                              # Go 管理端（Gin + xorm）
├── web/                                 # Vue 2 前端
├── kenaito-conf-go-client/              # Go 客户端 SDK
├── kenaito-conf-go-client-demo/         # Go 客户端示例
├── kenaito-conf-springboot2-client/     # Java Spring Boot 2.x 客户端 SDK（JDK 8+）
├── kenaito-conf-springboot2-client-demo/# Spring Boot 2.x 客户端示例（端口 8081）
├── kenaito-conf-python-client/          # Python 客户端 SDK（Python 3.10+）
├── kenaito-conf-python-client-demo/     # Python 客户端示例（端口 8082）
├── kenaito-conf-nodejs-client/          # Node.js 客户端 SDK（Node.js 18+）
├── kenaito-conf-nodejs-client-demo/     # Node.js 客户端示例（端口 8083）
├── kenaito-conf-php-client/             # （未支持）PHP 客户端 SDK（PHP 8.0+）
├── kenaito-conf-php-client-demo/        # （未支持）PHP 客户端示例
├── kenaito-conf-dotnet-client/          # （未支持）.NET 客户端 SDK（.NET 6.0+）
├── kenaito-conf-dotnet-client-demo/     # （未支持）.NET 客户端示例
├── kenaito-conf-c-client/               # （未支持）C 客户端 SDK（libcurl + OpenSSL）
├── kenaito-conf-c-client-demo/          # （未支持）C 客户端示例
├── kenaito-conf-cpp-client/             # （未支持）C++ 客户端 SDK（libcurl + OpenSSL）
├── kenaito-conf-cpp-client-demo/        # （未支持）C++ 客户端示例
├── kenaito-conf-lua-client/             # （未支持）Lua 客户端 SDK（Lua 5.3+）
├── kenaito-conf-lua-client-demo/        # （未支持）Lua 客户端示例
├── kenaito-conf-kotlin-client/          # （未支持）Kotlin 客户端 SDK（Kotlin 1.9+）
├── kenaito-conf-kotlin-client-demo/     # （未支持）Kotlin 客户端示例
├── kenaito-conf-rust-client/            # （未支持）Rust 客户端 SDK（Rust 1.70+）
├── kenaito-conf-rust-client-demo/       # （未支持）Rust 客户端示例
├── kenaito-conf-ruby-client/            # （未支持）Ruby 客户端 SDK（Ruby 2.7+）
└── kenaito-conf-ruby-client-demo/       # （未支持）Ruby 客户端示例

快速开始

1. 启动后端

cd server

编辑 application.properties 设置 active 环境，编辑 application-{active}.properties 配置数据库连接等信息：

# application.properties
active=dev
# application-dev.properties
server.port=8080
database.host=127.0.0.1
database.port=3306
database.name=kenaito_conf
database.user=root
database.password=your_password
jwt.secret=your-jwt-secret
jwt.expireHours=24

启动服务（首次启动自动建表并初始化默认数据）：

go run cmd/main.go -config application.properties
# 或编译后运行
go build -o bin/server cmd/main.go
./bin/server -config application.properties

后端默认监听 :8080。

2. 启动前端

cd web
npm install
npm run dev

前端默认监听 :3000，自动代理 API 到后端。

3. 访问

打开 http://localhost:3000

默认管理员账号：admin / 密码：admin123

客户端接入

Go 客户端

import "kenaito-conf/kenaito-conf-go-client"

cfg := &client.Config{
BaseURL:      "http://localhost:8080",
AppName:      "myapp",
Env:          "dev",
Version:      "latest",
Token:        "app-token",
SyncInterval: 30,
CacheDir:     ".",
}

c := client.New(cfg)

// 注册变更回调
c.OnChange(func (changed map[string]string) {
for k, v := range changed {
fmt.Printf("%s = %s\n", k, v)
}
})

// 启动（拉取全量配置 + 开启定时同步）
c.Start()
defer c.Stop()

// 读取配置
dbHost := c.Get("db.host")

Java Spring Boot 2.x 客户端

适用于 JDK 8+、Spring Boot 2.x 项目，支持配置自动刷新和 @Value 动态更新。

1. 引入依赖


<dependency>
    <groupId>cn.odboy</groupId>
    <artifactId>kenaito-conf-springboot2-client</artifactId>
    <version>1.0.3</version>
</dependency>

2. 添加配置（application.properties）

# 配置中心地址
kenaito.configcenter.base-url=http://localhost:8080
# 应用名称（必填）
kenaito.configcenter.app-name=myapp
# 环境（dev/daily/prod）
kenaito.configcenter.env=daily
# 配置版本
kenaito.configcenter.version=latest
# 认证令牌（可选）
kenaito.configcenter.token=app-token
# 同步间隔（秒）
kenaito.configcenter.sync-interval=30

3. 使用配置

@Value("${database.host:localhost}")
private String databaseHost;

@Value("${database.port:3306}")
private Integer databasePort;

配置变更时会自动刷新 @Value 字段，无需重启应用。详见 Spring Boot 2 客户端文档。

Python 客户端

适用于 Python 3.10+ 项目。

1. 安装

cd kenaito-conf-python-client
pip3 install -e .

2. 使用

from kenaito_conf import Config, ConfigClient

config = Config(
    base_url="http://localhost:8080",
    app_name="my-app",
    env="daily",
    sync_interval=30,
)

client = ConfigClient(config)


# 监听配置变更
def on_change(changed):
    for k, v in changed.items():
        print(f"config changed: {k} = {v}")


client.on_change(on_change)

# 启动客户端（拉取配置 + 开启定时同步）
client.start()

# 获取配置
value = client.get("database.host")
all_configs = client.get_all()

# 停止
client.stop()

Node.js 客户端

适用于 Node.js 18+ 项目。

1. 安装

cd kenaito-conf-nodejs-client
npm link

然后在你的项目中链接：

npm link kenaito-conf