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

若依（RuoYi）管理系统是一个基于 Spring Boot 的轻量级快速开发平台，部署到服务器时通常分为后端环境配置和前端资源构建两部分。以下是标准的部署配置清单及关键步骤：

1. 基础运行环境

若依后端完全依赖 Java 生态，因此必须确保服务器安装了以下软件：

• JDK (Java Development Kit)
  • 版本要求：若依标准版通常使用 JDK 1.8；若依 Cloud 微服务版建议使用 JDK 1.8 或 JDK 17。
  • 检查命令：java -version
• Maven (可选，仅用于本地打包)
  • 如果直接在服务器上编译源码，需要安装 Maven（建议 3.6+）。
  • 更推荐的做法是在本地电脑使用 mvn clean package 打包成 .jar 文件，再上传到服务器直接运行，这样可以减少服务器对 Maven 的依赖。
• Redis
  • 若依默认开启 Redis 缓存功能（用于存储验证码、Token、字典等），生产环境强烈建议安装并启动 Redis。
  • 注意：如果不需要缓存功能，可以在配置文件 application.yml 中关闭 Redis 相关配置，但性能会受影响。
• 数据库 (MySQL)
  • 版本：MySQL 5.7 或 MySQL 8.0。
  • 字符集：必须设置为 utf8mb4，否则中文数据可能乱码。
  • 初始化：需导入若依提供的 SQL 脚本（通常在 doc 目录下，如 ry_202401.sql）。

2. 项目构建与打包

在部署前，需要对项目进行打包。

• 后端打包：
  进入后端项目根目录（ruoyi-admin 或 ruoyi-cloud），执行：

  mvn clean package -Dmaven.test.skip=true

  生成的可执行 jar 包位于 target/ruoyi-admin.jar（具体文件名视模块而定）。

• 前端构建：
  若依的前端（Vue）需要单独构建为静态资源，然后部署到 Nginx 或 Web 容器。

  • 进入前端目录（ruoyi-ui）。
  • 修改 .env.production 文件中的 VUE_APP_BASE_API 指向服务器的实际接口地址。
  • 执行打包命令：

    npm install
    npm run build:prod

  • 生成的 dist 文件夹即为前端静态资源。

3. 核心配置文件 (application.yml)

这是部署中最关键的一步，必须根据服务器实际情况修改 src/main/resources/application.yml 中的以下参数：

提示：若依支持多环境配置（dev, test, prod），生产环境应使用 -Pprod 参数进行打包，或者手动修改 application-prod.yml。

4. 服务器安全与防火墙

• 端口开放：
  • 后端端口（如 8080）：需在服务器安全组或防火墙中放行。
  • Redis 端口（6379）：严禁直接暴露在公网，建议绑定内网 IP 或通过 SSH 隧道访问。
  • MySQL 端口（3306）：严禁直接暴露在公网，仅限应用服务器连接。
• Nginx 反向X_X（推荐）：
  为了统一入口和隐藏后端端口，通常会在服务器安装 Nginx。
  • 将前端 dist 目录放入 Nginx 的 html 目录。
  • 配置 Nginx 将 API 请求（如 /system/*）转发到后端的 Jar 包地址。

5. 启动方式

打包完成后，使用以下命令在后台启动服务：

# 进入 target 目录
cd target

# 启动命令 (建议加上 nohup 防止终端关闭后进程终止，并指定日志输出)
nohup java -jar ruoyi-admin.jar --spring.profiles.active=prod > logs/ruoyi.log 2>&1 &

启动后，可通过 tail -f logs/ruoyi.log 查看实时日志，确认是否有报错。

总结

部署若依的核心在于：JDK + MySQL + Redis 的环境准备，application.yml 的正确配置，以及前后端分离后的 Nginx 反向X_X配置。如果是生产环境，务必记得修改默认密码、开启 HTTPS 并限制数据库远程访问权限。