Ubuntu 部署 RuoYi-Vue 完整指南

环境说明

• 操作系统: Ubuntu 24.04 (Noble)
• 项目: RuoYi-Vue (若依前后端分离版)
• 数据库: MySQL 8.0+
• Java: OpenJDK 17
• Node.js: 20.x LTS
• Redis-Server: 7.0.15
• Npm

一、环境准备

sudo apt install openjdk-17-jdk -y
sudo apt install mysql-server -y
sudo apt install maven -y
sudo apt install git -y
sudo apt install nodejs -y
sudo apt install redis-server -y
sudo apt install npm -y

二、获取RuoYi_Vue项目代码

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

三、配置数据库

sudo mysql -u root -p
– 创建数据库（使用下划线，避免后续麻烦）
CREATE DATABASE IF NOT EXISTS ry_vue DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
– 查看数据库列表确认
SHOW DATABASES;
– 删除旧用户（如果存在）
DROP USER IF EXISTS ‘ry’@‘localhost’;

– 创建新用户并设置密码
CREATE USER ‘ry’@‘localhost’ IDENTIFIED BY ‘123456’;
– 授权（使用反引号包裹带连字符的数据库名）
GRANT ALL PRIVILEGES ON ry-vue.* TO ‘ry’@‘localhost’;
– 如果使用下划线命名，则不需要反引号
– GRANT ALL PRIVILEGES ON ry_vue.* TO ‘ry’@‘localhost’;
– 刷新权限
FLUSH PRIVILEGES;
– 退出
EXIT;

– 测试一下
mysql -u ry -p -e “SELECT 1;”

– 导入sql
sudo mysql -u root -p ry_vue < sql/ry_20260417.sql
sudo mysql -u root -p ry_vue < sql/quartz.sql

要去看一下sql下面的文件名，不一定和我一样因为日期的原因。

四、配置后端

– 修改数据库连接配置
nano ruoyi-admin/src/main/resources/application-druid.yml

如下：
master:
url: jdbc:mysql://localhost:3306/ry_vue?useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=utf8
username: ry
password: 123456 # 改为你设置的密码

– 打包

mvn clean package -Dmaven.test.skip=true

– 运行后端
sudo java -jar ruoyi-admin/target/ruoyi-admin.jar

五、配置前端

cd ruoyi-ui
npm install
nano vue.config.js
// 开发环境配置
devServer: {
host: ‘0.0.0.0’, // 允许外部访问
port: 80, // 前端端口
proxy: {
‘/api’: {
target: ‘http://localhost:8080’, // 后端地址
changeOrigin: true
}
}

• 打包前端
  npm run build:prod
  npm run dev

六、防火墙

• 开放前端端口（如 3000）
  sudo ufw allow 3000/tcp

• 开放后端端口（如 8080）
  sudo ufw allow 8080/tcp

• 如果使用 nginx 80 端口
  sudo ufw allow 80/tcp

• 启用防火墙（如果未启用）
  sudo ufw enable

最后访问这个地址就可以在测试环境下访问了