在 Ubuntu 22.04 上部署 RuoYi 框架(若依框架)需要根据你使用的 RuoYi 版本(如 Spring Boot 单体版、前后端分离版、微服务版等)进行相应的环境配置。以下是部署 RuoYi 前后端分离版(Spring Boot + Vue)的完整环境配置指南。
✅ 一、基础环境要求
1. Java 环境(JDK)
RuoYi 后端基于 Spring Boot,通常使用 JDK 8 或 JDK 11。
# 查看是否已安装
java -version
# 安装 OpenJDK 11(推荐)
sudo apt update
sudo apt install openjdk-11-jdk -y
# 验证安装
java -version
javac -version
⚠️ 注意:某些旧版本 RuoYi 可能仅支持 JDK 8,建议查看项目文档确认版本兼容性。
2. Maven(构建工具)
# 安装 Maven
sudo apt install maven -y
# 验证
mvn -version
3. Node.js 和 npm(前端构建)
前端使用 Vue.js,需 Node.js 环境。
# 添加 NodeSource 仓库(Node.js 16 或 18)
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
# 验证
node -v # 应输出 v18.x
npm -v # 应输出 9.x+
4. MySQL 数据库(5.7 或 8.0)
# 安装 MySQL
sudo apt install mysql-server mysql-client -y
# 启动并设置开机自启
sudo systemctl start mysql
sudo systemctl enable mysql
# 运行安全配置(设置 root 密码等)
sudo mysql_secure_installation
创建 RuoYi 数据库
CREATE DATABASE ruoyi DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci;
导入 ry_*.sql 脚本(通常在项目 sql/ 目录下)。
5. Redis(可选但推荐)
RuoYi 使用 Redis 缓存验证码、登录会话等。
sudo apt install redis-server -y
sudo systemctl start redis-server
sudo systemctl enable redis-server
验证:
redis-cli ping # 返回 PONG 表示正常
✅ 二、配置 RuoYi 项目
1. 获取源码
git clone https://gitee.com/y_project/RuoYi-Vue.git
cd RuoYi-Vue
2. 修改后端配置文件
路径:ruoyi-admin/src/main/resources/application.yml
修改数据库连接:
spring:
datasource:
druid:
url: jdbc:mysql://localhost:3306/ruoyi?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT%2B8&useSSL=false
username: root
password: your_mysql_password
driver-class-name: com.mysql.cj.jdbc.Driver
Redis 配置(如有):
spring:
redis:
host: localhost
port: 6379
password:
database: 0
3. 构建后端
mvn clean package -DskipTests
生成的 jar 包位于 ruoyi-admin/target/ruoyi-admin.jar
4. 启动后端服务
nohup java -jar ruoyi-admin.jar > ruoyi.log 2>&1 &
默认端口:8080
访问:http://your-server-ip:8080
5. 构建前端(Vue)
进入前端目录:
cd ruoyi-ui
修改 API 地址(如果服务器 IP 不是本地):
编辑 .env.development 和 .env.production:
VUE_APP_BASE_API = 'http://your-server-ip:8080'
安装依赖并打包:
npm install
npm run build:prod
生成的静态文件在 dist/ 目录。
✅ 三、部署前端(Nginx)
安装 Nginx:
sudo apt install nginx -y
sudo systemctl start nginx
sudo systemctl enable nginx
配置 Nginx X_X:
sudo vim /etc/nginx/sites-available/ruoyi
内容如下:
server {
listen 80;
server_name your-domain-or-ip;
location / {
root /home/ubuntu/RuoYi-Vue/ruoyi-ui/dist;
index index.html;
try_files $uri $uri/ /index.html;
}
location /prod-api/ {
proxy_pass http://localhost:8080/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
启用站点:
sudo ln -s /etc/nginx/sites-available/ruoyi /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
✅ 四、开放防火墙端口
sudo ufw allow 80
sudo ufw allow 8080
sudo ufw allow 22
sudo ufw enable
✅ 五、访问系统
打开浏览器访问:
👉 http://your-server-ip
默认账号:
- 用户名:admin
- 密码:admin123
✅ 六、可选优化
- 使用
pm2管理前端 Node 服务(如果用 dev 模式运行) - 使用
systemd托管 Java 服务(更稳定) - 配置 HTTPS(Let’s Encrypt + Certbot)
- 设置定时备份数据库
📌 总结:所需环境清单
| 组件 | 版本要求 | 安装方式 |
|---|---|---|
| Ubuntu | 22.04 LTS | 系统 |
| OpenJDK | 8 或 11 | apt install |
| Maven | 3.6+ | apt install |
| Node.js | 14 / 16 / 18 | Nodesource |
| MySQL | 5.7 或 8.0 | apt install |
| Redis | 6.0+ | apt install |
| Nginx | 1.18+ | apt install |
如果你使用的是 RuoYi 微服务版(Spring Cloud),还需额外配置 Nacos、Sentinel、Gateway 等组件,可另行提问。
如有具体报错或版本问题,欢迎提供细节进一步排查。
云服务器