RuoYi云服务器部署全流程指南：从零到生产环境

一、RuoYi系统部署前的核心准备

1.1 云服务器选型策略

根据RuoYi系统特性，推荐采用2核4G以上配置的云服务器，优先选择具备弹性扩展能力的实例类型。操作系统建议选用CentOS 8或Ubuntu 20.04 LTS，这两个版本对Java生态和Spring Boot框架有最佳兼容性。内存分配方面，需为JVM预留至少2GB空间，建议设置-Xms1024m -Xmx2048m参数。

1.2 依赖环境安装指南

Java环境配置需安装OpenJDK 11或Oracle JDK 11，通过java -version验证安装。MySQL数据库建议使用5.7+版本，执行以下SQL优化表结构：

CREATE DATABASE ry CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE sys_user MODIFY COLUMN password VARCHAR(100) NOT NULL COMMENT '密码';

Redis缓存服务需配置持久化策略，在redis.conf中设置appendonly yes和save 900 1。

二、RuoYi系统部署实施步骤

2.1 基础环境搭建

通过SSH连接服务器后，执行以下环境初始化命令：

# 安装必要工具
yum install -y wget curl unzip
# 配置NTP时间同步
yum install -y ntp
systemctl enable --now ntpd

2.2 部署包处理

从官方渠道获取RuoYi-Vue或RuoYi-Cloud的最新发行包，使用unzip ruoyi-admin.zip -d /opt/ruoyi解压到指定目录。修改application.yml中的数据库连接：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/ry?useSSL=false&serverTimezone=UTC
    username: root
    password: YourStrongPassword

2.3 服务启动优化

采用Systemd管理服务进程，创建/etc/systemd/system/ruoyi.service文件：

[Unit]
Description=RuoYi Admin Service
After=syslog.target network.target
[Service]
Type=simple
User=root
WorkingDirectory=/opt/ruoyi
ExecStart=/usr/bin/java -jar ruoyi-admin.jar
Restart=on-failure
[Install]
WantedBy=multi-user.target

执行systemctl daemon-reload后启动服务，通过journalctl -u ruoyi -f查看实时日志。

三、生产环境优化方案

3.1 性能调优策略

JVM参数优化示例：

JAVA_OPTS="-server -Xms2g -Xmx2g -XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m"

数据库连接池配置建议：

spring:
  datasource:
    hikari:
      maximum-pool-size: 20
      minimum-idle: 5
      connection-timeout: 30000

3.2 安全加固措施

实施三重防护机制：

1. 防火墙规则配置：

   iptables -A INPUT -p tcp --dport 8080 -j ACCEPT
   iptables -A INPUT -p tcp --dport 3306 -j DROP

2. 密钥管理方案：将数据库密码等敏感信息存储在/etc/ruoyi/secrets目录，设置600权限
3. 定期安全扫描：使用lynis工具执行系统安全审计

四、运维监控体系构建

4.1 监控指标设计

关键监控项包括：

• JVM内存使用率（Heap/Non-Heap）
• 数据库连接数（Active/Idle）
• 接口响应时间（P90/P99）
• 系统负载（1min/5min/15min）

4.2 告警规则配置

Prometheus告警规则示例：

groups:
- name: ruoyi.rules
  rules:
  - alert: HighMemoryUsage
    expr: (1 - (node_memory_MemAvailable_bytes / node_memory_MemTotal_bytes)) * 100 > 85
    for: 5m
    labels:
      severity: warning
    annotations:
      summary: "内存使用率超过85%"

五、常见问题解决方案

5.1 数据库连接失败排查

1. 检查MySQL服务状态：systemctl status mysqld
2. 验证网络连通性：telnet localhost 3306
3. 检查防火墙规则：iptables -L -n
4. 查看MySQL错误日志：tail -f /var/log/mysqld.log

5.2 接口500错误处理

1. 检查应用日志：journalctl -u ruoyi --no-pager -n 100
2. 验证依赖服务状态：systemctl status redis
3. 检查磁盘空间：df -h
4. 重启服务测试：systemctl restart ruoyi

六、持续集成部署方案

推荐采用GitLab CI/CD流水线，配置示例：

stages:
  - build
  - deploy
build_job:
  stage: build
  script:
    - mvn clean package
    - scp target/ruoyi-admin.jar root@target-server:/opt/ruoyi
deploy_job:
  stage: deploy
  script:
    - ssh root@target-server "systemctl restart ruoyi"

七、扩展性设计建议

7.1 微服务架构改造

将RuoYi拆分为独立服务模块：

• 认证服务（ruoyi-auth）
• 系统管理服务（ruoyi-system）
• 代码生成服务（ruoyi-gen）
• 文件存储服务（ruoyi-file）

7.2 容器化部署方案

Docker Compose配置示例：

version: '3'
services:
  ruoyi-admin:
    image: openjdk:11-jre
    volumes:
      - ./app:/app
    command: java -jar /app/ruoyi-admin.jar
    ports:
      - "8080:8080"
    depends_on:
      - mysql
      - redis

通过上述系统化的部署方案，开发者可以高效完成RuoYi系统在云服务器上的部署实施。建议建立完善的运维文档体系，包含架构图、部署手册、应急预案等关键文档，确保系统的长期稳定运行。实际部署过程中，建议先在测试环境验证所有配置，再逐步推广到生产环境。