昭通本地企事业单位档案管理软件本地化部署实操全流程指南

一、前期准备

所有物料均为公开可获取资源，无需额外付费采购，按要求准备即可避免后续卡壳。

1.1 硬件环境要求

• 10人以内小规模单位：普通办公电脑即可，配置要求为CPU i5 10代及以上、内存16G、2T SSD固态（用于存储档案扫描件，读写速度比机械盘高3倍以上）
• 50人以上中大规模单位：推荐用机架式服务器，配置要求为2颗Xeon Silver 4210 CPU、32G内存、4T机械盘做RAID1阵列（保证单块硬盘损坏时数据不丢失）

1.2 软件依赖准备

所有依赖均为官方正版，直接点击链接下载即可：

• 操作系统：Windows Server 2019 标准版，单位已有服务器可直接复用
• JDK11：https://jdk.java.net/java-se-ri/11
• MySQL8.0：https://dev.mysql.com/downloads/mysql/8.0.html
• Redis 6.2：https://github.com/tporadowski/redis/releases/download/v6.2.6/Redis-x64-6.2.6.msi

二、软件安装部署步骤

所有步骤按顺序操作，每一步完成后做验证再进入下一步。

2.1 基础依赖安装配置

第一步：安装配置JDK11

运行JDK安装包，默认安装到C:\Program Files\Java\jdk-11路径，之后右键此电脑-属性-高级系统设置-环境变量-系统变量，新建变量名JAVA_HOME，值填C:\Program Files\Java\jdk-11，再编辑Path变量，新增%JAVA_HOME%\bin。打开cmd输入命令验证：

``` java -version ```

输出openjdk version "11"即为配置成功。

第二步：安装配置MySQL8.0

运行MySQL安装包，选择默认 Developer Default 配置，root密码设置为Zhaotong@2024（符合密码复杂度要求，避免后续权限报错）。安装完成后打开cmd执行以下命令创建专属档案库：

``` mysql -u root -pZhaotong@2024 CREATE DATABASE archive_zt DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; exit ```

第三步：安装配置Redis

运行Redis安装包，勾选“Add Redis to PATH environment variable”选项，默认安装即可。打开cmd输入命令验证：

``` redis-cli ping ```

返回PONG即为安装成功。

2.2 档案管理软件安装

采用符合国家《电子档案管理系统通用功能要求》的开源版本，下载地址：https://gitee.com/rosefinch-project/rosefinch-archive/releases/download/v2.3.0/rosefinch-archive-2.3.0.zip

下载后直接解压到D盘根目录，路径为D:\rosefinch-archive，找到D:\rosefinch-archive\config\application-prod.yml配置文件，删除原有内容，直接复制以下完整配置：

``` server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/archive_zt?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8 username: root password: Zhaotong@2024 driver-class-name: com.mysql.cj.jdbc.Driver redis: host: 127.0.0.1 port: 6379 password: '' servlet: multipart: max-file-size: 100MB max-request-size: 200MB file: uploadPath: D:/archive_file/ ```

保存配置文件后，找到D:\rosefinch-archive\bin\startup.bat双击运行，等待30秒后打开浏览器输入http://127.0.0.1:8080，默认账号admin，默认密码Admin@123456，能正常登录即为安装成功。

三、昭通本地化适配配置

这一步是核心，配置完成后完全符合昭通市档案局的归档、移交要求，无需额外调整。

3.1 归档目录配置

登录系统后进入系统管理-目录管理-批量导入，打开昭通市档案局官网http://daj.zt.gov.cn，进入政务服务-下载专区，找到《昭通市机关档案分类目录模板》下载，直接导入系统即可，无需手动创建目录。

3.2 电子档案格式适配

进入系统设置-归档设置-格式校验，勾选以下昭通标准允许的格式：扫描件为PDF/A格式、文字材料为docx/xlsx、照片为JPG/PNG、视频为MP4，单文件大小限制设为100MB，保存配置即可。

3.3 档案移交对接配置

进入系统设置-对接配置，接口地址填昭通市电子档案移交系统官方地址http://222.220.16.118:8090/archive-transfer，单位编码填你单位在昭通档案局备案的6位编码，对接密钥联系档案局对应业务对接人索要，填完后点击测试连接，提示成功即可直接在线移交档案，无需线下跑大厅。

四、上线前验证

4.1 功能测试

新建一份测试文书档案，上传PDF/A格式的测试文件，录入文号、年度、保管期限、归档部门等必填项，保存后用检索功能输入文号，能正常搜索到即为基础功能正常。

4.2 权限配置

进入系统管理-用户管理-新建用户，给档案管理员分配全权限，给普通员工分配本部门档案上传、全库检索权限，测试普通用户无法删除、修改其他部门档案，符合安全要求。

4.3 备份配置

进入系统设置-备份设置，开启自动备份，备份频率选每天凌晨2点，备份路径设为D:/archive_backup/，同时开启异地备份，每周五自动将备份文件同步到单位云盘或者外接移动硬盘，避免数据丢失。

五、常见问题排查

• 登录页面打不开：首先检查startup.bat窗口是否有端口占用报错，若有则修改application-prod.yml里的port为8081再重启；其次检查防火墙是否开放对应端口，打开控制面板-Windows Defender防火墙-高级设置-入站规则-新建规则，开放对应端口即可。
• 导入档案提示格式错误：检查是否使用昭通标准目录模板，必填字段是否缺失，保管期限是否为永久/30年/10年三个标准值，不能填写其他内容。
• 移交档案到档案局失败：检查单位编码、密钥是否正确，本地网络是否能ping通222.220.16.118，档案是否有缺必填字段、格式是否符合要求。

按以上流程操作完成后，系统即可正常投入使用，完全符合昭通本地档案管理规范。