若依框架部署到Linux服务器的步骤与注意事项

若依框架是一款基于Spring Boot和Spring Cloud的快速开发平台，其部署到Linux服务器的过程需要一定的技术基础。以下将详细介绍从准备到完成部署的所有步骤，并探讨一些常见的注意事项。

一、准备工作

1. 环境检查

   • 确保Linux服务器已安装JDK（建议使用Java 8或以上版本）。
   • 安装Maven（用于构建项目）。
   • 安装MySQL数据库并配置好数据库用户权限。
   • 安装Redis（如果项目中用到缓存功能）。
   • 安装Nginx（用于反向代理和负载均衡）。

2. 下载若依框架源码

   • 可以从GitHub或其他代码托管平台下载最新版本的若依框架。
   • 使用Git命令克隆项目：

     git clone https://github.com/yangzongzhuan/RuoYi.git
     

3. 配置数据库

   • 创建数据库ruoyi（或其他自定义名称）。
   • 导入若依框架提供的SQL脚本文件到数据库中。

二、项目打包与上传

1. 修改配置文件

   • 打开application.yml文件，根据实际环境修改数据库连接信息、Redis地址等配置项。

     spring:
       datasource:
         url: jdbc:mysql://localhost:3306/ruoyi?useUnicode=true&characterEncoding=utf8&serverTimezone=UTC
         username: root
         password: your_password
     redis:
       host: localhost
       port: 6379
     

2. 打包项目

   • 使用Maven进行打包：

     mvn clean package -Dmaven.test.skip=true
     

   • 打包完成后会在target目录下生成一个.jar文件。

3. 上传到服务器

   • 使用工具如WinSCP或命令行工具scp将.jar文件上传到Linux服务器指定目录。

     scp target/ruoyi-admin.jar user@your_server_ip:/path/to/deploy/
     

三、运行项目

1. 启动服务

   • 使用nohup命令后台运行项目：

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

   • 查看日志文件以确认服务是否正常启动：

     tail -f ruoyi.log
     

2. 设置开机自启

   • 编辑/etc/rc.local文件，添加启动命令以确保服务器重启后自动运行项目。

四、配置Nginx反向代理

1. 安装Nginx

   • 如果未安装Nginx，可以使用以下命令安装：

     sudo apt-get install nginx
     

2. 配置反向代理

   • 修改Nginx配置文件/etc/nginx/sites-available/default：

     server {
         listen 80;
         server_name your_domain_or_ip;
     
         location / {
             proxy_pass http://127.0.0.1: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;
         }
     }
     

   • 测试配置并重新加载Nginx：

     nginx -t
     systemctl reload nginx
     

五、注意事项

1. 防火墙设置

   • 确保服务器的防火墙允许外部访问80端口（或其他指定端口）。

     sudo ufw allow 80/tcp
     

2. 性能优化

   • 根据服务器性能调整JVM参数，例如增加堆内存大小：

     java -Xms512m -Xmx1024m -jar ruoyi-admin.jar
     

3. 安全性

   • 配置HTTPS以保护数据传输安全。
   • 禁止直接访问后端接口，通过Nginx限制请求来源。

4. 监控与日志管理

   • 定期查看日志文件，排查潜在问题。
   • 使用ELK（Elasticsearch, Logstash, Kibana）等工具集中管理日志。

六、流程图

以下是整个部署过程的流程图：

graph TD
    A[开始] --> B[检查环境]
    B --> C[下载源码]
    C --> D[修改配置文件]
    D --> E[打包项目]
    E --> F[上传到服务器]
    F --> G[启动服务]
    G --> H[配置Nginx]
    H --> I[完成]