神农架林区档案管理软件本地部署与日常使用实操全指南

一、前置准备

本指南针对神农架林区档案馆官方发布的通用档案管理软件，全程零代码基础可落地，所有资源均来自官方公开渠道，具体准备项如下：

1.环境要求与基础依赖安装

最低配置要求：2核CPU/4G内存/500G可用存储，支持银河麒麟V10、Ubuntu 22.04两类国产/开源系统，以下为Ubuntu系统下的依赖安装命令，直接复制执行即可：

```
更新源并安装MySQL 8.0
sudo apt update && sudo apt install mysql-server openjdk-11-jdk -y
初始化MySQL安全配置
sudo mysql_secure_installation
```

2.软件包下载

直接打开神农架林区档案馆官方下载地址获取安装包：http://jgdaj.snjl.gov.cn/col/col13129/index.html，下载最新版安装压缩包snjl-archive-manage.tar.gz即可。

二、本地部署步骤（一步一操作，无省略）

1.解压与基础配置

• 将下载好的压缩包移动到系统/opt目录，执行以下命令解压：

  ```
  sudo mv ~/Downloads/snjl-archive-manage.tar.gz /opt/
  cd /opt/
  sudo tar -zxvf snjl-archive-manage.tar.gz
  cd snjl-archive-manage
  ```
  

• 创建数据库，执行以下命令，按提示输入MySQL root密码后，直接复制完整SQL执行：

  ```
  sudo mysql -u root -p
  ```
  

  ```
  CREATE DATABASE snjl_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
  CREATE USER 'snjl_archive'@'localhost' IDENTIFIED BY '你自定义的数据库密码';
  GRANT ALL PRIVILEGES ON snjl_archive. TO 'snjl_archive'@'localhost';
  FLUSH PRIVILEGES;
  exit;
  ```
  

• 修改项目配置文件，打开当前目录下的application.yml，替换为以下完整内容，修改对应密码即可：

  ```
  spring:
  datasource:
  driver-class-name: com.mysql.cj.jdbc.Driver
  url: jdbc:mysql://localhost:3306/snjl_archive?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai
  username: snjl_archive
  password: 这里替换成你刚才自定义的数据库密码
  server:
  port: 8080
  ```
  

2.启动服务与验证

执行以下命令启动服务，开放防火墙端口，完成部署：

```
后台启动服务
nohup java -jar snjl-archive-manage.jar --spring.config.location=./application.yml &
开放8080端口供访问
sudo ufw allow 8080/tcp
```

验证部署：在浏览器输入服务器IP:8080，能打开登录页即为部署成功，默认管理员账号：admin，默认密码：admin123，第一次登录必须修改密码。

三、日常档案操作实操

1.档案分类配置（符合神农架林区档案分类标准）

• 登录后点击左侧菜单档案管理>档案分类，点击右上角「新增分类」
• 按要求填写：分类编码（例如文书档案填WS）、分类名称、保管期限默认选项，点击保存即可，建议提前对照《神农架林区档案分类规范》预设好全部分类。

2.档案录入（单份+批量）

• 单份录入：点击左侧菜单档案管理>档案录入，选择已创建的分类，填写必填项：档号、题名、责任者、成文日期、保管期限，点击「上传附件」上传PDF格式的档案扫描件（单文件不超过100M），点击保存即可完成录入。
• 批量录入：点击页面右上角「下载模板」，按照模板格式填写所有档案信息，保存后点击「批量导入」，上传填好的Excel文件，系统会自动完成批量录入，出错会给出提示，修改后重新上传即可。

3.档案查询与借阅

查询：在首页搜索栏输入档号、题名、责任者任意关键词，点击搜索即可调出对应档案，支持多条件筛选。借阅：选中需要借阅的档案，点击「申请借阅」，填写借阅人信息和借阅期限，提交后由管理员审核通过即可下载电子档。

四、日常备份与常见问题排查

1.自动备份设置（必须操作，防止数据丢失）

在部署目录创建备份脚本backup-archive.sh，复制以下内容，修改数据库密码后保存：

```
!/bin/bash
BACKUP_DIR=/data/backup/snjl-archive
DATE=$(date +%Y%m%d_%H%M%S)
mkdir -p $BACKUP_DIR
mysqldump -usnjl_archive -p'你的数据库密码' snjl_archive > $BACKUP_DIR/snjl_archive_$DATE.sql
find $BACKUP_DIR -name ".sql" -mtime +30 -delete
```

执行以下命令添加执行权限和定时任务，实现每天凌晨2点自动备份，自动删除30天前的旧备份：

```
chmod +x /opt/snjl-archive-manage/backup-archive.sh
crontab -e
在打开的编辑页末尾添加一行，保存退出即可
0 2    /opt/snjl-archive-manage/backup-archive.sh
```

2.常见问题排查

• 服务启动失败：执行sudo lsof -i:8080查看端口是否被占用，执行sudo kill -9 进程ID杀掉占用进程后重新启动；检查配置文件中的数据库密码是否和创建的一致。
• 附件上传失败：执行df -h查看服务器存储，剩余不足10G清理无用文件；检查附件大小，超过100M拆分PDF后重新上传。
• 管理员密码忘记：登录MySQL执行以下命令，即可重置密码为admin123：

  ```
  UPDATE snjl_archive.sys_user SET password='21232f297a57a5a743894a0e4a801fc3' WHERE username='admin';
  ```