锦中学工管理系统安装部署手册

## 简介

（1）本系统为锦中集团内部产品-《学工管理系统》，该手册请勿外泄！
（2）系统采用锦中内部框架 ObjectPlus、Saber 编写，数据库使用 Mysql，同时兼容达梦，中间件使用 Redis。
（3）本系统支持 Windows 环境及 Linux 环境下运行。

## 安装环境要求

### 服务器端硬件建议配置：

CPU：4.0GHz 或以上，至少需要 4 核
内存：8G
硬盘（可用空间）：200G 以上

### 服务器端软件建议配置：

服务器：Ubuntu、CentOS、国产麒麟操作系统
JDK：1.8
MySql：8.0 以上
Redis：5.0 以上
Nginx：1.10 以上
MinIO: RELEASE.2023-04-13T03-08-07Z 以上

### 用户端软件建议配置：

浏览器：Chrome、Firefox、Safari、Edge 等 chrome 内核的浏览器常规版本均可。

## 安装部署（国产麒麟同下）

### JDK 安装

[JDK安装教程](https://blog.csdn.net/qq_42557044/article/details/124935468)
### MySql 8 安装
[MySql 8安装教程](https://www.cnraksmart.com/7436.html)
### Redis 安装
[Redis安装教程](https://blog.csdn.net/lssqk/article/details/127220990)
### Nginx 安装
[Nginx安装教程](https://blog.csdn.net/weixin_41302755/article/details/123175079)
### Minio 安装
[Minio安装教程](https://www.cnblogs.com/500m/p/17110733.html)

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

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

申请成功后，您将得到文件：license.xml，将这个文件放到：与jar文件同级目录jzconfig下面即可。假设您的jar文件的路径为/data/xuegong/xuegong.jar，则将license.xml放在/data/xuegong/jzconfig/license.xml ，注意Linux系统区分大小写，默认license.xml 均小写。 另外还需要在application.yml中配置license.xml的绝对路径。

### 后端部署

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

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

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

注意：有些Linux服务器默认时区不是GMT+8时区，会导致时间差异，请尝试将Linux时区修改为+8时区，或者在命令行中增加如下参数：

`nohup java -jar -Dfile.encoding=UTF-8 -Duser.timezone=GMT+8 xuegong.jar >xuegong.log 2>&1 &`
（3）假设您的服务器Ip为：192.168.1.118 ，部署端口为8088 , 后端部署好之后，通过URL： http&#058;//192.168.1.118:8088/blade-auth/oauth/captcha 如果看到"key" 相关字样，则后端部署成功
### 配置文件注意事项

（1）自定义环境参数无需修改 jar 包中的配置文件，只需要将 application.yml 放在于 jar 包同级目录下，即可实现自定义。

（2）部署需要修改的配置清单：

`server.port 端口号修改`

`spring.datasource.driver-class-name -> 数据库连接驱动修改`
`spring.datasource.url -> 数据库连接字符串修改`
`spring.datasource.username -> 数据库连接用户名修改`
`spring.datasource.password -> 数据库连接密码修改`

`spring.redis.host -> redis 连接ip修改`
`spring.redis.port -> redis 连接端口号修改`
`spring.redis.password -> redis 连接密码修改`

`oss.endpoint -> minio 连接字符串修改`
`oss.access-key -> minio 连接用户名修改`
`oss.secret-key -> minio 连接密码修改`
`oss.bucket-name -> minio 桶名称修改`

`blade.preview.enabled -> 演示模式是否启用（正式使用时应当保持false）`
`blade.dataSource -> 数据源切换，目前支持：mysql、dm，注意当数据库驱动为mysql时，这边应当配置为 mysql`
`blade.swagger.enabled -> 接口文档服务是否启用（正式使用时应当保持false）`
`blade.license -> License.xml地址配置`

### 前端部署

假设您的前端访问域名为： http&#058;//xg.jzkg.cn 。
（1）可使用Nginx、Apache等任何静态文件服务器部署前端，确保可以在公网访问前端。
（2）移动端前端访问地址为：http&#58;//xg.jzkg.cn/m/
### 其它部署
（1）前端http&#058;//xg.jzkg.cn，访问后端api的路径默认前缀为：http&#058;//xg.jzkg.cn/api/ ，比如上文中的
http&#058;//192.168.1.118:8088/blade-auth/oauth/captcha ，应当能通过 http&#058;//xg.jzkg.cn/api/blade-auth/oauth/captcha 路径访问，以下为在Nginx上配置后端的相关代码：
```
server {
    listen       80;
    server_name  xg.jzkg.cn;
    location ^~/api {
	proxy_pass http://192.168.1.118:8088;
	rewrite "^/api/(.*)$" /$1 break;
    }
}
```
（2）学工系统的文件、图片存储采用MinIO，MinIO的访问默认采用9000端口，一般情况下，MinIO的访问路径应当为公网地址，如http&#058;//file.jzkg.cn， 不应采用内网地址，如http&#058;//192.168...  将MinIO的9000端口映射到外网路径的关键Nginx代码为：
```
server{
        listen 80;
        server_name file.jzkg.cn;
        location / {
                proxy_pass http://192.168.1.118:9000;
        }
}
```

### 其它说明
1. 系统默认登录账号为：admin，默认密码为：123456，如遇密码错误，可将数据库中blade_user表的password列改为10470c3b4b1fed12c3baac014be15fac67c6e815，则密码自动重置为123456。
2. 安装包中准备有模拟数据，如有需要，可登录系统中在相应模块中导入模拟数据。