# dante-engine **Repository Path**: dante-compass/dante-engine ## Basic Information - **Project Name**: dante-engine - **Description**: 🐉 Dante Cloud 国内首个支持阻塞式和响应式服务并行的微服务云原生基座。采用领域驱动模型(DDD)设计思想，以「高质量代码、低安全漏洞」为核心，高度模块化和组件化设计，支持IoT等物联网设备认证，满足国家三级等保要求、支持接口国密数字信封加解密等系列安全体系的多租户微服务解决方案。独创的“一套代码实现微服务和单体两种架构灵活切换”的企业级微服务平台。🔝🔝 点个star 持续关注更新 - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: https://www.herodotus.cn - **GVP Project**: No ## Statistics - **Stars**: 2 - **Forks**: 0 - **Created**: 2024-06-15 - **Last Updated**: 2026-03-27 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

简洁优雅 · 稳定高效 | 宁静致远 · 精益求精

“一套代码、两种架构，可以灵活切换微服务和单体两种架构”的企业级微服务系统

---

Github 仓库 | Gitee 仓库 | GitCode 仓库 | 在线文档

如果您觉得有帮助，请点右上角 "Star" 支持一下，谢谢！

--- ## 重要声明自 **v4.0.5.0** 版本起，Dante Cloud 核心库 Dante Engine 子项目全面开放。 ## 项目地址 ### 1. Dante Cloud 主工程 - **Gitee**：[https://gitee.com/dromara/dante-cloud](https://gitee.com/dromara/dante-cloud) - **Github**：[https://github.com/dromara/dante-cloud](https://github.com/dromara/dante-cloud) - **AtomGit**：[https://atomgit.com/dromara/dante-cloud](https://atomgit.com/dromara/dante-cloud) ### 2. Dante Engine 核心组件库 - **Gitee**：[https://gitee.com/dante-compass/dante-engine](https://gitee.com/dante-compass/dante-engine) - **Github**：[https://github.com/dante-compass/dante-engine](https://github.com/dante-compass/dante-engine) - **AtomGit**：[https://atomgit.com/dante-compass/dante-engine](https://atomgit.com/dante-compass/dante-engine) ### 3. UI 前端工程 - **Gitee**：[https://gitee.com/dante-compass/dante-cloud-ui](https://gitee.com/dante-compass/dante-cloud-ui) - **Github**：[https://github.com/dante-compass/dante-cloud-ui](https://github.com/dante-compass/dante-cloud-ui) - **AtomGit**：[https://atomgit.com/dante-compass/dante-cloud-ui](https://atomgit.com/dante-compass/dante-cloud-ui) ## 企业级技术中台与云原生微服务基座 **Dante Cloud** 国内首个支持阻塞式和响应式服务并行的、开箱即用的企业级云原生微服务基座。是采用**领域驱动模型(DDD)**设计思想，以「**高质量代码、低安全漏洞**」为核心，基于 Spring 生态全域开源技术，高度**模块化和组件化设计**，支持**智能电视、IoT等物联网设备**认证，满足**国家三级等保要求**，支持**接口国密数字信封加解密**等一系列安全体系的一站式多租户微服务解决方案。独创的可以“**一套代码实现微服务和单体两种架构灵活切换**”的企业级应用系统。 ### 一、项目理念 **Dante Cloud** 一直秉承着“简洁、高效、包容、务实”的理念，使用微服务领域及周边相关的各类新兴技术或主流技术进行建设，不断地深耕细作、去粗取精、用心打造。目标是构建一款`代码质量高、维护投入低、安全防护强`的微服务基座，可以帮助用户快速跨越架构技术选型、技术研究探索、基础架构搭建阶段，直接聚焦业务开发。极大地降低传统项目中因安全漏洞、技术负债、低质代码等潜在隐患所产生的高维护投入。期望像项目名字寓意一样，构建一套可以在在行业变革的时期承上启下，助力企业信息化建设和数字化转型的产品。 **Dante Cloud** 核心关注点是：**「高质量的系统代码」**、**「合理的系统架构」**、**「低耦合的模块划分」**、**「高安全性系统实现」**、**「灵活的功能扩展能力」**，**「优质的微服务方案」**。不会像其它一些系统一样，追求 **业务功能** 的 **丰富** 性。堆叠大量无法做到真正通用的功能，反倒会成为负担和干扰，不如由用户自己按照需求灵活设计和实现。 ### 二、架构设计 **Dante Cloud** 优秀的模块化能力，为系统提供了高度灵活的配置能力、**功能的“可插拔”能力** 以及不同需求场景的适配能力。正因为优秀的模块化体系，使得 **Dante Cloud** 不仅是一套完整的微服务架构，还是一套高质量的 **「单体模块化」** 系统。这里的微服务架构和单体架构并不是分离的两套代码，也不是分离的两个项目。而是完全融合的一整套代码，使用时可以根据需要选择是以微服务模式或者单体模式运行，配合灵活的模块能力，实现系统的多样化定制和功能的管控。这是 Dante Cloud 微服务最大的特色之一：**“一套代码、两种架构”**。可以帮助企业在项目早期以单体架构快速建设项目、方便开发人员在本地进行开发以及新技术研究。在项目后期随着用户规模增大以及并发需求提升时，可以快速无缝迁移至微服务架构。 ### 三、适用用户微服务技术并不是 **「落伍」**了，而是进入了 **「成熟期」**，它的 **「适用场景和边界被更清晰地定义」** 了。微服务不再是一个 **「必须要有」** 的选项，而是一个 **「权衡之后」** 的选择。 **Dante Cloud** 也并未使用任何复杂难懂或难以上手掌握的技术，项目中所涉及核心关键组件中，其中 **「近 80% 均为 Spring 生态原生组件」**。技术实现均为各组件标准用法的组合与应用，编码风格和代码设计一直也在极尽努力尽量与 Spring 生态的标准规范用法保持一致，只不过经过大量的版本迭代和重构之后逐渐形成了一定的封装与抽象。因此，我们推荐以下用户选择和使用 **Dante Cloud** - **「传统项目用户」**：可以先体验和使用单体版，先从“前后端分离”以及“多端适配”开始，尝试不同于传统内嵌页面的开发模式。之后也可以平滑迁移至微服务版。 - **「数字转型用户」**：如果您正在考虑进行数字化转型，可以直接选择使用微服务版，不用再为“基础组件碎片化，需花大量时间整合、踩坑版本兼容”等问题而苦恼。 - **「复杂项目用户」**：如果您的业务复杂度上升到一定阶段，可以直接选择使用微服务版，直接聚焦于业务开发，节省大量前期搭建基础设施、解决通用技术问题的时间。 - **「初创团队用户」**：可以先使用单体版进行开发，只要代码放置规范、模块划分合理，后期可以根据需要无缝迁移至微服务架构 - **「技术突破用户」**：本项目并不拘泥局限于常规成熟的技术内容，目标是探索新型技术并用其来为业务的创新服务。喜欢技术尝鲜和突破的用户推荐选择使用。 - **「学习提升用户」**：本项目代码实现优雅和领域划分清晰，编码风格和模块实现尽最大可能与 Spring 生态规范保持一致，是深入学习 Spring 生态组件和提升技能的优秀案例 > 想要从传统项目转型至微服务项目的用户，**建议详细阅读《企业IT架构转型之道：阿里巴巴中台战略思想与架构实战》一书（可以先读前几章）之后再上手本项目！** 对于以下用户我们不建议选择 **Dante Cloud** - **「单体拥趸用户」**：如果您觉得单体架构可以满足您所有的架构需求，微服务繁琐庞大无法比拟单体的“方便”、“快捷”，那么建议选择其它更专业的单体项目。 - **「单一前端用户」**：如果您的项目只会有Web端，不会涉及小程序、移动端、桌面端等其它类型终端，未来也不需要考虑并发或者扩展等问题，选择本项目大材小用。 - **「主流技术用户」**：如果您只擅长 mysql、mybatis 等主流技术，本项目所涉及的基础技术体系可能会让您觉得格格不入，建议选择更适配您技术体系项目。 - **「功能丰富用户」**：本项目定位是基础平台，自认为没有能力做到功能既丰富又通用，如果您追求拥有丰富的、开箱即用的功能后台系统，那么本项目并不适合。 - **「极简编程用户」**：如果您希望基于已有知识不看文档不用学习就可以快速搭建应用，或者通过拖拽生成代码简化开发，这与本项目的产品定位、开发理念、设计哲学背道而驰。 - **「审美品鉴用户」**：本项目前端是使用组件库纯手搓构建，没有专业的美工也没有照搬主流框架，初衷是为后端开发人员接触前端提供一条更友好的途径，所以不能保证符合您的审美。 ## 开源协议 ### 1. 变更声明自 Dante Cloud **v4.0.5.0** 版本起，Dante Engine 子项目全面开放。开源协议 **【永久】** 遵循 Apache License Version 2.0。可用于个人学习、毕设，允许商业使用，禁止二次开源。严禁搬运至 CSDN 下载等平台进行售卖。 ### 2. 补充条款使用时务必遵守以下补充条款。 - **不得将本软件应用于危害国家安全、荣誉和利益的行为，不能以任何形式用于非法为目的的行为。** - 在延伸的代码中（修改现有源代码衍生的代码中）需要带有原来代码中的协议、版权声明和其他原作者规定需要包含的说明（请尊重原作者的著作权，不要删除或修改文件中的Copyright和@author信息）更不要，全局替换源代码中的 Dante Engine、Herodotus 或码匠君等字样，否则你将违反本协议条款承担责任。 - 您若套用本软件的一些代码或功能参考，请保留源文件中的版权和作者，需要在您的软件介绍明显位置说明出处，举例：本软件基于 Dante Cloud 微服务架构或 Dante Engine，并附带链接：https://www.herodotus.cn - 任何基于本软件而产生的一切法律纠纷和责任，均与作者无关。 - 如果你对本软件有改进，希望可以贡献给我们，双向奔赴互相成就才是王道。 - 本项目已申请软件著作权，请尊重开源。 ## 工程结构 ```shell dante-engine ├── dante-assistant -- 辅助功能模块 ├ ├── dante-assistant-access -- 第三方登录接入辅助功能模块 ├ ├── dante-assistant-captcha -- 验证码辅助功能模块 ├ └── dante-assistant-oss -- AWS SDK V2 对象存储辅助功能模 ├── dante-cache -- 缓存功能模块 ├ ├── dante-cache-caffeine -- Caffeine 缓存功能封装模块 ├ ├── dante-cache-commons -- 缓存通用代码模块 ├ ├── dante-cache-jetcache -- JetCache 缓存功能封装模块 ├ └── dante-cache-redis -- Redis 缓存功能封装模块 ├── dante-data -- 数据访问模块 ├ ├── dante-data-commons -- 数据访问通用代码模块 ├ ├── dante-data-jpa -- 以 JPA 作为数据访问层的通用代码模块 ├ ├── dante-data-mongodb -- 以 MongoDB 作为数据访问层的通用代码模块 ├ └── dante-data-rest -- 关联数据访问层的REST开发通用代码模块 ├── dante-dependencies -- 工程 Bom 定义，统一管理工程模块 ├── dante-framework -- Dante Cloud 框架核心基础模块 ├ ├── dante-autoconfigure -- 基础自动配置模块 ├ ├── dante-core -- 核心定义模块 ├ ├── dante-hibernate -- Hibernate 扩展模块 ├ ├── dante-security -- Security 相关基础代码模块 ├ ├── dante-spring -- SpringBoot 相关基础代码模块 ├ └── dante-web -- Web 服务相关基础代码模块 ├── dante-logic -- 系统内置功能业务逻辑模块 ├ ├── dante-logic-identity -- 身份认证功能业务逻辑模块 ├ ├── dante-logic-message -- 系统消息业务逻辑模块 ├ └── dante-logic-upms -- UPMS 业务逻辑模块 ├── dante-message -- 消息模块 ├ ├── dante-message-autoconfigure -- 消息自动配置模块 ├ ├── dante-message-commons -- 消息通用代码模块 ├ └── dante-message-servlet-websocket -- 基于 Servlet 环境下的 Websocket 功能封装模块 ├── dante-oauth2 -- OAuth2 认证模块 ├ ├── dante-authentication-autoconfigure -- OAuth2 授权服务器基础内容自动配置模块 ├ ├── dante-authorization-autoconfigure -- OAuth2 资源服务器基础内容自动配置模块 ├ ├── dante-oauth2-authentication -- Spring Authorization Server 授权服务器核心功能封装模块 ├ ├── dante-oauth2-authorization -- Spring Authorization Server 资源服务器核心功能封装模块 ├ ├── dante-oauth2-commons -- OAuth2 共性通用代码模块 ├ ├── dante-oauth2-extension -- Spring Authorization Server 功能扩展模块 ├ └── dante-oauth2-persistence-jpa -- 以 JPA 作为 SAS 核心数据访问层代码实现模块 ├── dante-rest -- 系统内置功能 REST 接口模块 ├ ├── dante-rest-oss -- 对象存储功能 REST 接口模块 ├ ├── dante-rest-identity -- 身份认证功能 REST 接口模块 ├ ├── dante-rest-message -- 消息功能 REST 接口模块 ├ └── dante-rest-upms -- UPMS 功能 REST 接口模块 ├── dante-starter -- Starters ├ ├── cache-spring-boot-starter -- 缓存自动配置 Starter ├ ├── captcha-spring-boot-starter -- 验证码自动配置 Starter ├ ├── data-mongodb-spring-boot-starter -- MongoDB 数据访问层自动配置 Starter ├ ├── data-rdbms-spring-boot-starter -- 关系型数据库数据访问层自动配置 Starter ├ ├── facility-alibaba-spring-boot-starter -- 面向 Spring Cloud Alibaba 的微服务基础设施适配 Starter ├ ├── facility-gateway-spring-boot-starter -- Alibaba Sentinel 在 Gateway 环境下基础设施适配 Starter ├ ├── facility-kafka-spring-boot-starter -- 基于 Kafka 的消息事件自动配置 Starter ├ ├── facility-tencent-spring-boot-starter -- 面向 Spring Cloud Tencent 的微服务基础设施适配模块 Starter ├ ├── fegin-client-spring-boot-starter -- Feign 客户端自动配置 Starter ├ ├── logging-spring-boot-starter -- 日志收集和聚合自动配置 Starter ├ ├── oss-spring-boot-starter -- 基于 AWS SDK V2 对象存储自动配置 Starter ├ ├── reactive-container-spring-boot-starter -- Reactive 容器基础配置自动配置 Starter ├ ├── servlet-container-spring-boot-starter -- 基于 JPA 的多租户自动配置 Starter ├ ├── servlet-message-spring-boot-starter -- Servlet 环境消息模块自动配置 Starter ├ ├── tenant-spring-boot-starter -- 基于 JPA 的多租户自动配置 Starter ├ ├── web-spring-boot-starter -- Web 微服务通用 Starter ├ └── webmvc-spring-boot-starter -- WebMvc 类型应用自动配置 Starter └── readme -- README 相关素材放置目录 ``` ## 安全测试 Dante Cloud 已通过由第三方进行的软件出厂安全测试。详情参见：[安全测试](https://www.herodotus.vip/guide/security/compliance.html) ## 版本分支 ### 一、版本号说明本系统版本号，分为四段。 - 第一段和第二段，与 Spring Boot 版本对应，根据采用的 Spring Boot 版本变更。例如，当前采用 Spring Boot 2.4.6 版本，那么就以 2.4.X.X 开头 - 第三段，表示系统功能的变化 - 第四段，表示系统功能维护及优化情况 ### 二、分支说明 | 分支名称 | 对应 Spring 生态版本 | 对应 JDK 版本 | 用途 | 现状 | |:----------------------:|-----------------------------------------|-----------|----------------|-------------------------------------------------------------| | master | Spring Boot 4.0 和 Spring Cloud 2025.1.X | JDK 25 | 主要发布分支 | 推荐使用代码分支 | | develop | Spring Boot 4.0 和 Spring Cloud 2025.1.X | JDK 25 | Development 分支 | 新功能、ISSUE 均以此分支作为开发，发布后会 PR 至 master 分支 | | 3.5.X | Spring Boot 3.5 和 Spring Cloud 2025.0.X | JDK 17 | 历史版本，停止维护 | 基于 Spring Boot 3.5 时代开发的代码分支，稳定可用 | | 3.4.X | Spring Boot 3.4 和 Spring Cloud 2024.0.X | JDK 17 | 历史版本，停止维护 | 基于 Spring Boot 3.4 时代开发的代码分支，稳定可用，不再维护 | | 3.2.X-3.3.X | Spring Boot 3.3 和 Spring Cloud 2023.0.X | JDK 17 | 历史版本，停止维护 | 基于 Spring Boot 3.3 时代开发的代码分支，稳定可用，不再维护 | | 3.1.X | Spring Boot 3.1 和 Spring Cloud 2022.0.X | JDK 17 | 历史版本，停止维护 | 基于 Spring Boot 3.1 时代开发的代码分支，稳定可用，不再维护 | | 2.7.X | Spring Boot 2.7 和 Spring Cloud 2021.0.X | JDK 8 | 历史版本，停止维护 | 基于 Spring Boot 2.7 时代开发的代码分支，稳定可用，不再维护 | | spring-security-oauth2 | Spring Boot 2.6 和 Spring Cloud 2021.0.X | JDK 8 | 历史代码，不再维护 | 基于原 Spring Security OAuth2 实现的微服务，稳定可用，因相关组件均不在维护，所以该版本不再维护 | ## 参与贡献 1. 在 Gitee fork 项目到自己的 repo 2. 把 fork 过去的项目也就是你的项目 clone 到你的本地 3. 修改代码（记得一定要修改 develop 分支） 4. commit 代码，push 到自己的库（develop 分支） 5. 登录 Gitee 在你首页可以看到一个 pull request 按钮，点击它，填写一些说明信息，然后提交即可。 6. 等待维护者合并 ## 交流反馈 - 欢迎提交[ISSUE](https://gitee.com/dromara/dante-cloud/issues) ，请写清楚问题的具体原因，重现步骤和环境 ## 赞助人列表 | 序号 | 赞助人 | 赞助时间 | 序号 | 赞助人 | 赞助时间 | 序号 | 赞助人 | 赞助时间 | |:--:|:------------------------------------------:|:----------:|:--:|:----------------------------------------------:|:----------:|:--:|:----------------------------------------:|:----------:| | 1 | ご沉默菋噵 | 2021-10-25 | 2 | [偷土豆的人](https://gitee.com/dongzongyang) | 2021-11-24 | 3 | [lorron](https://gitee.com/lorron) | 2022-04-04 | | 4 | 在云端 | 2022-12-26 | 5 | [西晽](https://gitee.com/syllvin) | 2022-12-27 | 6 | [p911gt3rs](https://gitee.com/p911gt3rs) | 2023-01-03 | | 7 | [jacsty](https://gitee.com/jacsty) | 2023-01-31 | 8 | [hubert_rust](https://gitee.com/hubert_rust) | 2023-03-16 | 9 | [Zkey Z](https://gitee.com/zkeyzvip) | 2023-03-18 | | 10 | [志国欧巴](https://gitee.com/zzgf16) | 2023-03-27 | 11 | [michael](https://gitee.com/yiminyangguang) | 2023-04-07 | 12 | [大叔丨小巷](https://gitee.com/yushui_wang) | 2023-04-11 | | 13 | [sun_left](https://gitee.com/sun_left) | 2023-04-19 | 14 | [time、sand](https://gitee.com/tzy15680905763) | 2023-07-06 | 15 | [印第安老斑鸠](https://gitee.com/deadncut) | 2023-09-09 | | 16 | 一阵风 | 2023-12-10 | 17 | Jack | 2024-03-01 | 18 | [onehelper](https://gitee.com/onehelper) | 2024-05-24 | | 19 | [宁哥](https://gitee.com/seabuckthorn-syrup) | 2024-05-29 | 20 | [cryptoneedle](https://gitee.com/cryptoneedle) | 2024-11-01 | 21 | 别吓跑我的鱼 | 2025-01-10 | | 22 | [代码裁缝](https://gitee.com/code-tailor) | 2025-03-01 | 23 | Go ahead | 2025-03-10 | 24 | [hoku](https://gitee.com/hoku888) | 2025-06-18 | | 25 | 飞翔 | 2025-07-19 | 26 | | | 27 | | | ## 关注我

公众号：码匠君