5.6k，又一款接私活神器，值得你擁有！
一、項目介紹
Lamp-Cloud 是一款基于Spring Cloud Alibaba的微服務(wù)快速開發(fā)平臺，長期位居Gitee企業(yè)級開發(fā)框架熱榜前五，Star數(shù)超8.6k+。項目采用Apache-2.0協(xié)議，提供從代碼生成到容器化部署的全生命周期支持，集成多租戶、數(shù)據(jù)權(quán)限、流程引擎等企業(yè)級特性，助力開發(fā)者快速構(gòu)建高可用分布式系統(tǒng)，實測微服務(wù)開發(fā)效率提升3倍。
二、項目特點
- 快速開發(fā)：快速CRUD，只需少量配置即可完成單表、主從、樹結(jié)構(gòu)等頁面的增刪改查，節(jié)省開發(fā)成本，縮短開發(fā)周期
- 多種多租戶的解決方案：獨立數(shù)據(jù)庫、共享數(shù)據(jù)庫隔離數(shù)據(jù)架構(gòu)、共享數(shù)據(jù)庫共享數(shù)據(jù)架構(gòu)等方式
- 前沿的技術(shù)：vue3、jdk8、jdk17、jdk21、SpringBoot、SpringCloud、sa-token、hutool等主流版本
- 豐富功能：RBAC權(quán)限體系、在線代碼生成器、前后端統(tǒng)一表單校驗、字典回顯、系統(tǒng)配置、自動填充等功能一應(yīng)俱全
三、應(yīng)用場景
領(lǐng)域 | 典型應(yīng)用 | 落地價值 |
SaaS平臺 | 多租戶數(shù)據(jù)隔離與計費(fèi)系統(tǒng) | 某教育SaaS用戶擴(kuò)容成本降低60% |
供應(yīng)鏈金融 | 分布式交易與風(fēng)控系統(tǒng) | 日處理千萬級訂單無故障運(yùn)行 |
智慧城市 | 物聯(lián)網(wǎng)設(shè)備管理平臺 | 支持10萬+設(shè)備實時監(jiān)控 |
醫(yī)療云 | 電子病歷共享平臺 | 滿足等保三級數(shù)據(jù)安全要求 |
新零售 | 全渠道訂單中臺 | 促銷期間系統(tǒng)穩(wěn)定性達(dá)99.99% |
四、功能模塊
1. 核心開發(fā)套件
- 代碼生成器：支持DDD領(lǐng)域驅(qū)動設(shè)計代碼生成
- 多租戶體系：字段級數(shù)據(jù)隔離（COLUMN模式）
- 灰度發(fā)布：基于Nacos的流量染色機(jī)制
2. 業(yè)務(wù)支撐模塊
- 分布式事務(wù)：集成Seata AT模式
- 消息中心：支持短信/郵件/企業(yè)微信通知
- 文件服務(wù)：兼容OSS/MinIO/FastDFS
3. 運(yùn)維監(jiān)控體系
- 鏈路追蹤：SkyWalking深度集成
- 健康檢查：Spring Boot Admin面板
- 日志分析：ELK日志聚合方案
4. 擴(kuò)展能力
- 流程引擎：Activiti 7.0工作流支持
- 規(guī)則引擎：Drools集成
- 數(shù)據(jù)大屏：ECharts數(shù)據(jù)可視化
五、功能特點
- 開箱即用：預(yù)制20+企業(yè)通用模塊（用戶/權(quán)限/日志等）
- 靈活擴(kuò)展：模塊化設(shè)計，支持功能插件化擴(kuò)展
- 云原生支持：全鏈路Kubernetes部署方案
- 國產(chǎn)化適配：麒麟OS + 達(dá)夢數(shù)據(jù)庫兼容方案
- 性能卓越：單服務(wù)實例支撐5000+ TPS
六、技術(shù)架構(gòu)
1. 四層云原生架構(gòu)
- 接入層：Spring Cloud Gateway網(wǎng)關(guān)集群
- 服務(wù)層：Spring Cloud Alibaba微服務(wù)集群
- 數(shù)據(jù)層：MySQL分庫分表 + Redis多級緩存
- 觀測層：Prometheus + Grafana監(jiān)控告警體系
2. 技術(shù)棧
層級 | 核心技術(shù) | 關(guān)鍵組件 |
前端框架 | Vue3 + Ant Design Pro | Vite + TypeScript |
后端框架 | Spring Boot 3 + Spring Cloud 2022 | Nacos + Sentinel |
分布式事務(wù) | Seata 1.7 | AT/TCC模式支持 |
消息隊列 | RocketMQ 5.0 | 事務(wù)消息/延遲消息 |
容器編排 | Kubernetes 1.26 | Helm Chart部署方案 |
安全體系 | OAuth2.1 + JWT | RBAC+ABAC混合模型 |
七、系統(tǒng)截圖
八、部署指南
1. 后端啟動
(1) 修改配置并編譯項目
① 創(chuàng)建數(shù)據(jù)庫：根據(jù)你使用的數(shù)據(jù)庫類型，選擇創(chuàng)庫語句
# mysql
CREATEDATABASEIFNOTEXISTS`lamp_none`CHARACTERSET utf8mb4 COLLATE utf8mb4_general_ci;
# oracle
createuser lamp_none identified by lamp_none;
grantcreatesession,createtable,create sequence,createview,resource to lamp_none;
# SQL Server
CREATEDATABASE lamp_none COLLATE Chinese_PRC_CI_AS;② 導(dǎo)入 sql腳本
向 lamp_none 庫導(dǎo)入 lamp_none.sql。
③ 修改 config/dev/mysql.yml
lamp:
# 修改1：數(shù)據(jù)庫連接基本信息， 三選一！??！三選一?。?！不是同時需要三種數(shù)據(jù)庫?。?！
oracle:&db-oracle
db-type: oracle
validation-query: SELECT 'x' FROM DUAL
filters: stat,wall # druid不支持使用p6spy打印日志，所以采用druid 的 slf4j 過濾器來打印可執(zhí)行日志
username:'lamp_none'
password:'lamp_none'
driverClassName: oracle.jdbc.driver.OracleDriver
url: jdbc:oracle:thin:@172.26.3.67:1521:helowin
mysql:&db-mysql
db-type: mysql
validation-query: SELECT 'x'
filters: stat,wall
username:'root'
password:'root'
driverClassName: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://127.0.0.1:3306/lamp_none?serverTimeznotallow=Asia/Shanghai&characterEncoding=utf8&useUnicode=true&useSSL=false&autoRecnotallow=true&zeroDateTimeBehavior=convertToNull&allowMultiQueries=true&nullCatalogMeansCurrent=true
sqlserver:&db-sqlserver
username:'sa'
password:'1234@abcd'
driverClassName: com.microsoft.sqlserver.jdbc.SQLServerDriver
url: jdbc:sqlserver://172.26.3.67:1433;DatabaseName=lamp_none
db-type: sqlserver
validation-query: SELECT 'x'
filters: stat,wall
init:
separator: GO④ 修改 config/dev/redis.yml
lamp:
cache:
type: REDIS
serializerType: jack_son
redis:
ip: 127.0.0.1
port:16379
password:'SbtyMveYNfLzTks7H0apCmyStPzWJqjy'
database:0⑤ 修改數(shù)據(jù)庫驅(qū)動： 根據(jù)使用的數(shù)據(jù)庫，修改 lamp-public/lamp-database-mode/pom.xml 中的驅(qū)動依賴
<!-- mysql 驅(qū)動 -->
<dependency>
<groupId>com.mysql</groupId>
<artifactId>mysql-connector-j</artifactId>
</dependency>⑥ 修改常量類 Condition.java
publicclassCondition{
/** MySQL、SQL Server 數(shù)據(jù)庫的 模糊查詢 */
publicstaticfinalStringLIKE=SqlCondition.LIKE;
// /** ORACLE 數(shù)據(jù)庫的 模糊查詢 */
// public static final String LIKE = SqlCondition.ORACLE_LIKE;
}⑦ 修改bootstrap.yml
logging.file.path： 日志存放的絕對路徑
logging:
file:
#日志存放的絕對路徑 生產(chǎn)環(huán)境，建議修改為絕對路徑
path: ./logs⑧ 編譯項目, 參考 項目導(dǎo)入 將 lamp-boot 和 lamp-util 同時導(dǎo)入到一個IDEA工作空間, 然后使用 maven 編譯項目
(2) 啟動項目
- 先確保nacos、MySQL、Redis、Seata、 RabbitMQ(可選)、等基礎(chǔ)服務(wù)是否啟動成功
- 啟動: BootServerApplication
(3) 驗證是否啟動成功
(4) 訪問以下地址, 能看到Swagger文檔
http://127.0.0.1:18760/doc.html
2. 前端啟動
(1) 環(huán)境要求Node.js
- 版本大于 20.2.0pnpm
- 包管理工具.
(2) 下載源碼
# 使git對文件名大小寫敏感
git config core.ignorecase false
# 拉取項目代碼
git clone https://gitee.com/zuihou111/lamp-web.git
cd lamp-web
# 切換分支
git checkout 5.x
# 安裝依賴
pnpminstall--registry=https://registry.npmmirror.com(3) 修改配置
- 根據(jù)自己的需求修改 .env.developmentopen in new window 文件，VITE_PROXY 參數(shù)改成跟后端對應(yīng)的模式
- 根據(jù)后端啟動的方式，只需要修改 target 參數(shù)，其他參數(shù)不需要修改。
- 單體版：配置為后端BootServerApplication類啟動后的端口
- 微服務(wù)版：配置為后端GatewayServerApplication類啟動后的端口
# 本地啟動時，代理地址
VITE_PROXY=`{
"cloud":[{
"proxyKey":"/api",
"rewriteBefore":"/api",
"rewriteAfter":"/api",
"target":"http://localhost:18760"
}],
"boot":[{
"proxyKey":"/api/gateway",
"rewriteBefore":"/api/gateway",
"rewriteAfter":"/gateway",
"target":"http://localhost:18760"
},{
"proxyKey":"/api",
"rewriteBefore":"/api/[A-Za-z0-9]+",
"rewriteAfter":"",
"target":"http://localhost:18760"
}]
}(4) 啟動
啟動命令需要區(qū)分后端啟動的是單體模式還是微服務(wù)模式。
