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

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

<a href="https://spring.io/projects/spring-boot" target="_blank"><img src="https://img.shields.io/badge/Spring%20Boot-4.1.0-blue.svg?logo=springboot" alt="Spring Boot 4.1.0"></a>
<a href="https://spring.io/projects/spring-cloud" target="_blank"><img src="https://img.shields.io/badge/Spring%20Cloud-2025.1.2-blue.svg?logo=springboot" alt="Spring Cloud 2025.1.2"></a>
<a href="https://github.com/alibaba/spring-cloud-alibaba" target="_blank"><img src="https://img.shields.io/badge/Spring%20Cloud%20Alibaba-2025.1.0.0-blue.svg?logo=alibabadotcom" alt="Spring Cloud Alibaba 2025.1.0.0"></a>
<a href="https://github.com/Tencent/spring-cloud-tencent" target="_blank"><img src="https://img.shields.io/badge/Spring%20Cloud%20Tencent-2.1.2.0--2025.0.2-blue.svg?logo=qq" alt="Spring Cloud Tencent 2.1.2.0-2025.0.2"></a>
<a href="https://nacos.io/docs/latest/overview/" target="_blank"><img src="https://img.shields.io/badge/Nacos-3.2.2-brightgreen.svg?logo=alibabadotcom" alt="Nacos 3.2.2"></a>






<a href="https://my.oschina.net/pointerv" target="_blank"><img src="https://img.shields.io/badge/Author-%E7%A0%81%E5%8C%A0%E5%90%9B-orange" alt="码匠君"></a>
<a href="https://github.com/dromara/dante-cloud/raw/v4.1.0.3/LICENSE"><img src="https://img.shields.io/badge/License-Apache--2.0-blue.svg?logo=apache" alt="License Apache 2.0"></a>
<a href="https://bell-sw.com/pages/downloads/#downloads" target="_blank"><img src="https://img.shields.io/badge/JDK-25%2B-green.svg?logo=openjdk" alt="Java 25"></a>
<a href="https://github.com/dromara/dante-cloud" target="_blank"><img src="https://img.shields.io/badge/Version-4.1.0.3-red.svg?logo=spring" alt="Version 4.1.0.3"></a>
<a href="https://github.com/dante-compass/dante-engine" target="_blank"><img src="https://img.shields.io/badge/Dante%20Engine-4.1.0.3-red.svg?logo=spring" alt="Dante Engine 4.1.0.3"></a>
<a href="https://github.com/dante-compass/thingsbrain" target="_blank"><img src="https://img.shields.io/badge/ThingsBrain-4.1.0.3-red.svg?logo=spring" alt="ThingsBrain 4.1.0.3"></a>
<a href="https://github.com/dante-compass/dante-cloud-ui" target="_blank"><img src="https://img.shields.io/badge/Dante%20Cloud%20UI-4.1.0.3-blue.svg?logo=quasar&logoColor=%23050A14" alt="Dante Cloud UI 4.1.0.3"></a>
<a href="https://github.com/dante-compass/herodotus-cloud-ui-vuetify" target="_blank"><img src="https://img.shields.io/badge/Dante%20Cloud%20UI(New)-4.1.0.3-blue.svg?logo=vuetify&logoColor=%231867C0" alt="Dante Cloud UI(New) 4.1.0.3"></a>
<a href="https://github.com/dromara/dante-cloud"><img src="https://img.shields.io/github/stars/dromara/dante-cloud.svg?label=Github%20Stars" alt="Github star"></a>
<a href="https://github.com/dromara/dante-cloud"><img src="https://img.shields.io/github/forks/dromara/dante-cloud.svg?label=Github%20Forks" alt="Github fork"></a>
<a href="https://gitee.com/dromara/dante-cloud"><img src="https://gitee.com/dromara/dante-cloud/badge/star.svg?theme=dark" alt="Gitee star"></a>
<a href="https://gitee.com/dromara/dante-cloud"><img src="https://gitee.com/dromara/dante-cloud/badge/fork.svg?theme=dark" alt="Gitee fork"></a>
<a href='https://atomgit.com/dromara/dante-cloud'><img src='https://atomgit.com/dromara/dante-cloud/star/badge.svg' alt='Atomgit star'></a>
<a href="https://www.herodotus.cn"><img src="https://visitor-badge.laobi.icu/badge?page_id=dante-cloud&title=Total%20Visits" alt="Total Visits"></a>
<a href="https://deepwiki.com/dromara/dante-cloud" target="_blank"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>






<a href="https://atomgit.com/dromara/dante-cloud">Atomgit 仓库</a> &nbsp; | &nbsp;
<a href="https://github.com/dromara/dante-cloud">Github 仓库</a> &nbsp; | &nbsp;
<a href="https://gitee.com/dromara/dante-cloud">Gitee 仓库</a> &nbsp; | &nbsp;
<a href="https://www.herodotus.cn">在线文档</a>

重要说明：

因 Maven 中央仓库将于 2026年08月11日 开启 发布配额限制措施（当前为普通用户每月限制发布 7 次、内容大小 80 M、文件数量 1000）， Maven 中央仓库发布限制详情：【原文地址】

为了降低 Maven 中央仓库新措施对项目的影响，对项目进行了多项重构措施：

1. 将 Maven 坐标及包名由原来 Dromara 社区的 org.dromara 变更为 cn.herodotus
2. 将工程代码进行重构，对可以合并的模块进行了合并，对不必要的或者使用率较低模块，特别是 Starter 类型模块，进行了删减。

由于 Dante Cloud 模块较多，虽然做了大量的努力，但始终无法在保持模块合理性的前提下，满足 Maven 中央文件数量的限制（向中央仓库发布一个 jar 是按照 24 个文件计算，包含：signatures, checksums, source jars, javadocs）

为此，将会降低项目向 Maven 中央仓库的发布频率和次数，仅对重要的版本更新向中央仓库推送发布。所以，后续在使用本项目时，大多数情形下需要用户自己编译 Dante Engine 工程代码。

当前 Maven 中央仓库的限制规则并不完全确定，可能会存在调整，Dante Cloud 会结合变化情况，适时调整发布策略。您也可以点个 Star 持续关注更新！

企业级技术中台与云原生微服务基座

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 主工程

• Gitee：https://gitee.com/dromara/dante-cloud
• Github：https://github.com/dromara/dante-cloud
• AtomGit：https://atomgit.com/dromara/dante-cloud

2. Dante Engine 核心组件库

• Gitee：https://gitee.com/dante-compass/dante-engine
• Github：https://github.com/dante-compass/dante-engine
• AtomGit：https://atomgit.com/dante-compass/dante-engine

3. UI 前端工程（旧版）

• Gitee：https://gitee.com/dante-compass/dante-cloud-ui
• Github：https://github.com/dante-compass/dante-cloud-ui
• AtomGit：https://atomgit.com/dante-compass/dante-cloud-ui

4. UI 前端工程（新版）

• Gitee：https://gitee.com/dante-compass/herodotus-cloud-ui-vuetify
• Github：https://github.com/dante-compass/herodotus-cloud-ui-vuetify

5. ThingsBrain 基于 Dante Cloud 的物联网平台（加速开发中...）

• Gitee：https://gitee.com/dante-compass/thingsbrain
• Github：https://github.com/dante-compass/thingsbrain

[二]、开源协议

1. 协议声明

自 v3.3.6.0 版本起，Dante Cloud 以及 Dante Engine 子项目开源协议 【永久】 变更为为 Apache License Version 2.0。可用于个人学习、毕设，允许商业使用，禁止二次开源。严禁搬运至 CSDN 下载等平台进行售卖。

2. 补充条款

使用时务必遵守以下补充条款。

• 不得将本软件应用于危害国家安全、荣誉和利益的行为，不能以任何形式用于非法为目的的行为。
• 在延伸的代码中（修改现有源代码衍生的代码中）需要带有原来代码中的协议、版权声明和其他原作者规定需要包含的说明（请尊重原作者的著作权，不要删除或修改文件中的Copyright和@author信息） ，更不要全局替换源代码中的 Dante Cloud、Dante Engine、ThingsBrain 或 码匠君 等字样，否则你将违反本协议条款承担责任。
• 您若套用本软件的一些代码或功能参考，请保留源文件中的版权和作者，需要在您的软件介绍明显位置 说明出处，举例：本软件基于 Dante Cloud 微服务架构 Dante Engine 或 ThingsBrain，并附带链接：https://www.herodotus.cn
• 任何基于本软件而产生的一切法律纠纷和责任，均与作者无关。
• 如果你对本软件有改进，希望可以贡献给我们，双向奔赴互相成就才是王道。
• 本项目已申请软件著作权，请尊重开源。

如果您确实需要删除作者或版权信息，需要争得作者同意及授权。或者在 【使用公司及组织】 下进行登记，经作者整理登记信息形成表格后，可视为正式授权。

[三]、工程结构

dante-cloud
├── configurations -- 配置文件脚本和统一Docker build上下文目录
├── dante-cloud-dependencies -- 工程 Bom 定义，统一控制工程模块
├── dante-cloud-module -- “半成品”组件模块分组(可以再此建立业务代码模块，以模块的形式实现代码的共享以及架构的切换)
├    ├── dante-cloud-commons -- 微服务版公共辅助代码模块
├    └── dante-monolith-autoconfigure -- 单体版自动配置模块
├── dante-cloud-packages -- 基础核心Starter
├    ├── authentication-spring-boot-starter -- OAuth2 授权服务器自动配置 Starter(主要用于微服务版和单体版统一认证)
├    ├── authorization-servlet-spring-boot-starter -- 阻塞式 OAuth2 资源服务器自动配置 Starter(除了 Monitor 等特殊服务以外，所有服务均需依赖)
├    ├── facility-alibaba-spring-boot-starter -- 面向 Spring Cloud Alibaba 的微服务基础设施适配 Starter
├    ├── facility-spring-boot-starter -- 基础设施切换依赖 Starter(用于切换 Alibaba、Tencent和原生微服务基础设施环境)
├    ├── facility-tencent-spring-boot-starter -- 面向 Spring Cloud Tencent 的微服务基础设施适配模块 Starter
├    ├── fegin-client-spring-boot-starter -- Feign 客户端自动配置 Starter
├    ├── rpc-client-oss-spring-boot-starter -- 服务间通信客户端自动配置 Starter(OSS 作为客户端访问其它服务)
├    ├── rpc-client-uaa-spring-boot-starter -- 服务间通信客户端自动配置 Starter(UAA 作为客户端端访问其它服务)
├    └── rpc-server-upms-spring-boot-starter -- 服务间通信服务端自动配置 Starter(UPMS 作为服务端为其它服务提供访问)
├── dante-cloud-platform -- 平台核心服务
├    ├── dante-cloud-gateway -- 统一网关服务
├    ├── dante-cloud-message -- 平台消息服务
├    ├── dante-cloud-monitor -- Spring Boot Admin 监控服务
├    ├── dante-cloud-uaa -- 账户管理和统一认证模块
├    └── dante-cloud-upms -- 统一权限管理系统服务
├── dante-cloud-services -- 平台业务服务
├    ├── dante-cloud-bpmn-ability -- 工作流服务
├    ├── dante-cloud-bpmn-logic -- 工作流基础代码模块
├    ├── dante-cloud-oss-ability -- 对象存储服务
└──  └── dante-monolith-application -- Dante Cloud 单体版应用模块

[四]、版本分支

1. 版本号说明

本系统版本号，分为四段。

• 第一段、第二段和第三段，与 Spring Boot 版本对应，根据采用的 Spring Boot 版本变更。例如，当前采用 Spring Boot 2.4.6 版本，那么就以 2.4.6.X 开头
• 第四段，表示在当前 Spring Boot 版本下，系统功能维护及优化情况。

2. 分支说明

[五]、安全测试

Dante Cloud 已通过由第三方进行的软件出厂安全测试以及等保测试。详情参见：安全测试说明

[六]、如何升级

尽量不修改 Dante Cloud 以外的项目源码，如 Dante Engine、Dante OSS。如果修改了，请 Pull Requests 上来，否则代码与官方不同步，可能会将对你的日后升级增加难度。

每个版本升级，我们都会附带详细更新日志：https://www.herodotus.cn/logs/ 在这里，你可以看到 Dante Cloud 新增哪些新功能和改进。 针对有较大变化、差异的版本，我们都会负载详细的升级指南：https://www.herodotus.cn/breaking/ 在这里，你可以看到 Dante Cloud 不同版本对应升级方法。

[七]、功能展示

1. Passkey 通用密钥「无密码」登录

2. 方法级动态权限