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

在 Ubuntu 22.04 上部署 RuoYi 框架（前后端分离版或单体版）需要配置相应的运行环境。RuoYi 是一个基于 Spring Boot 的 Java 后台管理系统，通常搭配 Vue 前端使用。以下是部署所需的环境配置步骤和建议。

一、基础环境准备

1. 更新系统

sudo apt update && sudo apt upgrade -y

二、安装 Java 环境（JDK）

RuoYi 基于 Spring Boot，需要 JDK 8 或 JDK 11（推荐 JDK 11）。

安装 OpenJDK 11

sudo apt install openjdk-11-jdk -y

验证安装

java -version
javac -version

设置 JAVA_HOME（可选但推荐）

编辑 /etc/environment：

sudo nano /etc/environment

添加：

JAVA_HOME="/usr/lib/jvm/java-11-openjdk-amd64"

然后加载：

source /etc/environment
echo $JAVA_HOME

三、安装并配置数据库（MySQL）

RuoYi 默认使用 MySQL。

1. 安装 MySQL Server

sudo apt install mysql-server -y

2. 启动并设置开机自启

sudo systemctl start mysql
sudo systemctl enable mysql

3. 安全初始化（设置 root 密码、删除匿名用户等）

sudo mysql_secure_installation

4. 登录 MySQL 并创建 RuoYi 数据库

mysql -u root -p

CREATE DATABASE ruoyi DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'ruoyi'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON ruoyi.* TO 'ruoyi'@'localhost';
FLUSH PRIVILEGES;
EXIT;

⚠️ 注意：如果前端和后端跨域，请授权 'ruoyi'@'%' 并开放防火墙。

四、导入 RuoYi 数据库

从 RuoYi 项目中的 sql/ry_*.sql 文件导入数据。

方法 1：本地导入

mysql -u ruoyi -p ruoyi < /path/to/ry_2023xxxx.sql

方法 2：使用客户端工具（如 Navicat、DBeaver）连接导入。

五、安装 Maven（用于构建 Java 项目）

sudo apt install maven -y
mvn -version

六、构建与部署后端（Spring Boot）

1. 获取 RuoYi 代码

git clone https://gitee.com/y_project/RuoYi-Vue.git
cd RuoYi-Vue

2. 修改数据库配置

编辑 ruoyi-admin/src/main/resources/application-druid.yml：

spring:
  datasource:
    druid:
      url: jdbc:mysql://localhost:3306/ruoyi?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT%2B8
      username: ruoyi
      password: your_password

3. 打包项目

mvn clean package -Dmaven.test.skip=true

生成的 jar 包位于 ruoyi-admin/target/ruoyi-admin.jar

4. 运行后端服务

nohup java -jar ruoyi-admin.jar > ruoyi.log 2>&1 &

默认端口：8080
访问：http://your-server-ip:8080

七、部署前端（Vue）

1. 安装 Node.js 和 npm

推荐使用 Node.js 16.x 或 18.x

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

验证：

node -v
npm -v

2. 安装依赖并打包前端

cd RuoYi-Vue
cd ruoyi-ui
npm install
npm run build:prod

构建完成后，文件在 dist/ 目录。

3. 部署前端（使用 Nginx）

安装 Nginx

sudo apt install nginx -y
sudo systemctl start nginx
sudo systemctl enable nginx

配置 Nginx

编辑配置文件：

sudo nano /etc/nginx/sites-available/ruoyi

内容示例：

server {
    listen 80;
    server_name your-domain-or-ip;

    location / {
        root /home/ubuntu/RuoYi-Vue/ruoyi-ui/dist;
        try_files $uri $uri/ /index.html;
        index 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 rm -f /etc/nginx/sites-enabled/default  # 删除默认站点
sudo nginx -t
sudo systemctl reload nginx

八、开放防火墙端口

sudo ufw allow 80
sudo ufw allow 8080
sudo ufw enable

九、可选：使用 PM2 管理前端或后端进程

npm install -g pm2
pm2 start "java -jar ruoyi-admin.jar" --name ruoyi-backend

十、访问系统

打开浏览器访问：

http://your-server-ip/

默认账号：

• 用户名：admin
• 密码：admin123

总结：所需环境清单

✅ 提示：

• 若使用云服务器，请确保安全组放行 80、8080 端口。
• 生产环境建议使用 HTTPS（Let’s Encrypt + Certbot）。
• 可结合 systemd 管理后端服务（创建 .service 文件）。

如需自动化部署脚本或 Docker 部署方案，也可以提供。