Spring Boot License 中心授权服务 基于 授权码 + 中心授权服务 的 License 授权方案,支持集群节点管理、缓存降级、防时间篡改。
graph TB
subgraph 管理端
A[管理员] -->|调用API| B[license-server :8100]
B -->|RSA私钥签名| C[授权码字符串]
end
subgraph 业务系统集群
D[节点A :8200] -->|注册/心跳| B
E[节点B :8201] -->|注册/心跳| B
F[节点C :8202] -->|注册/心跳| B
end
B -->|管理节点数| G[节点表 ConcurrentHashMap]
D -->|Server不可达| H[本地缓存降级]
H -->|nanoTime计时| I[防时间篡改]
Loading
模块
用途
核心文件
license-common
公共模型 + 工具
LicenseCodec, CryptoUtils, ServerInfoUtils
license-server
中心授权服务
NodeManagerService, LicenseCodeService
license-client
客户端 SDK
LicenseClientService, AntiTamperChecker, LocalCacheManager
license-demo
示例业务系统
BusinessController
管理员通过 API 签发 Base64 授权码字符串 (RSA 签名)
客户端只需在 application.yml 中配置 license.code 即可
节点启动自动注册,获取 nodeId
定时心跳(默认 120s),超时自动释放(默认 5min)
maxMachineCount 精确控制在线节点数
Server 不可达时,本地 AES-GCM 加密缓存保证降级运行(默认宽限期 72 小时)
System.nanoTime() 单调计时,不受系统时钟修改影响时钟回拨检测:currentTime < lastVerifyTime → 拒绝
引入 license-client 依赖即自动生效,不可通过配置关闭
cd doc
chmod +x generate-keys.sh
./generate-keys.shcp -r doc/keys license-server/
cd license-server
mvn spring-boot:run curl -X POST http://localhost:8100/api/license/generate \
-H " Content-Type: application/json" ' { "subject": "MyApp",
"expiryTime": 1803571200000,
"maxMachineCount": 5,
"modules": ["base", "report"],
"description": "示例授权"
}' cp -r doc/keys license-demo/
cd license-demo
export LICENSE_CODE=" <上一步获得的授权码>" # 业务接口(需要 License 校验)# 查看 License 状态# 查看机器信息
方法
路径
说明
POST
/api/license/generate签发授权码
GET
/api/license/list查看所有授权码
DELETE
/api/license/{id}删除授权码
GET
/api/license/publicKey获取公钥
GET
/api/license/nodes查看在线节点
POST
/api/node/register节点注册
POST
/api/node/heartbeat节点心跳
POST
/api/node/unregister节点注销
GET
/api/node/stats节点请求统计
方法
路径
说明
GET
/api/hello示例业务接口
GET
/api/license/statusLicense 状态
GET
/api/machine/info机器信息
license :
code : ${LICENSE_CODE:} # 授权码server-url : ${LICENSE_SERVER_URL:http://localhost:8100} # License Server 地址public-key-path : ./keys/public_key.pem # RSA 公钥路径heartbeat-interval-seconds : 120 # 心跳间隔grace-period-hours : 72 # 离线宽限期cache-path : ./.license-cache # 本地缓存路径exclude-paths : /actuator/**,/error # 排除校验的路径