mirror of
https://gitcode.com/ageerle/ruoyi-ai.git
synced 2026-03-13 20:53:42 +08:00
222 lines
4.1 KiB
Markdown
222 lines
4.1 KiB
Markdown
## 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. 检查日志输出无异常。 |