科研管理系统v3.0部署手册

## 简介
（1）本系统为锦中集团内部产品-《锦中科研管理系统》，该手册请勿外泄！
（2）系统采用锦中内部框架 ObjectPlus、Saber 编写，数据库可支持 MySQL、达梦等数据库，中间件使用Redis。
（3）本系统支持 Windows 环境及 Linux 环境下运行，建议在 Linux 环境下运行。
## 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 （或以上版本）
### 用户端软件配置要求
浏览器：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)
#### 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/keyan/keyan.jar，则将license.xml放在/home/jzjt/keyan/jzconfig/license.xml ，注意Linux系统区分大小写，默认license.xml 均小写。
### 数据库初始化
#### 系统数据库初始化
1.创建 科研管理系统 数据库（如：keyan）
2.执行数据库初始化脚本 keyan.sql

### 部署系统后端服务
1、keyan.jar、application.yml上传到服务器 如：/home/jzjt/keyan下（参考）
2、修改 application.yml 对应配置信息
**如：**
**Redis相关配置**
![](/media/202508/2025-08-11_154930_227323.png)
**关系型数据库相关配置**
![](/media/202602/2026-02-06_091057_315990.png)
**注意：**不同类型数据库有不同的驱动、不同的url前缀，如达梦：url: jdbc:dm//xxx:xxx ，这里是mysql
**minio配置**
注意：在锦中科研管理系统中有对象存储模块，填写新增表单保存即可。其中配置minio所需的访问key和秘钥可以在minio控制台进行获取。
**创建访问key和秘钥的方式：**minio 启动后 控制台 默认端口为7000，访问服务器ip: 7000， 进行key和秘钥的创建
![](/media/202503/2025-03-12_143440_643724.png)
minio 启动后 资源访问的 默认端口为 9000
![](/media/202503/2025-03-12_135909_455936.png)
**License配置** 修改为自己存放License的目录即可
![](/media/202602/2026-02-06_095348_178546.png)
#### 执行启动脚本（保证配置文件与keyan.jar在同一目录下，且在keyan.jar下执行该命令）
```shell
nohup java -jar --add-opens java.base/java.lang=ALL-UNNAMED -Dfile.encoding=UTF-8 -Duser.timezone=Asia/Shanghai keyan.jar > /dev/null 2>&1 &
```
#### 也可创建/etc/systemd/system/keyan.service 文件，填入对应的配置，使用systemctl start keyan 命令对科研后台进行启动，ExecStart如下
```shell
ExecStart=/usr/local/jdk-17.0.14/bin/java（java安装的绝对路径） --add-opens java.base/java.lang=ALL-UNNAMED -Dfile.encoding=UTF-8 -Duser.timezone=Asia/Shanghai -jar /home/jzjt/keyan/keyan.jar --spring.config.additional-location=/home/jzjt/keyan/application.yml（外部配置文件绝对路径）
```
### 部署系统前端站点服务
上传标准安装包中的前端文件到服务器的对应目录中

![](/media/202508/2025-08-11_155049_160952.png)
#### 配置nginx代理
```shell
http {
    include       mime.types;
    default_type  application/octet-stream;
    client_max_body_size 20M;
    sendfile        on;
    keepalive_timeout  65;
    server {
        listen       80; // 填写你的监听端口
        server_name  192.168.1.117; // 你的服务器ip地址
        location / {
            root   /home/jzjt/keyan/dist;  //dist为前端文件的命名
            index  index.html index.htm;
            try_files $uri $uri/ /index.html;
        }
        location /api/ {
            proxy_pass   http://192.168.1.117:7099; // 你的后端启动在服务器的ip和端口
            rewrite ^/api/(.*) /$1 break;
            index  index.html index.htm;
        }
        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   html;
        }
    }
}
```
## 3.安装步骤（不使用Nginx作为Web服务器）
#### 根据步骤2，此时前后端安装包以及配置文件都在 /home/jzjt/keyan/ 目录下。
不使用Nginx只需修改application.yml，添加：
**deploying-with-nginx: false
#static-locations: file:./static/**
配置前端文件存放目录，（默认keyan.jar同级目录下的static文件夹）
![](/media/202602/2026-02-06_100105_602405.png)
#### 执行启动脚本（保证配置文件与keyan.jar在同一目录下，且在keyan.jar下执行该命令）
```shell
nohup java -jar --add-opens java.base/java.lang=ALL-UNNAMED -Dfile.encoding=UTF-8 -Duser.timezone=Asia/Shanghai keyan.jar > /dev/null 2>&1 &
```
### 其他说明：
1、系统默认登录账号为：admin，默认密码为：**www.jzkg.cn** ，如遇密码错误，可将数据库中 blade_user 表的 password 列改为 10688ef64e1d14f0e86facaa220212cb8cedb2b0 ，则密码自动重置为 **www.jzkg.cn**
2、部署成功之后，如果想要通过excel导入模拟数据，需要注意模拟数据中职工号的填充，职工号对应的是科研队伍中科研人员的职工号，因此需要先添加科研人员，详细看安装包中的导入说明。