[开源自荐] LingFrame（灵珑）- 一个专为长运行遗留单体系统设计的 JVM 运行时治理框架 #37

项目地址

https://github.com/LingFrame/LingFrame

类别

Java

项目标题

JVM 长运行系统运行时治理框架：插件隔离 + 金丝雀发布 + 零信任治理，无需微服务重构

项目描述

核心功能：LingFrame（灵珑）是一个专为长运行遗留单体系统设计的 JVM 运行时治理框架。在不重写原有代码、不强制拆分为微服务的前提下，通过单进程内的插件隔离、金丝雀流量治理与零信任权限控制，实现对老系统的可控性、可演进性与安全性治理。

框架强调“在系统尚可理解时进行收拢与重整”，拒绝添加新功能或过度抽象，而是专注解决“长期运行后边界模糊、变更失控”的核心痛点。采用治理而非重构的哲学：插件在同一 JVM 内运行，但强制结构性与运行时隔离；所有操作需授权并全程审计；支持无重启的金丝雀发布与实时监控仪表盘，形成“边界清晰的运行时秩序”。

支持会话持久、实时仪表盘（多语言 SSE 推送）、权限模型重构，兼容主流 Spring Boot 环境。适用于银行、电商、企业级遗留系统等“改不动但不能停”的场景。

一句话总结：LingFrame（灵珑） 是遗留 Java 单体应用的“运行时救赎框架”——在无法重写时，仍能通过清晰边界与强治理，让老系统重获可控与可演进的能力。

Apache-2.0 开源，欢迎 star & 试用反馈！

亮点

主要特性

• 插件隔离（Plugin Isolation）：单 JVM 进程内实现插件的结构与运行时完全隔离，支持热插拔、动态加载/卸载/回滚
• 金丝雀发布（Canary Releases）：实时流量治理，支持灰度路由、版本权重控制，无需重启应用即可验证变更
• 零信任治理（Zero-Trust Governance）：所有插件操作需显式授权，全程调用链审计，防止越权与恶意行为
• 实时治理仪表盘（Dashboard）：监控插件状态、流量分布、金丝雀指标、审计日志；支持多语言（中英）、SSE 实时推送，界面暗黑主题简洁直观
• 兼容性强：JDK 21、Spring Boot 3.x（计划支持 JDK 8、 Spring Boot 2.x）；集成 SpringDoc/Knife4j 生成 API 文档
• 模块化设计：核心模块分离（api/core/dashboard/runtime 等），便于按需引入与扩展
• 拒绝银弹定位：不是微服务替代、不是模块化工具，仅专注运行时边界与可控性

企业级工作流

• 金丝雀部署流程：插件开发 → 打包 → 热加载 → 流量切分（canary） → 观察指标 → 全量或回滚
• 零信任操作审计：权限校验 → 调用链追踪 → 日志记录 → 异常阻断/告警
• 遗留系统治理路径：接入 LingFrame → 逐步插件化边界模块 → 通过仪表盘监控与收敛 → 实现“优雅老化”而非激进重构
• 实战快速验证：支持示例应用（lingframe-examples/lingframe-example-host-app）一键启动，立即体验隔离与治理

示例代码

git clone https://github.com/LingFrame/LingFrame.git

cd LingFrame/lingframe-examples/lingframe-example-host-app

mvn spring-boot:run


启动后访问仪表盘（默认端口），可实时 drop/load 插件、配置金丝雀流量、查看零信任审计日志。

截图或演示视频

（仪表盘预览：插件列表、状态监控、流量控制面板、Trace Logs 调用链、权限不足/绕过/成功日志等界面展示，支持实时 SSE 更新）