应用部署

版本要求复制标题链接

适用于 >= 4.3.0。

前置阅读复制标题链接

请优先阅读 IntelliJ IDEA 环境配置。

部署方式选择复制标题链接

• 手动部署：适合已有基础设施的服务器
• Docker 部署：适合快速搭建与统一运维

手动部署复制标题链接

1. 安装基础服务复制标题链接

安装 MySQL、Redis、Nginx、MinIO。

2. 准备配置文件复制标题链接

将项目内配置复制到服务目录并按需修改：

• script/docker/nginx/nginx.conf
• script/docker/redis/redis.conf

重点修改：前端静态文件路径、后端服务地址等。

3. 打包后端复制标题链接

mvn clean package -D maven.test.skip=true -P prod

4. 创建临时文件目录复制标题链接

服务端需要创建临时文件存储目录，路径需与配置文件一致。
否则可能出现上传失败等问题。

5. 启动后端服务复制标题链接

按实际部署方式启动生成的 jar 文件。

部署视频复制标题链接

RuoYi-Vue-Plus 5.0 生产环境搭建部署

Docker 后端部署复制标题链接

1. 安装 Docker 与 Compose复制标题链接

请优先阅读 idea环境配置

• docker安装
• docker-compose安装
• docker网络模式讲解
• docker 开启端口 2375 供外部程序访问

2. 上传配置到服务器复制标题链接

推荐使用 IDEA 的远程上传功能，将配置文件上传到服务器根目录。

3. 配置目录权限复制标题链接

确保 /docker 及其子目录具有写权限。
权限不足会导致容器读写异常。

chmod -R 777 /docker

4. 构建应用镜像复制标题链接

先使用 Maven 打包生成 jar，再执行镜像构建。

项目初始化后会自动生成构建镜像的运行配置，连接 Docker 后直接运行即可。
注意：IDEA 2024 及以上版本要求本地安装 Docker。

结构讲解 右键编辑 即可看到内部配置

5. 启动基础服务复制标题链接

docker-compose up -d mysql nginx-web redis minio

6. 启动业务服务复制标题链接

4.X：

docker-compose up -d ruoyi-monitor-admin ruoyi-xxl-job-admin ruoyi-server1 ruoyi-server2

5.X：

docker-compose up -d ruoyi-monitor-admin ruoyi-snailjob-server ruoyi-server1 ruoyi-server2

7. Docker 常用操作复制标题链接

前端部署复制标题链接

1. 构建前端复制标题链接

npm run build:prod

2. 上传静态资源复制标题链接

构建后产物位于 ruoyi-ui/dist。
将 dist 目录内文件（不含 dist 本身）上传到 docker/nginx/html（或手动部署的静态目录）。

3. 重启 Nginx复制标题链接

配置更新后重启 Nginx 使配置生效。

修改代理路径或后端地址复制标题链接

如需变更后端代理路径或后端地址，请同时修改以下配置：

• nginx.conf 中的代理路径（注意 / 开头与结尾）
• 前端 .env.* 文件内的 VITE_APP_BASE_API
• nginx.conf 中的后端 IP 地址