环境准备

本文档详细介绍 Molan Cloud 的环境搭建。

快速开始

如果只想快速跑起来，请先阅读 快速开始。

---

环境要求

软件	版本	说明
JDK	21+	后端运行环境
Maven	3.9+	后端构建工具
IntelliJ IDEA	2023+	开发 IDE（社区版即可）
Docker Desktop	Latest	推荐：一键启动中间件

---

Docker 启动中间件（推荐）

一键启动

cd backend/deploy/docker
./manage.sh start-mw

服务列表

服务	容器名	端口	单体必需	微服务必需
MySQL	mysql	3306	✅	✅
Redis	redis	6379	✅	✅
MinIO	minio	9000, 9001	❌	✅
Elasticsearch	elasticsearch	9200	❌	✅（knowledge）
Milvus	milvus-standalone	19530	❌	✅（knowledge）
Nacos	nacos-standalone	8848, 9848	❌	✅
RabbitMQ	rabbitmq	5672, 15672	❌	✅

默认密码

• MySQL: root / 123456
• PostgreSQL: postgres / postgres
• Redis: 123456
• MinIO: molandev / molandev

如需修改，编辑各中间件目录下的 docker-compose.yml。

单体模式最小中间件

使用 PostgreSQL profile 只需 PostgreSQL + Redis：

cd backend/deploy/docker/redis && docker compose up -d

PostgreSQL 需单独安装或使用 Docker：

# 示例：使用 pgvector 镜像
docker run -d --name pgvector -p 5432:5432 \
  -e POSTGRES_PASSWORD=postgres \
  pgvector/pgvector:pg17

验证服务

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

# Redis
docker exec -it redis redis-cli -a 123456 ping

---

手动安装中间件

点击展开

MySQL 8.0+

# macOS
brew install mysql
brew services start mysql

# Linux
sudo systemctl start mysql

PostgreSQL 14+

# macOS
brew install postgresql@17
brew services start postgresql@17

# Linux
sudo systemctl start postgresql

Redis 6.0+

# macOS
brew install redis
brew services start redis

# Linux
sudo systemctl start redis

---

初始化数据库

项目使用多数据源，需创建 3 个数据库：molandev_base、molandev_kl、molandev_xiuxian。

MySQL

mysql -u root -p123456 < backend/deploy/sql/mysql/01_schema.sql
mysql -u root -p123456 molandev_base < backend/deploy/sql/mysql/02_molandev_base.sql
mysql -u root -p123456 molandev_kl < backend/deploy/sql/mysql/03_molandev_kl.sql
mysql -u root -p123456 molandev_xiuxian < backend/deploy/sql/mysql/04_molandev_xiuxian.sql

PostgreSQL

psql -U postgres -f backend/deploy/sql/postgres/01_schema.sql
psql -U postgres -d molandev_base -f backend/deploy/sql/postgres/02_molandev_base.sql
psql -U postgres -d molandev_kl -f backend/deploy/sql/postgres/03_molandev_kl.sql
psql -U postgres -d molandev_xiuxian -f backend/deploy/sql/postgres/04_molandev_xiuxian.sql

---

配置后端

单体模式核心配置文件：backend/molandev-standalone-service/src/main/resources/application.yml

数据库（application-mysql.yml / application-pg.yml）

molandev:
  datasource:
    sys:
      url: jdbc:mysql://localhost:3306/molandev_base?...
      username: root
      password: 123456

    knowledge:
      url: jdbc:mysql://localhost:3306/molandev_kl?...
      username: root
      password: 123456

    xiuxian:
      url: jdbc:mysql://localhost:3306/molandev_xiuxian?...
      username: root
      password: 123456

Redis（application.yml）

spring:
  data:
    redis:
      host: 127.0.0.1
      port: 6379
      password: 123456

AI API Key（application.yml）

spring:
  ai:
    openai:
      api-key: ${DASHSCOPE_API_KEY:123456}

可通过环境变量注入：export DASHSCOPE_API_KEY=sk-xxx

---

微服务模式配置

额外中间件

微服务模式还需要 Nacos、RabbitMQ、MinIO、Elasticsearch、Milvus，已包含在 ./manage.sh start-mw 中。

导入 Nacos 配置

1. 访问 http://localhost:8848/nacos（nacos/nacos）
2. 创建命名空间 molandev_cloud
3. 导入 backend/deploy/cloud/nacos-configs-cloud/ 下的配置文件：

Data ID	文件
molandev-gateway.yml	nacos-configs-cloud/molandev-gateway.yml
molandev-base.yml	nacos-configs-cloud/molandev-base.yml
molandev-knowledge.yml	nacos-configs-cloud/molandev-knowledge.yml
molandev-xiuxian.yml	nacos-configs-cloud/molandev-xiuxian.yml

启动顺序

1. Gateway（9090）
2. Base（19091）
3. Knowledge（19092）
4. Xiuxian（19093）

验证

Nacos 控制台 → 服务列表 → 命名空间 molandev_cloud，应看到 4 个服务注册。