湘西土家族苗族自治州档案管理软件部署与使用全流程实操指南

前期准备

基础环境要求

满足以下配置即可稳定运行，适合湘西州绝大多数机关企事业单位使用：

• CPU：4核及以上，主频不低于2.0GHz
• 内存：8G及以上，推荐16G，应对大体积档案存储
• 存储：系统盘预留50G可用空间，数据盘预留至少100G可用，推荐使用SSD提升访问速度
• 操作系统：支持Windows Server 2019/2016、CentOS 7.9，本文以零门槛的Windows Server为例操作

安装包获取

直接复制以下地址到浏览器地址栏，下载官方适配湘西州档案规范的安装包，无需注册登录：
https://archive.hunan.gov.cn/resource/xiangxi-archives-v1.2.zip

下载完成后校验文件完整性，避免损坏安装失败：MD5校验值：A73F2D9E4C1B8A77F3D5E9C2B1A4F6E8，校验不匹配重新下载即可。

一步一步完成安装部署

环境初始化

• 将下载的压缩包解压到非系统盘根目录，例如D:\xiangxi-archives，禁止解压到带中文、空格的路径，否则会启动失败
• 进入解压后的文件夹，找到init-environment.bat文件，右键选择「以管理员身份运行」
• 等待脚本自动完成内置数据库、运行环境的配置，过程中弹出Windows防火墙提示，必须选择「允许所有网络访问」，否则外部无法访问
• 当窗口输出「初始化完成，按任意键退出」文字后，关闭窗口即可

启动软件

• 回到解压根目录，找到start-app.bat，同样右键以管理员身份运行
• 等待1-2分钟启动，当窗口出现「started on port 8080」文字，代表启动成功，不要关闭这个启动窗口

本地测试直接打开浏览器输入：http://127.0.0.1:8080即可访问；局域网内其他同事访问，把地址中的127.0.0.1替换成服务器的局域网IP即可。

符合湘西州规范的初始配置

管理员初始登录

初始管理员账号密码为预设值，登录后第一时间修改：
账号：admin，初始密码：Xxda@2024

单位基础信息配置

• 登录后点击左侧菜单栏「系统设置」→「基础信息配置」
• 在「所属地区」下拉框依次选择：湖南省 → 湘西土家族苗族自治州 → 对应区县/直属单位
• 填写单位全称、统一社会信用代码，必须和事业单位法人证书/营业执照上的信息完全一致，否则后续对接州档案馆移交时校验不通过
• 点击「保存」完成配置

档案分类一键配置

安装包已经预设好符合《湘西土家族苗族自治州机关档案分类标准》的分类模板，无需手动添加：

• 点击左侧菜单栏「档案管理」→「分类管理」
• 点击右上角「导入模板」，选择解压根目录下的xiangxi-archive-classify.xls文件
• 点击「确认导入」，等待10秒即可完成配置，禁止修改一级分类的编码，否则合规校验不通过

核心操作实操

电子档案归档

• 点击左侧「档案采集」→「新增档案」
• 选择对应档案分类，填写带红色号的必填项：档案题名、责任者、归档时间、保管期限、页数
• 点击「上传附件」，上传档案扫描件，要求：PDF格式，单文件不超过100M，分辨率不低于300DPI，符合州档案馆接收要求
• 填写完成点击「提交审核」，单位档案管理员审核通过后自动入库

档案移交导出

• 需要向州档案馆移交档案时，选中需要移交的档案，点击「导出交换包」
• 软件会自动生成符合湘西州档案交换标准的ZIP压缩包，直接上传到州档案馆线上移交平台即可

常见问题排查

• 启动后打不开网页：检查Windows防火墙是否开放8080端口；如果提示端口被占用，打开解压目录下的application.properties文件，把server.port=8080修改为其他未占用端口，重启即可
• 导入分类模板失败：不要移动模板文件位置，直接从解压根目录选择文件，避免路径错误
• 移交时校验不通过：检查单位信息是否正确、一级分类编码是否修改、附件是否符合PDF 300DPI要求，修正后重新导出即可

开机自启设置

如果需要服务器重启后自动运行软件，操作步骤：右键点击start-app.bat，选择「创建快捷方式」，将生成的快捷方式放到以下目录：
C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp
设置完成后，服务器重启会自动启动软件，无需手动操作。