协议数字档案馆系统本地部署及核心功能配置落地实操全指南

发布时间: 2026年08月16日 03:00:01 来源: 安答联动浏览量: 0

前置环境准备

所有环境安装包均提供官方稳定版下载地址，无需额外搜索：

JDK11（必选）：Windows版下载地址 https://cdn.azul.com/zulu/bin/zulu11.62.17-ca-jdk11.0.18-win_x64.msi，Linux版下载地址 https://cdn.azul.com/zulu/bin/zulu11.62.17-ca-jdk11.0.18-linux_x64.tar.gz
MySQL8.0（必选）：下载地址 https://cdn.mysql.com/Downloads/MySQL-8.0/mysql-8.0.32-winx64.msi
Redis6.x（必选）：Windows版下载地址 https://github.com/tporadowski/redis/releases/download/v5.0.14.1/Redis-x64-5.0.14.1.msi，Linux版直接执行yum install redis -y即可
协议数字档案馆系统稳定包v1.2.0：下载地址 https://gitee.com/opensource-archive/protocol-archive/releases/download/v1.2.0/protocol-archive-v1.2.0.jar

基础环境部署步骤

1. JDK安装与配置

Windows端：双击安装包完成安装后，右键「此电脑-属性-高级系统设置-环境变量」，系统变量新建JAVA_HOME，值为C:\Program Files\Zulu\zulu11，找到Path变量新增%JAVA_HOME%\bin，打开cmd执行java -version，返回openjdk version "11.0.18"即为配置成功。

Linux端：执行tar -zxvf zulu11.62.17-ca-jdk11.0.18-linux_x64.tar.gz -C /usr/local/，重命名文件夹为jdk11，执行vi /etc/profile，在文件末尾添加如下内容：

``` export JAVA_HOME=/usr/local/jdk11 export PATH=$JAVA_HOME/bin:$PATH ```

保存后执行source /etc/profile，执行java -version验证配置成功。

2. MySQL配置

双击安装包，安装时端口自定义为3307（避免与本地其他MySQL实例冲突），root密码设置为Archive@2024，安装完成后登录MySQL执行建库语句：

``` CREATE DATABASE protocol_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; ```

执行jar xvf protocol-archive-v1.2.0.jar解压系统包，取sql目录下的init.sql文件，执行初始化命令：mysql -u root -pArchive@2024 -P3307 protocol_archive < 你的本地路径/init.sql

3. Redis配置

Windows端：安装完成后打开安装目录下的redis.windows.conf，修改port为6380，requirepass为Redis@2024，重启Redis服务。

Linux端：执行vi /etc/redis.conf，修改port为6380，requirepass为Redis@2024，执行systemctl restart redis重启服务。

协议数字档案馆系统本地部署及核心功能配置落地实操全指南

验证：执行redis-cli -p 6380，输入auth Redis@2024，返回OK即为配置成功。

协议数字档案馆系统部署配置

1. 配置文件编写

在系统jar包同级目录新建application.yml文件，复制以下完整配置，仅需修改storage-path为本地实际存储路径即可：

```yaml server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3307/protocol_archive?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: root password: Archive@2024 redis: host: 127.0.0.1 port: 6380 password: Redis@2024 servlet: multipart: max-file-size: 100MB max-request-size: 100MB archive: 协议文件存储路径，Windows改成本地路径比如D:/archive_storage，Linux改成/data/archive_storage storage-path: /data/archive_storage 自动扫描协议文件的时间间隔，单位分钟 scan-interval: 30 ```

2. 系统启动

Windows端：打开cmd进入jar包所在目录，执行java -jar protocol-archive-v1.2.0.jar，等待30秒启动完成。

Linux端：执行nohup java -jar protocol-archive-v1.2.0.jar > archive.log 2>&1 &后台启动，执行tail -f archive.log查看启动日志无报错即可。

启动完成后访问http://127.0.0.1:8080，默认管理员账号admin，密码Admin@2024，登录成功即为部署完成。

核心功能实操配置

1. 协议自动分类配置

登录后进入「系统设置-分类管理」，点击新增，分类编码填PROTOCOL-001，分类名称填政务合作协议，父分类选根分类，匹配规则填“文件名包含‘政务合作’且后缀为.pdf/.doc/.docx”，勾选自动归档后保存。后续符合规则的文件上传后会自动归入该分类，无需手动整理。

2. 电子签章验证配置

进入「系统设置-签章配置」，上传本单位CA公钥（.cer格式，可从单位CA管理系统导出，测试可使用解压后jar包内cert/test.cer），勾选“上传协议自动校验签章有效性”后保存。后续上传带签章的协议文件，系统会自动核验签章是否伪造、文件是否被篡改。

3. 自动备份配置

进入「系统设置-备份管理」，备份周期选每日凌晨2点，备份路径填和storage-path同盘符的备份目录（比如D:/archive_backup），勾选自动备份到本地+自动上传到单位OSS，填写单位阿里云OSS/MinIO的地址、accessKey、secretKey，测试连通性后保存。系统会自动按周期全量备份归档数据，避免丢失。