奋斗
努力

ruoyi框架部署ubuntu22.04需要哪些配置环境?

云计算

在 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 等组件,可另行提问。

如有具体报错或版本问题,欢迎提供细节进一步排查。

未经允许不得转载:云服务器 » ruoyi框架部署ubuntu22.04需要哪些配置环境?