文书档案系统实施：零基础从环境到上线的一步实操指南

一、前置环境准备

本次实操基于CentOS 7.9 64位操作系统，所有命令均以root用户执行，无额外权限要求。

1. 核心依赖软件安装

执行以下命令一次性安装JDK8、MariaDB10.5、Nginx，全程自动完成：

``` yum install -y java-1.8.0-openjdk-devel mariadb-server nginx ```

验证安装：分别执行以下命令，输出对应版本号即成功：

``` java -version mysql --version nginx -v ```

二、系统核心配置

1. 数据库初始化

启动数据库并设置开机自启：

``` systemctl start mariadb && systemctl enable mariadb ```

执行数据库初始化脚本，创建档案专属库与权限用户：

``` mysql -uroot -e "CREATE DATABASE archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; CREATE USER 'archive'@'%' IDENTIFIED BY 'Archive@2024'; GRANT ALL PRIVILEGES ON archive. TO 'archive'@'%'; FLUSH PRIVILEGES;" ```

注意：密码必须包含大小写字母、数字、特殊字符，长度≥8位，否则授权失败。

2. 档案系统配置文件修改

创建系统所需的文件存储与日志目录：

``` mkdir -p /opt/archive/{files,logs} && chmod 777 /opt/archive/{files,logs} ```

必须使用绝对路径：编辑application.yml配置文件，完整内容如下（需部署包内替换原有配置）：

``` server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/archive?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: archive password: Archive@2024 driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 100MB max-request-size: 100MB archive: file-path: /opt/archive/files log-path: /opt/archive/logs ```

三、系统部署与启动

1. 部署包上传与解压

将官方提供的档案系统部署包（名称为archive-system-v1.0.0.zip）上传至/opt/archive目录，可通过rz命令上传（提前安装：yum install -y lrzsz），也可通过WinSCP等工具上传。

执行解压命令：

``` cd /opt/archive && unzip archive-system-v1.0.0.zip ```

解压后目录包含：jar运行包、配置文件、静态资源文件夹。

2. 系统启动

执行后台启动命令，避免终端关闭后系统停止：

``` cd /opt/archive && nohup java -jar archive-system-v1.0.0.jar > logs/start.log 2>&1 & ```

验证启动：执行以下命令，输出“Started ArchiveApplication in X seconds”即启动成功：

``` tail -f logs/start.log | grep "Started" ```

四、上线后验证与优化

1. 核心功能测试

在本地浏览器访问：http://[服务器公网IP]:8080，使用默认账号admin、密码admin123登录系统。

依次执行以下操作验证：

• 点击「文书管理」→「上传文书」，上传10MB以内的txt、docx格式文件；
• 在文书列表搜索刚上传的文件名，点击「查看」确认内容完整；
• 点击「下载」，确认文件可正常保存到本地且无损坏。

2. 开机自启配置

创建系统服务文件实现开机自动启动，编辑文件：

``` vi /usr/lib/systemd/system/archive.service ```

填入以下完整内容：

``` [Unit] Description=Archive System Service After=mariadb.service network.target [Service] User=root WorkingDirectory=/opt/archive ExecStart=/usr/bin/java -jar /opt/archive/archive-system-v1.0.0.jar Restart=always [Install] WantedBy=multi-user.target ```

执行生效命令并设置开机自启：

``` systemctl daemon-reload && systemctl start archive && systemctl enable archive ```

最终验证：重启服务器后，执行systemctl status archive，输出active (running)即配置生效。