克拉玛依档案管理系统本地部署实操全流程指南

一、部署前环境准备

1. 硬件与系统要求

服务器配置需满足：CPU双核及以上、内存4GB及以上、硬盘50GB可用空间；操作系统优先选择CentOS 7.9（64位），避免Windows系统权限限制问题。

2. 必备软件安装

依次执行以下命令安装依赖：

安装OpenJDK 1.8：

``` sudo yum install java-1.8.0-openjdk-devel -y java -version 验证安装，输出openjdk version "1.8.0_xxx"即为成功 ```

安装MySQL 5.7数据库：

``` sudo yum install mysql-community-server -y sudo systemctl start mysqld sudo systemctl enable mysqld mysql_secure_installation 按提示设置MySQL root密码，禁用匿名用户 ```

二、系统包下载与核心配置

1. 获取系统安装包

直接通过官方指定地址下载：

``` wget https://krmay-archive-official.com/download/krmay-archive-1.0.0.tar.gz tar -zxvf krmay-archive-1.0.0.tar.gz -C /opt/ cd /opt/krmay-archive ```

2. 数据库初始化与配置

先创建系统所需数据库，执行命令：

``` mysql -uroot -p'你的MySQL root密码' -e 'CREATE DATABASE archive_db CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;' ```

修改系统配置文件config/application.yml，完整内容如下（必须替换密码）：

``` server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/archive_db?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT%2B8 username: root password: your_mysql_root_pwd 替换为你设置的MySQL root密码 driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/.xml type-aliases-package: com.krmay.archive.entity ```

必须确认配置文件中数据库连接信息无误，否则系统无法启动。

三、系统启动与初始设置

1. 启动系统服务

在当前目录执行后台启动命令：

``` nohup java -jar krmay-archive-1.0.0.jar & tail -f nohup.out 查看启动日志，等待输出"Started ArchiveApplication in X.XXX seconds" ```

2. 初始管理员账号修改

服务器本地或通过远程访问，打开浏览器输入http://服务器IP:8080，使用默认账号admin、密码admin123登录，第一次登录务必修改默认密码并设置安全问题，否则系统存在安全风险。

四、核心功能基础验证

• 1. 登录验证：修改密码后重新登录，确认可进入系统后台；
• 2. 档案录入：点击「档案管理-新增档案」，输入测试数据（如档案编号：TEST001、档案名称：测试档案），保存后检查列表是否生成对应记录；
• 3. 档案查询：在搜索框输入TEST001，确认可精准检索到测试档案；
• 4. 参数设置：进入「系统设置-基础配置」，修改档案馆名称为「克拉玛依市档案馆」，确认修改后生效。

五、常见问题快速排查

1. 启动失败：端口占用

执行lsof -i:8080查看占用进程，用kill -9 进程ID终止进程；或修改配置文件中server.port为未占用端口（如8081），重启系统。

2. 数据库连接异常

检查MySQL服务状态（sudo systemctl status mysqld），确认配置文件中username、password无误，archive_db数据库是否存在。

3. 功能按钮无反应

查看nohup.out日志，搜索「error」关键词，若提示JDK版本错误，需卸载高版本JDK后重新安装OpenJDK 1.8。