ruoyi-ai/docs/RuoYi-AI 后端部署教程（Docker 部署版）.md

RuoYi-AI 后端部署教程（Docker 部署版）

一、前置条件

在部署前，请确保系统已满足以下条件：

✅ 系统环境要求

• 操作系统：Linux / MacOS（推荐 Linux 服务器）
• CPU：4 核以上
• 内存：≥ 4GB
• 磁盘空间：≥ 10GB（建议 20GB+）

✅ 已安装软件

• Docker
• Docker Compose

验证命令是否可用：

docker -v
docker compose version

若无输出或提示“command not found”，请先安装 Docker 及 Compose。

---

二、目录结构配置

1️⃣ 创建部署目录

在目标服务器执行以下命令：

# 第一级目录
mkdir /ruoyi-ai
cd /ruoyi-ai

# 第二级目录
mkdir deploy
cd deploy

# 第三级目录
mkdir data mysql-init

# 第四级目录
mkdir logs minio minio-config mysql redis weaviate

💡 data 目录用于挂载容器运行期间生成的数据文件。

最终目录结构示例：

/ruoyi-ai
 └── deploy
     ├── data/
     ├── mysql-init/
     ├── logs/
     ├── minio/
     ├── minio-config/
     ├── mysql/
     ├── redis/
     ├── weaviate/

---

三、上传配置文件

将以下配置文件上传到 /ruoyi-ai/deploy 目录：

• docker-compose.yaml
• .env
• ruoyi-ai.sql
• Dockerfile

📂 这些文件在项目目录 /script/deploy/deploy 下。 上传后请检查文件路径是否与上方目录结构一致。

---

四、构建 Jar 包

1. 打开 IDEA 或其他构建工具
2. 选择 Maven 构建配置，勾选 prod 环境，取消 dev 环境
3. 点击 package 进行打包
4. 注意： 在构建前请将 application-prod.yml 拖入 ruoyi-admin/src/main/resources 目录中

构建完成后会在：

ruoyi-admin/target/ruoyi-admin.jar

生成打包文件。

---

五、上传 Jar 包至服务器

将生成的 ruoyi-admin.jar 上传到服务器 /ruoyi-ai/deploy 目录下。 确保与 Dockerfile 同目录。

---

六、构建 Docker 镜像

Dockerfile 内容如下：

FROM openjdk:17-jdk

RUN mkdir -p /ruoyi/server/logs \
    /ruoyi/server/temp

WORKDIR /ruoyi/server
COPY ruoyi-admin.jar ruoyi-admin.jar

ENTRYPOINT ["java","-jar","ruoyi-admin.jar"]

在 /ruoyi-ai/deploy 目录执行以下命令：

# 构建镜像
docker build -t ruoyi-ai-backend:v20251013 .

# 查看镜像是否构建成功
docker image ls

然后在 docker-compose.yaml 文件中，将对应服务的镜像名修改为：

image: ruoyi-ai-backend:v20251013

---

七、启动容器服务

在启动前请确认：

• .env 中端口号、数据库密码、环境变量已正确配置
• docker-compose.yaml 中 MySQL 的端口已开放（用于导入数据）

如示例：

ports:
  - "3306:3306"

启动命令：

cd /ruoyi-ai/deploy
docker compose up -d

查看运行状态：

docker compose ps

查看日志：

docker logs -f <容器名称>

⚠️ 初次启动时可仅运行 ruoyi-admin（后端）模块，将前端 ruoyi-web 服务暂时注释，确认后端服务正常后再启用前端容器。

---

八、数据库初始化

启动 MySQL 容器后，执行以下操作：

docker exec -it <mysql_container_name> bash
mysql -uroot -p
source /docker-entrypoint-initdb.d/ruoyi-ai.sql;

或手动在客户端中导入 /ruoyi-ai/deploy/ruoyi-ai.sql 文件。

---

九、常用 Docker 命令

功能	命令
查看容器状态	docker ps -a
查看日志	docker logs -f <容器名>
停止服务	docker compose down
重启服务	docker compose restart
重新构建镜像	docker compose build --no-cache
清理无用镜像/容器	docker system prune -a

---

🔍 十、部署验证

1. 检查容器是否全部启动成功：

   docker compose ps
   

2. 访问后端接口：

   http://<服务器IP>:<后端端口>
   

3. 检查日志输出无异常。