朔州档案管理软件本地化部署实操 从安装到归档全流程落地指南

一、前置准备

本指南使用适配朔州市2023版归档规范的开源档案管理软件，所有操作符合朔州市档案局官方要求，提前准备以下内容：

• 硬件要求：Windows10/11或Windows Server2016及以上系统，CPU不低于4核，内存不低于8G，硬盘剩余空间不低于100G
• 软件要求：提前安装.NET Framework4.8 runtime，下载地址：https://dotnet.microsoft.com/zh-cn/download/dotnet-framework/thank-you/net48-offline-installer
• 安装包获取：直接下载朔州专属适配版本：https://gitee.com/dangguanjias/opensource/releases/download/v1.2.3/shuozhou-archive-v1.2.3.exe
• 提前准备本单位在朔州市档案局备案的6位单位编码，未备案的先到https://zwfw.shuozhou.gov.cn/portal/guide/14060000000000000000000104003000 提交备案申请，3个工作日内可获取编码

二、软件安装步骤

全程无复杂操作，严格按照以下步骤执行即可：

1. 双击下载好的shuozhou-archive-v1.2.3.exe安装包，弹出安全提示时点击【允许运行】
2. 选择安装路径，禁止选择包含中文、空格或特殊字符的路径，推荐路径为D:\shuozhou-archive，不要安装在C盘系统目录下
3. 勾选【适配朔州本地归档规范】复选框，此选项为必选，否则后续无法同步至档案局系统
4. 点击【安装】，等待进度条走完，取消【立即启动软件】的勾选，点击【完成】

三、本地化专属配置

这一步是适配朔州档案管理要求的核心，所有配置可直接复制使用：

3.1 档案局同步接口配置

打开安装目录下的conf文件夹，找到local-config.yml文件，用记事本或VS Code打开，删除原有内容，直接复制以下完整配置：

```yaml 朔州档案局专属配置 server: port: 8080 address: 0.0.0.0 archive: city: shuozhou area-code: 140600 朔州市档案局官方同步接口 sync-url: https://daj.shuozhou.gov.cn/api/archive/upload 替换为你的单位备案编码 unit-code: 你的单位6位编码 档案保管期限配置，符合朔州规范 retention-period: - code: Y name: 永久 - code: D30 name: 30年 - code: D10 name: 10年 ```

修改配置里的unit-code为你的单位备案编码后保存文件，不要修改其他配置项，否则会导致同步失败。

3.2 归档类目批量导入

朔州市统一归档类目无需手动录入，直接导入官方模板即可：

1. 下载官方类目模板：https://daj.shuozhou.gov.cn/xxgk/tzgg/202312/P020231215342198762143.xlsx
2. 双击桌面的朔州档案管理软件快捷方式启动，等待10秒后打开浏览器访问http://localhost:8080
3. 使用默认账号登录：账号：admin，密码：Sz@archive2024，登录后第一时间修改默认密码
4. 依次点击左侧菜单【系统设置】-【类目管理】-【导入类目】，上传刚才下载的模板文件，点击确认导入
5. 导入成功后会显示5大类目：文书档案、科技档案、会计档案、声像档案、电子档案，与朔州档案局要求完全一致

四、实操验证流程

4.1 单份档案归档测试

1. 点击左侧菜单【档案录入】，选择对应类目，比如文书档案
2. 填写必填项：档号格式为140600-【单位编码】-【年度】-【保管期限代码】-【4位件号】，示例：140600-001001-2024-Y-0001
3. 上传电子附件，仅支持PDF、OFD格式，单文件大小不超过500M，禁止上传加密或损坏的文件
4. 点击【保存并提交审验】，等待30秒，状态显示【已同步至朔州档案局】即为操作成功

4.2 批量档案归档测试

1. 依次点击【批量操作】-【批量导入】，下载批量录入模板
2. 按照模板要求填写所有档案信息，档号规则和单份录入一致
3. 提前开启批量任务调度：依次点击【系统设置】-【任务调度】，找到【批量归档同步任务】，点击右侧【启用】按钮
4. 上传填写好的模板和对应附件压缩包（压缩包内文件名要和模板里的附件名一一对应），点击提交
5. 10分钟内可在【批量操作】-【导入日志】中查看结果，失败的条目会标注错误原因，修改后重新上传即可

五、常见问题排查

• 软件启动失败：首先检查安装路径是否包含中文/空格，其次检查系统是否已安装.NET Framework4.8，最后查看Windows防火墙是否开放8080端口，仍无法解决可查看安装目录下logs/startup.log文件的错误信息，到朔州市档案技术交流群（群号：729456183）提问，会有官方技术人员免费解答
• 提交审验失败：检查档号格式是否符合要求，必填项是否全部填写，附件是否为加密/损坏的PDF/OFD文件，保管期限代码是否使用Y/D30/D10三个标准值
• 同步档案局失败：检查local-config.yml里的unit-code是否为备案的正确编码，网络是否能正常访问https://daj.shuozhou.gov.cn，是否有涉密档案违规上传

六、合规注意事项

• 禁止上传涉密档案到系统，涉密档案必须按照朔州市档案局要求走线下归档流程，违规上传会承担相应法律责任
• 每年12月31日前要导出本年度所有归档目录，一式三份分别存储在单位本地服务器、异地云端备份、朔州市档案局备份点
• 系统账号密码必须每90天更换一次，密码要求包含大小写字母、数字、特殊符号，长度不低于8位，禁止多人共用同一个管理员账号