Skip to content

环境要求总览 ​

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

总体要求一览 ​

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

为什么需要这些组件 ​

JDK 17 — 后端是 Spring Boot 4.1.1(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.19+、pnpm 8+(仓库根 packageManager 可能 pin 更高,如 pnpm 11)。Docker 镜像里的 Node/pnpm 以 docker-forge-admin/Dockerfile.ui 为准,不必与本地最低要求逐字相同。

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

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

下一步 ​

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