1. RuoYi-Vue分离版部署概述RuoYi-Vue作为国内广泛使用的开源管理系统框架其前后端分离架构在实际开发中具有显著优势。Windows环境下的完整部署涉及多个关键环节需要系统性地完成环境准备、依赖安装、配置调整和启动验证。本指南将基于最新稳定版本详细说明从零开始完成部署的全过程。2. 环境准备与工具安装2.1 基础软件要求部署前需确保Windows系统满足以下条件操作系统Windows 10/11 64位或Windows Server 2016内存建议8GB以上最低4GB磁盘空间至少20GB可用空间2.2 必要工具安装JDK 1.8推荐使用Oracle JDK 8u321或OpenJDK 11安装后需配置JAVA_HOME环境变量验证命令java -versionMaven 3.6下载二进制包解压至指定目录配置MAVEN_HOME并添加至PATH验证命令mvn -vNode.js 14建议安装LTS版本如16.15.0包含npm包管理器验证命令node -v和npm -vMySQL 5.7推荐使用MySQL 8.0.28社区版安装时需设置root密码并记住安装MySQL Workbench便于管理Redis 5.0Windows版可直接下载.msi安装包安装后设置为系统服务自动启动验证命令redis-cli ping3. 后端部署流程3.1 项目获取与配置克隆项目仓库git clone https://gitee.com/y_project/RuoYi-Vue.git导入IDE推荐IntelliJ IDEA选择File → Open → 选中pom.xml等待Maven自动下载依赖约5-10分钟数据库初始化创建数据库ry-vue执行sql/ry_20230214.sql初始化表结构执行sql/quartz.sql初始化定时任务修改配置文件# application.yml spring: datasource: url: jdbc:mysql://localhost:3306/ry-vue?useSSLfalse username: root password: 你的密码3.2 编译与启动执行Maven打包mvn clean package -DskipTests启动后端服务java -jar ruoyi-admin/target/ruoyi-admin.jar验证启动访问http://localhost:8080应看到Swagger API文档页面4. 前端部署流程4.1 环境准备安装依赖cd ruoyi-ui npm install --registryhttps://registry.npmmirror.com修改配置// .env.development VUE_APP_BASE_API http://localhost:80804.2 开发模式运行启动前端服务npm run dev验证访问浏览器打开http://localhost:80应看到登录页面4.3 生产环境打包构建生产包npm run build:prod部署到Nginx将dist目录内容复制到Nginx html目录配置nginx.confserver { listen 80; server_name localhost; location / { root html; index index.html; } location /prod-api/ { proxy_pass http://localhost:8080/; } }5. 常见问题解决方案5.1 端口冲突处理查看占用端口netstat -ano | findstr 8080解决方案修改后端server.port配置或终止占用进程taskkill /PID 进程号 /F5.2 数据库连接失败检查项MySQL服务是否启动用户名密码是否正确数据库名是否匹配解决方案GRANT ALL PRIVILEGES ON *.* TO root% IDENTIFIED BY 密码; FLUSH PRIVILEGES;5.3 前端跨域问题开发环境解决方案// vue.config.js devServer: { proxy: { /api: { target: http://localhost:8080, changeOrigin: true, pathRewrite: { ^/api: } } } }生产环境解决方案确保Nginx反向代理配置正确检查请求URL是否包含/prod-api前缀6. 系统优化建议6.1 性能调优JVM参数调整java -Xms512m -Xmx1024m -jar ruoyi-admin.jarRedis缓存优化spring: redis: database: 0 host: localhost port: 6379 password: timeout: 3000 lettuce: pool: max-active: 20 max-wait: -16.2 安全加固修改默认密码修改application.yml中的默认密码更新MySQL root密码启用HTTPS申请SSL证书配置Nginx支持HTTPS强制HTTP跳转HTTPS定期备份策略mysqldump -uroot -p ry-vue backup_$(date %Y%m%d).sql7. 扩展功能集成7.1 邮件服务配置修改配置spring: mail: host: smtp.163.com username: youremail.com password: 授权码 default-encoding: UTF-8测试发送访问系统监控 → 定时任务执行测试邮件发送任务7.2 文件存储配置本地存储配置# application.yml file: path: D:/ruoyi/uploadPath七牛云集成// 修改FileUploadUtils.java // 实现七牛云上传逻辑8. 日常维护指南8.1 日志管理日志文件位置./logs/ruoyi-admin.log./logs/ruoyi-error.log日志级别调整logging: level: com.ruoyi: debug8.2 系统监控Druid监控访问http://localhost:8080/druid查看SQL执行情况Actuator端点/actuator/health/actuator/info8.3 版本升级备份策略数据库完整备份配置文件备份上传文件备份升级步骤git pull origin master mvn clean package -DskipTests在实际部署过程中我发现Windows环境变量设置不当是最常见的失败原因。建议每个工具安装后立即验证环境变量是否生效特别是JAVA_HOME和PATH的设置。另外MySQL 8.0的默认认证方式可能导致连接问题需要在my.ini中添加default_authentication_pluginmysql_native_password配置项。 
长河君 · 2026/10/27 6:58:08 · 阅读 1.2k RuoYi-Vue分离版Windows部署全指南
1. RuoYi-Vue分离版部署概述RuoYi-Vue作为国内广泛使用的开源管理系统框架其前后端分离架构在实际开发中具有显著优势。Windows环境下的完整部署涉及多个关键环节需要系统性地完成环境准备、依赖安装、配置调整和启动验证。本指南将基于最新稳定版本详细说明从零开始完成部署的全过程。2. 环境准备与工具安装2.1 基础软件要求部署前需确保Windows系统满足以下条件操作系统Windows 10/11 64位或Windows Server 2016内存建议8GB以上最低4GB磁盘空间至少20GB可用空间2.2 必要工具安装JDK 1.8推荐使用Oracle JDK 8u321或OpenJDK 11安装后需配置JAVA_HOME环境变量验证命令java -versionMaven 3.6下载二进制包解压至指定目录配置MAVEN_HOME并添加至PATH验证命令mvn -vNode.js 14建议安装LTS版本如16.15.0包含npm包管理器验证命令node -v和npm -vMySQL 5.7推荐使用MySQL 8.0.28社区版安装时需设置root密码并记住安装MySQL Workbench便于管理Redis 5.0Windows版可直接下载.msi安装包安装后设置为系统服务自动启动验证命令redis-cli ping3. 后端部署流程3.1 项目获取与配置克隆项目仓库git clone https://gitee.com/y_project/RuoYi-Vue.git导入IDE推荐IntelliJ IDEA选择File → Open → 选中pom.xml等待Maven自动下载依赖约5-10分钟数据库初始化创建数据库ry-vue执行sql/ry_20230214.sql初始化表结构执行sql/quartz.sql初始化定时任务修改配置文件# application.yml spring: datasource: url: jdbc:mysql://localhost:3306/ry-vue?useSSLfalse username: root password: 你的密码3.2 编译与启动执行Maven打包mvn clean package -DskipTests启动后端服务java -jar ruoyi-admin/target/ruoyi-admin.jar验证启动访问http://localhost:8080应看到Swagger API文档页面4. 前端部署流程4.1 环境准备安装依赖cd ruoyi-ui npm install --registryhttps://registry.npmmirror.com修改配置// .env.development VUE_APP_BASE_API http://localhost:80804.2 开发模式运行启动前端服务npm run dev验证访问浏览器打开http://localhost:80应看到登录页面4.3 生产环境打包构建生产包npm run build:prod部署到Nginx将dist目录内容复制到Nginx html目录配置nginx.confserver { listen 80; server_name localhost; location / { root html; index index.html; } location /prod-api/ { proxy_pass http://localhost:8080/; } }5. 常见问题解决方案5.1 端口冲突处理查看占用端口netstat -ano | findstr 8080解决方案修改后端server.port配置或终止占用进程taskkill /PID 进程号 /F5.2 数据库连接失败检查项MySQL服务是否启动用户名密码是否正确数据库名是否匹配解决方案GRANT ALL PRIVILEGES ON *.* TO root% IDENTIFIED BY 密码; FLUSH PRIVILEGES;5.3 前端跨域问题开发环境解决方案// vue.config.js devServer: { proxy: { /api: { target: http://localhost:8080, changeOrigin: true, pathRewrite: { ^/api: } } } }生产环境解决方案确保Nginx反向代理配置正确检查请求URL是否包含/prod-api前缀6. 系统优化建议6.1 性能调优JVM参数调整java -Xms512m -Xmx1024m -jar ruoyi-admin.jarRedis缓存优化spring: redis: database: 0 host: localhost port: 6379 password: timeout: 3000 lettuce: pool: max-active: 20 max-wait: -16.2 安全加固修改默认密码修改application.yml中的默认密码更新MySQL root密码启用HTTPS申请SSL证书配置Nginx支持HTTPS强制HTTP跳转HTTPS定期备份策略mysqldump -uroot -p ry-vue backup_$(date %Y%m%d).sql7. 扩展功能集成7.1 邮件服务配置修改配置spring: mail: host: smtp.163.com username: youremail.com password: 授权码 default-encoding: UTF-8测试发送访问系统监控 → 定时任务执行测试邮件发送任务7.2 文件存储配置本地存储配置# application.yml file: path: D:/ruoyi/uploadPath七牛云集成// 修改FileUploadUtils.java // 实现七牛云上传逻辑8. 日常维护指南8.1 日志管理日志文件位置./logs/ruoyi-admin.log./logs/ruoyi-error.log日志级别调整logging: level: com.ruoyi: debug8.2 系统监控Druid监控访问http://localhost:8080/druid查看SQL执行情况Actuator端点/actuator/health/actuator/info8.3 版本升级备份策略数据库完整备份配置文件备份上传文件备份升级步骤git pull origin master mvn clean package -DskipTests在实际部署过程中我发现Windows环境变量设置不当是最常见的失败原因。建议每个工具安装后立即验证环境变量是否生效特别是JAVA_HOME和PATH的设置。另外MySQL 8.0的默认认证方式可能导致连接问题需要在my.ini中添加default_authentication_pluginmysql_native_password配置项。