Skip to content

环境要求总览

在安装 Forge Admin 之前,请确保你的开发环境满足以下要求。

总体要求一览

组件最低版本用途是否必须
操作系统macOS / Windows / Linux开发/运行环境
JDK17后端编译与运行
Maven3.8+后端依赖管理与构建
Node.js20+前端构建工具链
pnpm8+前端包管理
MySQL8.0+业务数据持久化
Redis6.0+缓存、Session、分布式锁

为什么需要这些组件

JDK 17 — 后端是 Spring Boot 3.5.13forge-server/pom.xml),最低 JDK 17。

Maven — 后端采用多模块 Maven 项目结构,Maven 负责依赖管理、编译和打包。forge-framework/forge-dependencies 提供统一的 BOM 版本管理。

Node.js 20 + pnpm — 前端是 Vite 8forge-admin-ui/package.json),用 Node 20 LTS。

MySQL 8.0 — 数据存储引擎,要求 utf8mb4 字符集、utf8mb4_0900_ai_ci 排序规则和 InnoDB 引擎。所有业务表包含 idtenant_idcreate_time 等标准字段。

Redis 6.0 — 提供多层缓存能力:接口缓存、数据缓存、会话管理(Sa-Token)、分布式锁(Redisson)。

下一步

根据你的操作系统,选择对应的安装指南: