基本配置

开发环境

后端环境

工具	版本要求	说明
JDK	17+	Spring Boot 3.x 要求
Maven	3.6.3+	项目构建工具
IntelliJ IDEA	2022+	推荐IDE
Git	2.x	版本控制

JDK安装

推荐使用Amazon Corretto或Temurin：

# macOS (Homebrew)
brew install --cask temurin17

# 验证安装
java -version

Maven配置

配置私服地址以下载平台依赖：

<!-- settings.xml -->
<mirrors>
    <mirror>
        <id>netwisd</id>
        <mirrorOf>*</mirrorOf>
        <url>http://192.168.0.110:8081/repository/maven-public/</url>
    </mirror>
</mirrors>

详见： Maven配置

前端环境

工具	版本要求	说明
Node.js	16+	运行环境
pnpm	8+	包管理器（推荐）
VS Code	最新版	推荐IDE

Node.js安装

# macOS (Homebrew)
brew install node@18

# 安装pnpm
npm install -g pnpm

# 验证安装
node -v
pnpm -v

VS Code插件推荐

Vue - Official
TypeScript Vue Plugin
ESLint
Prettier

中间件

参考【平台启动】中的【中间件】

必需中间件

中间件	版本	端口	说明
Nacos	2.x	8848	服务注册与配置中心
MySQL	8.0.31+	3306	主数据库
Redis	7.x	6379	缓存

可选中间件

中间件	版本	端口	说明
ElasticSearch	7.9.1	9200	全文搜索（日志需要）
RocketMQ	4.9.3+	9876	消息队列
MinIO	6.0.11+	9000	文件存储
Seata	1.4.2+	8091	分布式事务（工作流需要）

环境变量

中间件启动完成后，需要配置环境变量。

必需环境变量

# Nacos配置
export INCLOUD_NACOS_SERVICE_HOST=127.0.0.1
export INCLOUD_NACOS_SERVICE_PORT=8848
export INCLOUD_NACOS_NAMESPACE=public

# 数据库配置
export INCLOUD_MYSQL_SERVICE_HOST=127.0.0.1
export INCLOUD_MYSQL_SERVICE_PORT=3306
export INCLOUD_DB_USER=root
export INCLOUD_DB_PWD=123456
export INCLOUD_DB_SCHEMA=incloud5
export INCLOUD_DB_DATABASE=incloud5

# Redis配置
export INCLOUD_REDIS_SERVICE_HOST=127.0.0.1
export INCLOUD_REDIS_SERVICE_PORT=6379
export INCLOUD_REDIS_PWD=

# 网关配置
export INCLOUD_BASE_GATEWAY_SERVICE_HOST=127.0.0.1
export INCLOUD_BASE_GATEWAY_SERVICE_PORT=8000

详见：环境变量

初始化数据

参考【平台启动】中的【初始化数据】

快速初始化

导入数据库

mysql -u root -p incloud5 < incloud5_init_mysql.sql

导入Nacos配置
- 登录Nacos控制台
- 导入配置包 incloud5_nacos.zip

启动平台基础服务

参考【平台启动】中的【使用Docker快速启动】

验证环境

环境配置完成后，验证各服务状态：

服务	验证地址
Nacos	http://localhost:8848/nacos
网关	http://localhost:8000
主服务	http://localhost:8001/doc.html
前端	http://localhost:3000

下一步

环境配置完成后，继续创建应用。

25 十一月 2025