Ruoyi 若依后台管理系统零基础部署实战指南
在现代企业级应用开发中,快速搭建一套稳定、安全的后台管理系统是很多团队的刚需。Ruoyi(若依)作为国内最受欢迎的开源后台管理框架之一,基于Spring Boot + Vue,拥有完善的权限体系、代码生成器、定时任务等功能,深受开发者喜爱。然而,对于零基础的初学者来说,从零开始部署Ruoyi到云服务器,往往会遇到环境配置、依赖安装、数据库初始化等一系列问题。本文将带你一步步完成Ruoyi的云端部署,让你少走弯路。
准备工作
在开始之前,你需要准备以下内容:

服务器基础环境配置
首先,通过SSH登录你的云服务器,执行以下命令更新系统并安装常用工具:
sudo yum update -y # CentOS# 或sudo apt update && sudo apt upgrade -y # Ubuntu安装JDK和Maven:
sudo yum install -y java-1.8.0-openjdk-devel maven安装Node.js(建议使用nvm管理版本):
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bashsource ~/.bashrcnvm install 14.21.3安装MySQL与Redis
Ruoyi依赖MySQL(存储业务数据)和Redis(缓存、会话管理)。
安装MySQL 5.7
wget https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpmsudo rpm -ivh mysql57-community-release-el7-11.noarch.rpmsudo yum install -y mysql-serversudo systemctl start mysqldsudo systemctl enable mysqld获取初始密码并登录,修改密码,创建ruoyi数据库:
sudo grep 'temporary password' /var/log/mysqld.logmysql -uroot -pALTER USER 'root'@'localhost' IDENTIFIED BY '你的新密码';CREATE DATABASE ruoyi DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;将项目中的ruoyi.sql文件导入数据库。
安装Redis
sudo yum install -y redissudo systemctl start redissudo systemctl enable redis构建并部署后端
在本地或服务器上克隆Ruoyi源码(以若依Vue版本为例):git clone https://gitee.com/y_project/RuoYi-Vue.gitcd RuoYi-Vue修改配置文件ruoyi-admin/src/main/resources/application-druid.yml,将数据库地址、用户名、密码改为你的实际值。修改application.yml中的Redis连接信息。
使用Maven打包:
mvn clean package -Dmaven.test.skip=true将生成的ruoyi-admin.jar上传至服务器,启动:nohup java -jar ruoyi-admin.jar > ruoyi.log 2>&1 &构建并部署前端
进入前端目录ruoyi-ui:cd ruoyi-uinpm installnpm run build:prod构建完成后会在dist目录生成静态文件。
sudo yum install -y nginxsudo vim /etc/nginx/conf.d/ruoyi.conf配置如下(将/dist路径改为实际路径):
server { listen 80; server_name your_domain_or_ip; root /opt/ruoyi/dist; index index.html; location /prod-api/ { proxy_pass http://127.0.0.1:8080/; }}重载Nginx:
sudo systemctl restart nginx访问与验证
打开浏览器,输入你的服务器IP或域名,即可看到若依登录页面。默认账号为admin,密码为admin123。登录后建议立即修改密码,并开启防火墙中的80端口。
常见问题与优化建议
端口问题:确保安全组和防火墙放行80、8080端口。内存不足:如果服务器内存小于2G,建议为JVM设置-Xmx512m。域名HTTPS:可使用Let's Encrypt免费证书,配置Nginx实现HTTPS访问。总结
通过上述步骤,你已经能够将Ruoyi若依后台管理系统成功部署到云端。整个过程虽然涉及较多工具和配置,但只要耐心操作,结合Ciuic云平台的便捷服务,完全可以实现快速上线。未来你还可以基于Ruoyi的代码生成器快速开发业务模块,大幅提升开发效率。希望本指南能帮助你迈出云端部署的第一步,开启高效开发之旅。


