档案软件数据审计全流程实操指南 从配置到出报告零门槛落地

一、前置准备（操作前必须完成）

本次操作用开源合规的ArchivalAudit v1.2工具，符合《档案管理软件功能要求暂行规定》审计要求，下载地址：https://github.com/archival-project/archival-audit/releases/tag/v1.2，根据系统选择对应安装包（Windows选win-x64免安装版，Linux选linux-x64版）。

1.1 环境与权限要求

• Windows：Win10及以上，无需额外依赖，免安装包直接解压即可
• Linux：CentOS7/Ubuntu20.04及以上，提前安装JDK11，安装命令：apt install openjdk-11-jdk（Ubuntu）或yum install java-11-openjdk（CentOS）
• 权限准备：提前向运维申请档案软件数据库的只读账号，仅授予select权限，以及档案软件近180天的操作日志导出权限，所有操作需提前获得单位信息化部门授权

二、数据源对接配置

2.1 编写配置文件

解压工具包后，在根目录新建config.yaml文件，复制以下完整配置，仅需修改对应参数即可：

```yaml 档案软件数据源配置 datasource: type: mysql 可选值mysql/oracle/postgresql，对应你的档案软件数据库类型 host: 192.168.1.100 替换为你的档案软件数据库实际IP port: 3306 mysql默认3306，oracle默认1521，postgresql默认5432 dbname: archival_db 替换为档案业务库实际库名 username: audit_read 替换为申请的只读审计账号 password: Audit@2024 替换为只读账号实际密码 审计规则配置（可根据单位要求调整） audit-rule: abnormal_time: [1,5] 异常操作时段，默认凌晨1点到5点 batch_delete_threshold: 10 批量删除超过10条触发异常告警 batch_update_threshold: 20 批量修改超过20条触发异常告警 secret_file_access_need_approval: true 涉密档案访问需匹配审批记录，无审批则标记异常 输出配置 output: dir: ./output 审计结果输出目录，无需修改 save_days: 180 审计记录留存天数，符合档案规范要求 ```

2.2 配置有效性校验

在工具根目录打开终端/命令提示符，执行以下校验命令：

• Windows：.\validate.bat config.yaml
• Linux：./archival-audit validate config.yaml

返回“配置校验通过”则进入下一步，若报错按以下方法排查：

• 提示“数据库连接失败”：执行telnet [数据库IP] [端口]检查端口是否通，不通则找运维放开审计工具IP的数据库访问权限
• 提示“权限不足”：检查只读账号是否开通了档案业务库、information_schema库的select权限

三、全量数据审计执行

3.1 启动审计任务

执行以下命令启动审计：

• Windows：.\start.bat config.yaml
• Linux：nohup ./archival-audit run config.yaml > audit.log 2>&1 &

100万条以下档案数据10分钟内可完成，数据量超过500万条可追加参数--thread 8开启8线程提速，执行后可查看audit.log文件看实时进度，进度条到100%即为完成。

3.2 异常数据筛查

审计完成后会在output目录生成3个核心文件：

• abnormal_operation.csv：所有异常操作记录，包含操作人、操作时间、操作内容、IP地址
• data_inconsistency.csv：数据不一致记录，比如档案元数据缺失、附件与元数据不匹配、档案编号重复
• unauthorized_access.csv：未授权访问记录，包含访问人、访问的涉密档案名称、无审批记录的佐证

重点核对优先级：批量删除/修改操作、非工作时段管理员操作、涉密档案无审批访问记录，以上为高风险异常项，必须逐一核实

四、审计结果校验与报告生成

4.1 误报排除

若工具标记的异常为正常操作（比如凌晨的定期备份、经授权的批量数据修正），可执行以下命令标记为误报，避免出现在最终报告中：

./archival-audit mark --id [异常记录ID] --tag 误报 --remark "备注说明，比如定期备份操作"

所有核实后的异常项需留存对应佐证材料（操作日志截图、审批工单、操作人员说明），放到工具根目录的evidence文件夹，工具会自动关联到对应异常条目。

4.2 生成标准化审计报告

执行以下命令即可生成符合国家档案局规范的正式审计报告：

./archival-audit report --template official

生成的Word报告存放在output/report目录，自动包含异常统计、风险等级划分、整改建议，无需手动排版。若需要自定义单位抬头、logo，直接修改template目录下的official.docx模板即可，下次生成自动生效。

常见卡壳问题排查

• 审计任务中途中断：查看audit.log报错，若为内存不足，修改start.bat/start.sh中的JVM参数，把-Xmx1g改为-Xmx4g后重新启动即可
• 报告生成乱码：Windows系统执行命令时追加参数--encoding gbk，即可正常显示中文
• 涉密档案审计异常多：检查配置文件中的secret_file_access_need_approval参数，若单位无涉密档案审批流程可改为false，关闭该规则

合规提示：所有审计操作禁止使用可写权限的数据库账号，避免误修改档案业务数据，审计记录需留存至少180天备查