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.13(forge-server/pom.xml),最低 JDK 17。

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

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

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

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

下一步 ​

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