在当前数字化转型加速的背景下，若依（RuoYi）作为一款基于Spring Boot + Vue的开源快速开发平台，因其简洁、高效和易扩展的特点，被广泛应用于中小型企业及高校项目的开发中。许多开发者在初次接触若依时，常常困惑于如何正确部署该项目——从环境准备到数据库配置，再到前后端联调，每一步都可能成为“拦路虎”。本文将带你全面梳理若依管理系统项目的完整部署流程，覆盖Linux与Windows双平台操作，并结合实际案例讲解常见问题解决方案。
一、部署前准备：环境检查与工具安装
在正式部署之前，确保你的开发环境已准备好以下关键组件：
- Java JDK 8或以上版本：若依基于Spring Boot框架，依赖Java运行时环境。建议使用JDK 11或JDK 17以获得更好的性能和安全性。
- MySQL数据库：推荐MySQL 5.7及以上版本，用于存储用户权限、菜单结构、日志等数据。
- Maven构建工具：用于编译和打包项目，若依项目采用Maven管理依赖，需提前安装并配置好环境变量。
- Node.js与npm：前端Vue项目依赖Node.js进行构建，建议安装Node.js v14.x或v16.x版本。
- IDEA / Eclipse / VS Code：用于代码编辑与调试，推荐使用IntelliJ IDEA提升开发效率。
特别提醒：如果是在服务器上部署，请确保防火墙开放必要端口（如8080、3306），并设置静态IP地址避免因网络变动导致服务异常。
二、下载与初始化若依项目源码
访问官方GitHub仓库：https://github.com/yangchenggang/ruoyi，点击Clone or download → Download ZIP获取最新稳定版压缩包。
解压后你会看到如下目录结构：
ruoyi/ ├── ruoyi-admin # 后端Spring Boot主项目 ├── ruoyi-framework # 公共模块（如工具类、拦截器） ├── ruoyi-common # 常用组件封装 ├── ruoyi-ui # 前端Vue项目（需单独构建） └── pom.xml # Maven主配置文件
注意：若你打算使用最新的RuoYi-Vue分支（即前后端分离架构），请务必选择该分支而非默认的单体应用分支。
三、配置后端项目：ruoyi-admin
进入ruoyi-admin目录，打开application.yml文件，修改数据库连接信息：
# 数据库配置
spring:
datasource:
url: jdbc:mysql://localhost:3306/ruoyi?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&allowMultiQueries=true
username: root
password: your_password
driver-class-name: com.mysql.cj.jdbc.Driver
同时，确认MySQL中已创建名为ruoyi的数据库，并导入初始SQL脚本（位于ruoyi-admin/src/main/resources/sql/ruoyi.sql）。执行命令：
mysql -u root -p < ruoyi.sql
此时数据库表结构已建立完毕，包括用户表、角色表、菜单权限等基础数据。
四、构建并运行后端服务
在ruoyi-admin目录下执行：
mvn clean package -Dmaven.test.skip=true
该命令会清理旧缓存并打包成jar文件，输出路径为target/ruoyi-admin.jar。
然后运行：
java -jar target/ruoyi-admin.jar
启动成功后，浏览器访问http://localhost:8080即可看到登录页面，默认账号密码为：admin / admin123。
五、配置前端项目：ruoyi-ui
进入ruoyi-ui目录，安装依赖：
npm install
接着修改src/config/index.js中的API接口地址：
// api地址 const baseURL = process.env.NODE_ENV === 'development' ? 'http://localhost:8080' : 'https://yourdomain.com';
如果是生产环境，请替换为真实域名或服务器IP。
六、构建前端静态资源
执行以下命令生成dist目录下的静态文件：
npm run build
此步骤会将Vue组件编译为HTML、CSS、JS文件，供Nginx或Apache托管。
七、部署到Linux服务器（推荐方式）
假设你有一台CentOS 7+服务器，可按如下步骤部署：
- 上传
ruoyi-admin.jar和dist目录到服务器指定路径（如/opt/ruoyi）。 - 安装JDK与MySQL（若未安装）：
- 配置MySQL远程访问权限：
- 启动后端服务：
- 配置Nginx反向代理（推荐）：
yum install java-1.8.0-openjdk-devel mysql-server
GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY 'your_password'; FLUSH PRIVILEGES;
nohup java -jar /opt/ruoyi/ruoyi-admin.jar > nohup.out 2>&1 &
location / {
root /opt/ruoyi/dist;
index index.html;
try_files $uri $uri/ /index.html;
}
location /api {
proxy_pass http://localhost:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
重启Nginx后，访问服务器IP即可直接访问前端界面，所有API请求由Nginx转发至后端Java服务。
八、常见问题排查与优化建议
- 数据库连接失败：检查MySQL是否开启远程访问，防火墙是否放行3306端口。
- 前端无法加载资源：确认Nginx配置中
root路径正确，且dist目录存在。 - 跨域问题：若前端与后端不在同一域名下，可在后端添加CORS配置（详见
ruoyi-admin/src/main/java/com/ruoyi/framework/config/CorsConfig.java）。 - 内存溢出：调整Java启动参数，例如：
-Xms512m -Xmx2g。
对于高并发场景，建议引入Redis缓存用户会话、Elasticsearch实现全文搜索等功能，进一步提升系统性能。
九、自动化部署方案：Docker + Jenkins
如果你希望实现CI/CD自动化部署，可以考虑使用Docker容器化技术：
# Dockerfile示例（后端） FROM openjdk:11-jre-slim COPY target/ruoyi-admin.jar app.jar EXPOSE 8080 ENTRYPOINT ["java","-jar","/app.jar"]
配合Jenkins定时拉取Git代码、构建镜像、推送至远程服务器，极大提高部署效率与稳定性。
此外，蓝燕云提供了一站式云开发环境，支持一键部署若依项目，无需手动配置环境，非常适合新手快速上手！立即免费试用蓝燕云，体验真正的开箱即用开发体验。