政务版档案软件单机部署从零到一实操指南

一、操作系统环境初始化与依赖安装

政务版档案软件通常基于Java开发，对运行环境的稳定性要求极高。本指南以CentOS 7.9为例，演示从零开始的部署流程。我们需要关闭系统的防火墙与SELinux，这是政务类软件部署的基础前提，否则会导致服务无法正常通信或文件读写权限被拒绝。

执行以下命令关闭SELinux并临时停止防火墙：

```bash setenforce 0 sed -i 's/SELINUX=enforcing/SELINUX=disabled/g' /etc/selinux/config systemctl stop firewalld systemctl disable firewalld ```

接下来安装Java运行环境（JDK）。政务软件多兼容JDK 1.8，直接使用yum安装OpenJDK 1.8：

```bash yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel ```

安装完成后，验证Java版本，确保输出为1.8.x：

```bash java -version ```

为了满足档案数据的存储需求，需要创建专门的目录结构。假设软件包名为gov-archive-single.jar，我们将应用部署在/opt/gov-archive目录下，数据存储在/data/gov-archive目录下。执行以下命令创建目录并授权：

```bash mkdir -p /opt/gov-archive mkdir -p /data/gov-archive/{upload,backup,logs} chmod -R 755 /data/gov-archive ```

二、MySQL数据库环境搭建

档案软件依赖于关系型数据库存储元数据。为了保证环境的一致性，我们使用Docker容器快速部署MySQL 5.7版本。如果服务器未安装Docker，请先执行yum install -y docker并启动Docker服务。

执行以下命令启动MySQL容器。这里我们将数据库端口映射为3306，设置root密码为Gov@2024Secure，并指定字符集为utf8mb4以支持政务档案中可能出现的生僻字：

```bash docker run -d \ --name gov-mysql \ -p 3306:3306 \ -e MYSQL_ROOT_PASSWORD=Gov@2024Secure \ -e MYSQL_CHARACTER_SET_SERVER=utf8mb4 \ -e MYSQL_COLLATION_SERVER=utf8mb4_unicode_ci \ -v /data/mysql/data:/var/lib/mysql \ mysql:5.7 ```

等待约30秒待数据库初始化完成，然后进入容器创建专用数据库。政务系统通常要求独立数据库实例，此处创建名为gov_archive_db的数据库：

```bash docker exec -it gov-mysql mysql -uroot -pGov@2024Secure -e "CREATE DATABASE IF NOT EXISTS gov_archive_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;" ```

假设软件包中包含初始化SQL脚本init.sql，使用以下命令导入数据结构：

```bash docker exec -i gov-mysql mysql -uroot -pGov@2024Secure gov_archive_db < /opt/gov-archive/init.sql ```

三、应用核心配置文件详解

配置文件是单机版部署的核心。我们需要在/opt/gov-archive目录下创建application.yml文件。该文件必须包含数据库连接、文件存储路径及服务端口配置。请直接复制以下内容，并根据实际情况修改password字段：

```yaml server: port: 8080 servlet: context-path: /archive session: timeout: 1800 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/gov_archive_db?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: root password: Gov@2024Secure driver-class-name: com.mysql.jdbc.Driver hikari: maximum-pool-size: 20 minimum-idle: 5 file: upload: path: /data/gov-archive/upload backup: path: /data/gov-archive/backup logging: file: path: /data/gov-archive/logs level: root: INFO com.gov.archive: DEBUG ```

配置细节说明：

• server.port: 设置为8080，访问地址即为http://服务器IP:8080/archive。
• spring.datasource.url: 必须显式指定serverTimezone=Asia/Shanghai，否则会导致档案归档时间与系统时间不一致。
• file.upload.path: 指向之前创建的/data/gov-archive/upload，确保应用有读写权限。

四、系统服务注册与开机自启

为了防止服务器重启后服务停止，必须将应用注册为Systemd系统服务。创建服务文件/etc/systemd/system/gov-archive.service：

```bash vim /etc/systemd/system/gov-archive.service ```

输入以下内容，这是一份标准的Spring Boot应用服务配置：

```ini [Unit] Description=Gov Archive Single Application After=syslog.target network.target mysql.service Requires=mysql.service [Service] Type=simple User=root WorkingDirectory=/opt/gov-archive ExecStart=/usr/bin/java -jar /opt/gov-archive/gov-archive-single.jar --spring.config.location=/opt/gov-archive/application.yml Restart=always RestartSec=10 StandardOutput=append:/data/gov-archive/logs/stdout.log StandardError=append:/data/gov-archive/logs/stderr.log [Install] WantedBy=multi-user.target ```

注意： 请确保gov-archive-single.jar文件确实存在于/opt/gov-archive目录下。配置完成后，执行以下命令重载系统守护进程并启动服务：

```bash systemctl daemon-reload systemctl enable gov-archive systemctl start gov-archive ```

五、服务验证与日志排查

服务启动后，首先检查进程状态，确认显示为Active: active (running)：

```bash systemctl status gov-archive ```

如果服务启动失败，必须查看日志定位问题。由于我们将标准输出重定向到了文件，可以直接查看应用日志：

```bash tail -f /data/gov-archive/logs/stdout.log ```

若出现数据库连接错误，请检查MySQL容器是否正常运行；若出现“Permission denied”，请检查/data目录的属主和权限。确认无误后，使用curl命令本地测试接口响应：

```bash curl http://localhost:8080/archive/health ```

若返回JSON格式的健康状态（如{"status":"UP"}），则说明后端服务部署成功。此时，在浏览器中输入http://服务器IP:8080/archive即可看到政务版档案软件的登录界面。默认管理员账号通常为admin，初始密码为123456（首次登录后系统会强制要求修改）。

六、数据自动备份策略配置

政务数据安全是底线，必须配置定时备份。我们编写一个简单的Shell脚本/opt/gov-archive/backup.sh，用于每天凌晨2点备份数据库：

```bash !/bin/bash DATE=$(date +%Y%m%d_%H%M%S) BACKUP_DIR=/data/gov-archive/backup docker exec gov-mysql mysqldump -uroot -pGov@2024Secure gov_archive_db | gzip > $BACKUP_DIR/db_backup_$DATE.sql.gz find $BACKUP_DIR -name "db_backup_.sql.gz" -mtime +7 -delete ```

赋予脚本执行权限并添加到Crontab：

```bash chmod +x /opt/gov-archive/backup.sh echo "0 2 /opt/gov-archive/backup.sh" | crontab - ```

此配置实现了每天凌晨2点自动备份，并自动清理7天前的旧备份文件，确保单机版存储空间不会溢出。至此，一套完整的、具备高可用性和数据安全保障的政务版档案软件单机版环境已部署完毕。