锦中统一消息平台安装部署手册

## 1.安装环境要求
服务器端硬件最低配置（性能低，不推荐）
至少需要一台服务器（数据库和应用安装在同一台服务器上）
CPU：2.40GHz或以上，至少需要2核
内存：4G
硬盘：可用空间 80G以上
其它方面无特殊要求
最低要求仅供演示使用

服务器端硬件建议配置
建议两台服务器，数据库和应用各一台服务器。

应用服务器建议配置如下：
CPU：2.40GHz或以上，建议8核
内存：16G
硬盘：可用空间 200G以上

数据库服务器建议配置如下：
CPU：2.40GHz或以上，建议8核
内存：16G
硬盘：可用空间 500G以上
其它方面无特殊要求，建议根据使用用户数量酌情增减

服务器端软件配置要求
操作系统：Ubuntu 20.04.1 （或以上版本）
Java：jdk17 (或以上版本)、 openjdk17 (或以上版本)
Nginx： 1.18 （或以上版本）
数据库： MySQL 8.0（或以上版本），或达梦 8
其它：
Redis 6.0 （或以上版本）
powerjob 4.3.9

用户端软件配置要求
浏览器：Chrome、Firefox、Safari、Edge 等 chrome 内核的浏览器常规版本均可

## 2.安装步骤（Ubuntu服务器，数据库和应用各一台服务器）
**基础环境安装**

**JDK 安装**
[JDK安装教程](https://blog.csdn.net/qq_42557044/article/details/124935468 "JDK安装教程")

MySql 8 安装
[MySql 8 安装教程](https://blog.csdn.net/weixin_48088839/article/details/143756554 "MySql 8 安装教程")

**Redis 安装**
[Redis 安装教程](https://www.cnblogs.com/xiaobug/p/16007895.html "Redis 安装教程")

**Nginx 安装**
[Nginx 安装教程](https://blog.csdn.net/weixin_41302755/article/details/123175079 "Nginx 安装教程")

**minio 安装**
[minio安装教程](https://www.cnblogs.com/500m/p/17110733.html "minio安装教程")

License 申请( http://app.jzkg.cn )
锦中智慧学工管理系统，是收费软件系统，需要有License才能正常部署。在您部署之前，应从官方获得正版的License。如果您还没有License，想先部署、测试的话，那么可以在部署之前，先到官方在线申请免费使用3天的License，在线申请url为：http://app.jzkg.cn 。

在申请License之前，需要先获得融合门户系统后端所在服务器的Ipv4地址（即Ip地址）、Ipv6地址和Mac物理地址。方法为在控制台中输入：ifconfig 命令即可看到。

申请成功后，您将得到文件：license.xml，将这个文件放到：与jar文件同级目录jzconfig下面即可。假设您的jar文件的路径为/home/jzjt/rhmh.jar，则将license.xml放在/home/jzjt/jzconfig/license.xml ，注意Linux系统区分大小写，默认license.xml 均小写。

## 后端部署

（1）将打包好的 jar 包上传至服务器指定文件夹中

（2）以后台运行方式启动即可

`nohup java -jar xiaoxi.jar >/dev/null 2>&1 &`

（3）假设您的服务器Ip为：192.168.1.118 ，部署端口为8088 , 后端部署好之后，通过URL： http://192.168.1.118:8088/blade-auth/oauth/captcha 如果看到”key” 相关字样，则后端部署成功

## 配置文件注意事项
```yaml
#服务器配置
server:
  port: 8088

## license配置
license:
  license-xml-address: license地址
  modulus: 申请

spring:
  data:
    redis:
      ##redis 单机环境配置
      host: 127.0.0.1
      port: 6379
      password:
      database: 0
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://127.0.0.1:3306/xiaoxi?useSSL=false&useUnicode=true&characterEncoding=utf-8&zeroDateTimeBehavior=convertToNull&transformedBitIsBoolean=true&serverTimezone=GMT%2B8&nullCatalogMeansCurrent=true&allowPublicKeyRetrieval=true
    username: xiaoxi
    password: Xiaoxi@123

```

## 前端部署
假设您的前端访问域名为： http://xiaoxi.jzkg.cn 。
（1）可使用Nginx、Apache等任何静态文件服务器部署前端，确保可以在公网访问前端。
（2）在Linux系统上解压前端文件时，如果使用unzip命令的话，可采用 sudo unzip -O CP936 yourfrontfile.zip 命令。 由于前端文件中包含中文文件名称，-O CP936 参数可防止中文文件乱码。

## 其他部署
（1）前端http://xiaoxi.jzkg.cn，访问后端api的路径默认前缀为：http://xiaoxi.jzkg.cn/api/ ，比如上文中的
http://192.168.1.118:8088/blade-auth/oauth/captcha ，应当能通过 http://xiaoxi.jzkg.cn/api/blade-auth/oauth/captcha 路径访问，以下为在Nginx上配置后端的相关代码：

```shell
server {
    listen       80;
    server_name  ky.jzkg.cn;
    location ^~/api {
    proxy_pass http://192.168.1.118:8088;
    rewrite "^/api/(.*)$" /$1 break;
    }
}
```

## 邮箱模板文件存放

设定好的邮件模板中如果是有背景图，需要手动添加，首先在随想存储中配置好地址。
样式如下（也可以自己添加样式图片）：

![](/media/202506/2025-06-12_171247_164101.png)

假设当前我们有一个nginx目录为：`/usr/share/nginx/html`，假设nginx端口为8000，访问（http://localhost:8000）后若看到如下界面，则说明nginx服务启动成功，可以进行下一步操作
加上下面的命令，防止文件超出限制：
```shell
#设置最大上传文件大小为 100MB
client_max_body_size 100M;

```

```shell
server {
    listen 8000;
    server_name  127.0.0.1;
     charset utf-8;
     client_max_body_size 100M;
    location / {
     root  /usr/share/nginx/html;	    
      sendfile on;
      autoindex on;
      autoindex_exact_size off;
      autoindex_localtime on;
    }
}

```

![](/media/202505/2025-05-24_135507_141863.png)

## 对象存储配置
1. 前往 **资源管理->对象存储** 新增如下配置

![](/media/202505/2025-05-24_135536_578481.png)
2. 点击调试按钮并上传一个图片测试，若看到图片显示成功则说明对象存储的本地模式配置成功了

![](/media/202505/2025-05-24_135601_278180.png)