环境准备

本文档详细介绍 MolanDev Cloud 的环境搭建,包括中间件安装、数据库初始化、微服务模式配置等。

💡 快速开始

如果你只是想快速在本地跑起来,请先阅读 5 分钟快速开始。

环境要求

必须安装的软件

软件	版本	下载地址	说明
JDK	17+	Oracle	后端运行环境
Maven	3.6+	Apache Maven	后端构建工具
Node.js	16+	Node.js	前端运行环境
IntelliJ IDEA	2023+	JetBrains	开发 IDE(社区版即可)

中间件(二选一)

方式一:Docker(推荐)

软件	版本	说明
Docker Desktop	Latest	Docker

方式二:手动安装

软件	版本	说明	单体模式必需
MySQL	8.0+	数据库	✅ 是
Redis	6.0+	缓存	✅ 是
RabbitMQ	3.12+	消息队列	❌ 否(微服务需要)
Nacos	2.3+	配置中心	❌ 否(微服务需要)

方式一:使用 Docker 启动(推荐)

1. 启动所有中间件

bash

# 进入 middleware 目录
cd molandev-backend/deploy/middleware

# 启动所有中间件
docker compose up -d

# 查看启动状态
docker compose ps

2. 已启动的服务

服务	端口	说明	单体模式必需
MySQL	3306	数据库	✅ 是
Redis	6379	缓存	✅ 是
RabbitMQ	5672, 15672	消息队列	❌ 否(微服务需要)
Nacos	8848	配置中心	❌ 否(微服务需要)
MinIO	9000, 9001	对象存储	❌ 否(可选)

🔑 默认密码

MySQL root 密码: 123456
Redis 密码: 123456
RabbitMQ: 用户名 molandev / 密码见 .env 文件

如需修改,编辑 deploy/middleware/.env 文件。

3. 验证服务

bash

# 测试 MySQL
docker exec -it mysql mysql -uroot -p123456 -e "SELECT 1"

# 测试 Redis
docker exec -it redis redis-cli -a 123456 ping
# 应返回: PONG

# 测试 RabbitMQ(微服务需要)
docker exec -it rabbitmq rabbitmqctl status

4. 常用 Docker 命令

bash

# 查看日志
docker compose logs -f mysql
docker compose logs -f redis

# 停止所有服务
docker compose stop

# 重启所有服务
docker compose restart

# 停止并删除容器(数据保留)
docker compose down

方式二:手动安装中间件

点击展开手动安装步骤

如果你不想使用 Docker,需要手动安装 MySQL 和 Redis。

安装 MySQL

下载并安装 MySQL 8.0+
启动 MySQL 服务

Windows:

打开"服务"管理器,启动 MySQL80

macOS:

bash

mysql.server start

Linux:

bash

sudo systemctl start mysql

安装 Redis

下载并安装 Redis 6.0+
启动 Redis 服务

Windows:

打开"服务"管理器,启动 Redis

macOS:

bash

brew services start redis

Linux:

bash

sudo systemctl start redis

验证服务

bash

# MySQL
mysql -u root -p

# Redis
redis-cli ping  # 应返回 PONG

初始化数据库

1. 创建数据库

本项目使用多数据源,需要创建 2 个数据库:

sql

-- 系统数据库
CREATE DATABASE IF NOT EXISTS `molandev_sys`
  DEFAULT CHARACTER SET utf8mb4
  COLLATE utf8mb4_unicode_ci;

-- 消息数据库
CREATE DATABASE IF NOT EXISTS `molandev_msg`
  DEFAULT CHARACTER SET utf8mb4
  COLLATE utf8mb4_unicode_ci;

2. 导入初始化数据

在 deploy/sql/ 目录下找到初始化 SQL 文件:

deploy/sql/
├── molandev_sys.sql    # 系统库初始化脚本
└── molandev_msg.sql    # 消息库初始化脚本

导入方式:

Navicat:

右键数据库 → 运行 SQL 文件
选择对应的 .sql 文件

MySQL Workbench:

File → Run SQL Script
选择对应的 .sql 文件

命令行:

bash

mysql -u root -p molandev_sys < deploy/sql/molandev_sys.sql
mysql -u root -p molandev_msg < deploy/sql/molandev_msg.sql

配置后端

找到配置文件

molandev-backend/molandev-standalone-service/src/main/resources/application-local.yml

修改数据库配置

yaml

molandev:
  datasource:
    sys:  # 系统数据库
      url: jdbc:mysql://localhost:3306/molandev_sys?characterEncoding=UTF-8&useSSL=false&serverTimezone=GMT%2B8
      username: root
      password: 你的MySQL密码  # 请修改
      driver-class-name: com.mysql.cj.jdbc.Driver
      primary: true
      packages:
        - com.molandev.base
        - com.molandev.knowledge
    
    msg:  # 消息数据库
      url: jdbc:mysql://localhost:3306/molandev_msg?characterEncoding=UTF-8&useSSL=false&serverTimezone=GMT%2B8
      username: root
      password: 你的MySQL密码  # 请修改
      driver-class-name: com.mysql.cj.jdbc.Driver
      packages:
        - com.molandev.base.msg

修改 Redis 配置

yaml

spring:
  data:
    redis:
      host: 127.0.0.1
      port: 6379
      password: 你的Redis密码  # 如果没设置密码则删除这行
      database: 0

修改文件存储路径

yaml

molandev:
  file:
    local:
      base-path: D:/dev/molan/file/  # Windows 路径
      # 或 /Users/yourname/dev/molan/file/  # macOS/Linux

微服务模式配置

👀 高级内容

以下内容面向需要开发微服务模式的开发者,如果你刚开始学习,可以跳过这部分。

1. 额外需要的中间件

微服务模式需要额外的中间件:

中间件	端口	用途
RabbitMQ	5672, 15672	消息队列(事件总线)
Nacos	8848	配置中心+服务注册

好消息: 这些服务已经在 deploy/middleware/docker-compose.yml 中配置好了,启动 Docker 时已经一起启动了!

2. 配置 Nacos

登录 Nacos 控制台

打开浏览器访问: http://localhost:8848/nacos
用户名: nacos, 密码: nacos

创建命名空间

点击左侧菜单 命名空间
点击 新建命名空间
命名空间ID: molandev_local
点击 确定

导入配置文件

在 deploy/configs/ 目录下已准备好所有配置文件:

deploy/configs/
├── common-rabbitmq.yml      # RabbitMQ 公共配置
├── molandev-base.yml        # 基础服务配置
├── molandev-knowledge.yml   # 知识库服务配置
├── molandev-xiuxian.yml     # AI 修仙服务配置

导入步骤:

点击 配置管理 → 配置列表
确认命名空间为 molandev_local
点击 导入配置,选择 deploy/configs/ 下的所有 .yml 文件
点击 上传 并 导入

3. 修改运行模式

在各个服务的配置文件中,将 run-mode 从 single 改为 cloud:

yaml

# molandev-base/src/main/resources/application-local.yml
molandev:
  run-mode: cloud  # 修改为 cloud

4. 启动顺序

微服务模式需要启动多个服务:

Gateway (8080) - molandev-gateway
Base Service (8081) - molandev-base
Knowledge Service (8082) - molandev-knowledge
Xiuxian Service (8083) - molandev-xiuxian

5. 验证服务注册

打开 Nacos 控制台: http://localhost:8848/nacos

点击 服务管理 → 服务列表
切换命名空间为 molandev_local
应该能看到: molandev-base, molandev-knowledge, molandev-xiuxian, gateway

6. 访问系统

微服务模式下,所有请求都通过 Gateway 转发:

前端访问: http://localhost:5173
后端 API: http://localhost:8080 (Gateway 统一入口)

常见问题

1. 后端启动失败:数据库连接错误

错误信息:

Communications link failure

解决方案:

检查 MySQL 是否启动
检查用户名密码是否正确
检查数据库是否已创建: SHOW DATABASES;
检查端口是否正确(默认 3306)

2. 后端启动失败:Redis 连接错误

错误信息:

Unable to connect to Redis

解决方案:

检查 Redis 是否启动: redis-cli ping (应返回 PONG)
检查配置文件中的 Redis 地址和端口
如果有密码,检查密码是否正确

3. 端口占用

错误信息:

Port 9099 was already in use.

解决方案:

修改 application-local.yml 中的 server.port 为其他端口。

4. Nacos 连接失败

错误信息:

Can not find Nacos

解决方案:

检查 Nacos 是否启动: docker ps | grep nacos
访问 Nacos 控制台确认服务可用
检查配置中的 server-addr 是否正确

5. 配置加载失败

错误信息:

Can not load config from Nacos

解决方案:

检查命名空间 molandev_local 是否已创建
检查配置文件是否已导入 Nacos
确认 Data ID 和 Group 配置正确

6. Maven 依赖下载失败

解决方案:

项目 pom.xml 中已配置阿里云镜像源,首次编译会自动从阿里云下载依赖。

如果下载缓慢,请检查网络连接,或在 IDEA 中右键项目 → Maven → Reload project。

下一步

快速开始 - 5 分钟跑起来
架构概览 - 了解系统设计
部署指南 - 生产环境部署

环境准备 ​

环境要求 ​

必须安装的软件 ​

中间件(二选一) ​

方式一:使用 Docker 启动(推荐) ​

1. 启动所有中间件 ​

2. 已启动的服务 ​

3. 验证服务 ​

4. 常用 Docker 命令 ​

方式二:手动安装中间件 ​

安装 MySQL ​

安装 Redis ​

验证服务 ​

初始化数据库 ​

1. 创建数据库 ​

2. 导入初始化数据 ​

配置后端 ​

找到配置文件 ​

修改数据库配置 ​

修改 Redis 配置 ​

修改文件存储路径 ​

微服务模式配置 ​

1. 额外需要的中间件 ​

2. 配置 Nacos ​

登录 Nacos 控制台 ​

创建命名空间 ​

导入配置文件 ​

3. 修改运行模式 ​

4. 启动顺序 ​

5. 验证服务注册 ​

6. 访问系统 ​

常见问题 ​

1. 后端启动失败:数据库连接错误 ​

2. 后端启动失败:Redis 连接错误 ​

3. 端口占用 ​

4. Nacos 连接失败 ​

5. 配置加载失败 ​

6. Maven 依赖下载失败 ​

下一步 ​

环境准备

环境要求

必须安装的软件

中间件(二选一)

方式一:使用 Docker 启动(推荐)

1. 启动所有中间件

2. 已启动的服务

3. 验证服务

4. 常用 Docker 命令

方式二:手动安装中间件

安装 MySQL

安装 Redis

验证服务

初始化数据库

1. 创建数据库

2. 导入初始化数据

配置后端

找到配置文件

修改数据库配置

修改 Redis 配置

修改文件存储路径

微服务模式配置

1. 额外需要的中间件

2. 配置 Nacos

登录 Nacos 控制台

创建命名空间

导入配置文件

3. 修改运行模式

4. 启动顺序

5. 验证服务注册

6. 访问系统

常见问题

1. 后端启动失败:数据库连接错误

2. 后端启动失败:Redis 连接错误

3. 端口占用

4. Nacos 连接失败

5. 配置加载失败

6. Maven 依赖下载失败

下一步