若依管理系统部署到服务器需要的配置是什么？

将若依（RuoYi）管理系统部署到服务器，通常分为 Linux 环境准备、数据库配置、应用部署 和 Nginx 反向X_X 四个核心步骤。以下是详细的配置清单和操作指南：

1. 服务器环境要求

若依系统基于 Spring Boot + Vue 架构，对服务器基础环境有明确要求。建议直接使用 CentOS 7/8、Ubuntu 20.04+ 或 Debian 等主流 Linux 发行版。

2. 数据库配置 (MySQL)

在部署前，需要初始化数据库并导入若依的 SQL 脚本。

1. 创建数据库与用户：

   CREATE DATABASE ruoyi DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
   GRANT ALL PRIVILEGES ON ruoyi.* TO 'ruoyi'@'%' IDENTIFIED BY '你的强密码';
   FLUSH PRIVILEGES;

2. 导入数据：

   • 进入若依项目目录下的 sql 文件夹。
   • 执行 ruoyi.sql 文件（包含基础表结构）。
   • 执行 gen.sql 文件（可选，用于代码生成器功能）。
   • 执行 sys_user_post.sql 等字典表数据（确保系统正常运行）。

3. 配置文件修改 (application.yml)：
   找到项目根目录下的 src/main/resources/application.yml，修改数据库连接信息：

   spring:
     datasource:
       type: com.alibaba.druid.pool.DruidDataSource
       driverClassName: com.mysql.cj.jdbc.Driver # 如果是 MySQL 8.0，必须用 cj 驱动
       druid:
         initial-size: 5
         max-active: 20
         min-idle: 5
         max-wait: 6000
         url: jdbc:mysql://服务器IP:3306/ruoyi?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
         username: ruoyi
         password: 你的强密码

   注意：如果是 MySQL 8.0，务必添加 serverTimezone=GMT%2B8 以避免时间报错。

3. 后端构建与部署

若依提供了打包好的 JAR 包，或者你可以手动构建。

方式 A：使用官方提供的 Jar 包（推荐新手）

1. 下载若依发布的 ruoyi-admin.jar。
2. 上传至服务器（如 /opt/ruoyi/ 目录）。
3. 上传修改好数据库配置的 application.yml 到同一目录。
4. 启动命令：

   nohup java -jar ruoyi-admin.jar --spring.profiles.active=prod &

   (注：--spring.profiles.active=prod 表示加载生产环境配置)

方式 B：本地 Maven 构建

1. 在本地 IDE 或终端执行 mvn clean package。
2. 生成的 jar 包位于 ruoyi-admin/target/ 目录下。
3. 上传至服务器并按上述方式启动。

4. 前端构建与 Nginx 配置

若依的前端是独立的 Vue 项目，需要单独编译并部署到 Nginx。

步骤 1：前端打包

1. 在本地打开 ruoyi-ui 目录。
2. 安装依赖：npm install。
3. 修改 .env.production 文件中的 API 地址为服务器 IP：

   VUE_APP_BASE_API = '/dev-api' 
   # 或者根据 nginx 配置改为具体的接口路径

4. 执行打包：npm run build:prod。
5. 生成的 dist 文件夹即为前端静态资源。

步骤 2：上传前端资源

将 dist 文件夹上传至服务器，例如 /var/www/html/ruoyi-frontend。

步骤 3：Nginx 配置

编辑 Nginx 配置文件（通常在 /etc/nginx/conf.d/ruoyi.conf）：

server {
    listen       80;
    server_name  your-domain.com; # 或服务器 IP

    # 前端静态资源
    location / {
        root /var/www/html/ruoyi-frontend;
        index index.html;
        try_files $uri $uri/ /index.html; # 解决 Vue 路由刷新 404 问题
    }

    # 后端接口反向X_X
    location /app/ {
        proxy_pass http://127.0.0.1:8080; # 对应后端 Spring Boot 端口
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

        # WebSocket 支持（若依涉及即时通讯或日志推送时需要）
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }

    # 其他接口X_X（根据实际路由调整）
    location /druid/ {
        proxy_pass http://127.0.0.1:8080/druid/;
    }
}

关键点：Vue 的 History 模式必须配置 try_files，否则刷新页面会报 404。

5. 安全与优化建议

1. 防火墙设置：
   • 开放 80 (HTTP)、443 (HTTPS)。
   • 关闭 8080 (Spring Boot 默认端口)，仅通过 Nginx 访问。
   • 开放 3306 (MySQL) 仅限内网或特定 IP 访问，严禁对公网开放。
2. HTTPS 配置：
   • 生产环境强烈建议申请 SSL 证书并配置 HTTPS，防止敏感数据（如密码、Token）泄露。
3. 系统监控：
   • 建议安装 htop、nmon 或使用 Prometheus + Grafana 监控 CPU、内存和磁盘 IO。
4. 定时任务清理：
   • 检查 application.yml 中是否开启了定时任务清理功能，避免日志文件无限增长占满磁盘。

总结验证

部署完成后，按以下顺序验证：

1. 访问 http://服务器IP，应看到若依登录页。
2. 输入默认账号 admin 和密码 admin123（首次登录后请立即修改密码），确认能登录。
3. 尝试进行一个业务操作（如查询菜单），确认后端接口无跨域且响应正常。
4. 刷新登录页 URL，确认不出现 404。

按照以上步骤配置，即可成功将若依管理系统部署至生产环境。