企业电子档案系统技术支持：日常运维与故障排查实操指南

一、前置准备工具与信息收集

开展技术支持操作前，先完成工具安装和信息收集，所有工具均为免费可直接下载使用：

• 远程连接服务器工具Xshell：直接访问下载地址 https://www.netsarang.com/zh/xshell-download/ 选择免费授权版安装即可
• 数据库连接工具Navicat：直接访问下载地址 https://www.navicat.com.cn/download 选择试用版即可满足日常操作需求

提前向档案系统管理员收集以下4项核心信息，避免操作卡壳：

• 档案系统部署服务器的SSH登录IP、账号密码
• 档案系统元数据存储数据库的连接地址、库名、账号密码
• 档案实体文件存储的服务器绝对路径
• 系统管理员后台的登录地址、超级管理员账号

二、日常常规技术支持实操步骤

1. 用户权限与账号问题处理

这类问题占日常技术支持请求的60%以上，按以下步骤操作即可1分钟解决：

• 打开管理员后台地址，用超级管理员账号完成登录
• 依次进入 系统管理-用户管理，搜索对应用户名，点击编辑按钮
• 先检查用户状态：如果显示为「锁定」，点击解锁；如果忘记密码，直接重置为默认密码 Archive@2024，可根据单位要求修改
• 再进入权限配置栏，检查是否勾选对应档案的查阅、下载、上传权限，勾选后点击保存，权限实时生效，不需要重启系统

2. 档案上传失败问题处理

根据前端提示即可定位解决：

• 如果提示「文件大小超出限制」：登录后台后进入 系统设置-上传设置，修改最大允许上传大小（单位为MB），修改后保存刷新页面即可生效，不需要重启服务
• 如果提示「文件格式不支持」：在同一上传设置页面，添加提示中不支持的后缀名（如ofd、rar、zip），保存后即可正常上传

三、常见核心故障排查实操步骤

1. 系统完全无法访问故障

按以下步骤逐步排查，所有命令可直接复制修改后使用：

1. 打开Xshell连接档案系统部署的服务器，输入账号密码登录
2. 执行命令检查对应端口（默认8080，替换为你实际的端口）是否正常监听： ``` netstat -tunlp | grep 8080 ``` 如果输出为空，说明服务已经停止，执行以下命令启动服务： ``` 替换为你实际的部署目录 cd /opt/archive-system 后台启动服务，输出日志到log.out nohup java -jar archive-system.jar --spring.profiles.active=prod > ./log.out 2>&1 & ``` 等待10秒后重新执行端口检查命令，有输出说明启动成功
3. 如果端口正常监听但仍无法访问，说明是防火墙拦截，执行以下命令开放端口： ``` 替换8080为你实际的端口 firewall-cmd --zone=public --add-port=8080/tcp --permanent firewall-cmd --reload ``` 执行完成后即可正常访问

2. 档案文件下载损坏故障

这类故障一般是文件丢失或存储校验不匹配，按以下步骤处理：

• 在后台档案管理页打开出错档案的详情页，记录档案ID和文件存储路径，一般格式为 /data/archive/files/2024/xxx.ofd
• 登录服务器，执行命令检查文件是否存在：ls -l 你记录的文件完整路径，如果输出「No such file or directory」说明文件丢失，需要从备份恢复
• 如果文件存在，对比数据库存储的哈希值校验文件完整性，打开Navicat连接数据库，执行以下查询语句： ```sql SELECT file_name,file_hash FROM archive_file WHERE id = '替换为你的档案ID'; ``` 然后在服务器执行命令计算文件实际哈希： ``` md5sum 你记录的文件完整路径 ``` 对比两个哈希值，如果不一致，重新上传该档案即可解决问题

四、核心数据备份与恢复实操

档案系统技术支持的核心底线是数据安全，按以下步骤配置自动备份，故障后可快速恢复：

1. 配置自动定时备份

将以下脚本直接复制，修改开头的配置信息后保存，即可实现自动备份：

``` !/bin/bash 档案系统自动备份脚本，修改以下配置为你的实际信息 DB_USER="你的数据库账号" DB_PWD="你的数据库密码" DB_NAME="你的档案库名" FILE_STORAGE_PATH="/data/archive/files" BACKUP_PATH="/data/backup/archive" DATE=`date +%Y%m%d` 创建备份目录 mkdir -p $BACKUP_PATH 备份数据库 mysqldump -u$DB_USER -p$DB_PWD $DB_NAME > $BACKUP_PATH/archive_db_$DATE.sql 打包文件存储目录 tar -zcf $BACKUP_PATH/archive_files_$DATE.tar.gz $FILE_STORAGE_PATH 删除7天前的旧备份，避免占用过多磁盘空间 find $BACKUP_PATH -mtime +7 -name ".gz" -delete find $BACKUP_PATH -mtime +7 -name ".sql" -delete ```

脚本保存为 /opt/archive-backup.sh 后，执行以下命令配置每天凌晨2点自动备份：

``` 赋予脚本执行权限 chmod +x /opt/archive-backup.sh 打开定时任务编辑 crontab -e ```

在打开的编辑页面末尾添加一行内容，保存退出即可：0 2 /bin/bash /opt/archive-backup.sh

2. 数据恢复实操步骤

• 恢复数据库：将备份的sql文件上传到服务器，执行命令恢复： ``` mysql -u你的数据库账号 -p你的数据库密码 你的库名 < /path/to/你的备份sql文件路径 ```
• 恢复文件存储：将备份的压缩包解压到原根目录即可： ``` tar -zxf /path/to/你的备份压缩包路径 -C / ```

注意：所有修改操作执行前，需要先手动备份当前最新数据，避免操作出错导致数据丢失。