陵水黎族自治县档案管理软件部署与配置全流程实操指南

一、部署环境准备与软件安装

在开始部署档案软件前，必须确保服务器环境满足最低要求，这是后续所有操作稳定运行的基础。

1.1 服务器硬件与操作系统要求

建议使用一台独立的物理服务器或性能足够的虚拟机。最低配置要求为：4核CPU、8GB内存、500GB可用硬盘空间（用于存储档案数据）。操作系统推荐使用 Ubuntu Server 20.04 LTS 或 CentOS 7.9，它们拥有长期支持且社区资源丰富。

使用以下命令更新系统并安装基础依赖包：

``` sudo apt-get update && sudo apt-get upgrade -y Ubuntu/Debian sudo yum update -y && sudo yum install -y epel-release CentOS/RHEL ```

1.2 安装数据库与运行环境

本指南以MySQL作为数据库，Java作为后端运行环境。请按顺序执行以下命令。

安装MySQL数据库：

``` Ubuntu/Debian sudo apt-get install -y mysql-server sudo systemctl start mysql sudo systemctl enable mysql CentOS/RHEL sudo yum install -y mysql-server sudo systemctl start mysqld sudo systemctl enable mysqld ```

安装完成后，运行安全初始化脚本并设置root密码：

``` sudo mysql_secure_installation ```

按照提示操作，建议设置一个强密码并移除匿名用户、禁止root远程登录。

安装Java运行环境：档案软件通常基于Java开发，需要安装JDK 8或JDK 11。

``` Ubuntu/Debian 安装 OpenJDK 11 sudo apt-get install -y openjdk-11-jdk CentOS/RHEL 安装 OpenJDK 11 sudo yum install -y java-11-openjdk-devel ```

验证安装：java -version。

二、档案软件核心组件部署

假设您已获得软件安装包（通常为 `dangan-v2.1.0.zip` 格式的压缩包）。

2.1 解压与目录规划

创建一个专用的应用目录，将软件包上传至此并解压。

``` sudo mkdir -p /opt/ling-shui-archive 假设安装包已上传至用户家目录 sudo unzip ~/dangan-v2.1.0.zip -d /opt/ling-shui-archive/ cd /opt/ling-shui-archive ```

检查解压后的目录结构，通常包含以下关键部分：

• bin/：启动和停止脚本。
• config/：所有配置文件。
• lib/：程序依赖的jar包。
• logs/：日志目录（首次启动后生成）。

2.2 数据库初始化

使用MySQL命令行，为档案软件创建专用的数据库和用户。

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

在MySQL提示符下，执行以下SQL语句（请将 `your_strong_password` 替换为实际密码）：

``` CREATE DATABASE ling_shui_archive_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'archive_user'@'localhost' IDENTIFIED BY 'your_strong_password'; GRANT ALL PRIVILEGES ON ling_shui_archive_db. TO 'archive_user'@'localhost'; FLUSH PRIVILEGES; EXIT; ```

导入软件包中提供的数据库初始化脚本：

``` mysql -u archive_user -p ling_shui_archive_db < /opt/ling-shui-archive/config/init_database.sql ```

2.3 配置文件修改

这是最关键的一步，连接数据库和配置系统参数。编辑主配置文件：

``` sudo nano /opt/ling-shui-archive/config/application.yml ```

找到数据库连接部分，修改为以下内容，确保与您创建的数据库信息完全一致：

``` spring: datasource: url: jdbc:mysql://localhost:3306/ling_shui_archive_db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: archive_user password: your_strong_password driver-class-name: com.mysql.cj.jdbc.Driver ```

找到服务器端口和文件存储路径配置部分：

``` server: port: 8080 可根据需要修改，确保防火墙开放此端口 archive: file: storage-path: /opt/ling-shui-archive/data/files 档案电子文件存储目录，请确保此目录存在且有写权限 ```

保存并退出编辑器（在nano中按Ctrl+X，然后按Y确认，最后按Enter）。

创建并授权存储目录：

``` sudo mkdir -p /opt/ling-shui-archive/data/files sudo chown -R $(whoami):$(whoami) /opt/ling-shui-archive/ 将目录所有者改为当前用户，方便管理 ```

三、启动服务与防火墙配置

3.1 启动档案管理服务

进入软件目录，使用提供的脚本启动服务。

``` cd /opt/ling-shui-archive/bin ./startup.sh ```

检查服务是否成功启动：

``` ps aux | grep java 应能看到一个包含主类名的Java进程 tail -f ../logs/application.log 查看实时日志，无报错且出现“Started ... in ... seconds”字样即表示成功 ```

3.2 配置防火墙（如启用）

如果服务器启用了防火墙（如firewalld或ufw），需要放行软件使用的端口（例如8080）和SSH端口（22）。

对于firewalld (CentOS)：

``` sudo firewall-cmd --permanent --add-port=8080/tcp sudo firewall-cmd --permanent --add-port=22/tcp sudo firewall-cmd --reload ```

对于ufw (Ubuntu)：

``` sudo ufw allow 8080/tcp sudo ufw allow 22/tcp sudo ufw reload ```

四、系统初始化与基础配置

4.1 首次登录与管理员账户设置

打开浏览器，访问 http://你的服务器IP地址:8080。首次访问通常会跳转到初始化页面。

初始化步骤：

• 设置超级管理员账号：输入用户名（如 `admin`）、姓名、密码和确认密码。
• 配置单位信息：填写“陵水黎族自治县档案局（馆）”等全称、统一社会信用代码（如有）。
• 点击“完成初始化”按钮。

使用刚刚设置的管理员账号登录系统。

4.2 创建基础档案分类与用户

登录后，进入“系统管理”或“基础设置”菜单。

创建档案门类：

• 进入“档案门类管理”。
• 点击“新增”，输入门类代码（如 `WS`）、门类名称（如“文书档案”）。
• 保存。按同样方法创建“会计档案”、“照片档案”等。

创建部门与用户：

• 进入“部门管理”，创建如“办公室”、“业务指导股”、“保管利用股”等部门。
• 进入“用户管理”，为各股室负责人或档案员创建用户账号，并关联到对应部门。

五、日常档案录入与管理流程

5.1 单件档案录入

点击“档案管理” -> “档案录入”。

操作步骤：

1. 选择已创建的“档案门类”。
2. 填写档号：按照本馆档号编制规则填写，如 `WS2023-Y-001`。
3. 填写题名、责任者、形成日期、页数、保管期限（永久/30年/10年）、密级等必填项。
4. 上传电子文件：点击“添加附件”，从本地选择已扫描的PDF或图像文件。
5. 点击“保存并提交”。

5.2 批量导入档案条目

对于已有电子目录（如Excel表）的情况，使用批量导入功能。

1. 准备Excel模板：在系统中“批量导入”功能处，下载标准模板。
2. 按模板格式填写数据，确保档号、题名等关键字段与系统要求一致。
3. 在系统中选择模板文件，点击“上传并校验”。
4. 系统校验无误后，确认导入。导入后，务必在“档案管理”列表中抽查数据准确性。

5.3 档案查询与借阅

普通用户登录后，可在首页搜索框输入档号、题名关键词进行查询。

申请借阅：

1. 在查询结果中找到所需档案，点击“申请借阅”。
2. 选择借阅用途（如“工作查考”）、预定归还日期。
3. 提交申请，等待档案管理员审批。

管理员审批：管理员在“借阅管理”中看到待办申请，审核后点击“同意借阅”或“拒绝”。

六、数据备份与系统维护

6.1 自动化数据库备份

创建备份脚本，并添加到定时任务。

创建备份脚本 /opt/backup_script.sh：

``` !/bin/bash BACKUP_DIR="/opt/archive_backups" DB_NAME="ling_shui_archive_db" DB_USER="archive_user" DB_PASS="your_strong_password" DATE=$(date +%Y%m%d_%H%M%S) mkdir -p $BACKUP_DIR mysqldump -u$DB_USER -p$DB_PASS $DB_NAME | gzip > $BACKUP_DIR/${DB_NAME}_backup_$DATE.sql.gz 删除7天前的备份 find $BACKUP_DIR -name ".sql.gz" -mtime +7 -delete ```

赋予脚本执行权限：chmod +x /opt/backup_script.sh。

添加每日凌晨2点执行的定时任务：

``` crontab -e ```

在末尾添加一行：0 2 /opt/backup_script.sh，保存退出。

6.2 服务监控与日志管理

定期检查服务状态：systemctl status 你的服务名 或 ps aux | grep java。

查看错误日志：tail -100 /opt/ling-shui-archive/logs/error.log。

定期清理旧日志（可在config/application.yml中配置日志滚动策略，或手动清理）：

``` 手动清理30天前的日志 find /opt/ling-shui-archive/logs/ -name ".log." -mtime +30 -delete ```

6.3 软件更新

当有新版本发布时，按以下流程操作：

1. 完整备份数据库和/opt/ling-shui-archive/data/files/电子文件目录。
2. 停止当前服务：./opt/ling-shui-archive/bin/shutdown.sh。
3. 将旧版本config/目录和data/目录复制到安全位置。
4. 解压新版本软件包到新目录。
5. 将备份的配置文件（根据新版本说明选择性覆盖）和整个data/目录复制回新目录。
6. 启动新版本服务，并严格测试所有核心功能。