赣州档案管理软件本地化部署与配置实操全流程

一、基础运行环境准备

在部署赣州档案管理软件之前，必须确保服务器环境满足软件运行的最低要求。本指南基于 CentOS 7.9 64位 操作系统进行演示，软件架构采用 Spring Boot + MySQL 5.7。请确保服务器已连接网络，并且拥有 root 权限。

1.1 安装 Java JDK 1.8

赣州档案管理软件依赖 Java 环境。首先检查系统是否已安装 JDK，若未安装，请执行以下命令进行安装。

执行安装命令：

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

安装完成后，配置 JAVA_HOME 环境变量，确保系统能够识别 Java 路径。

编辑环境变量文件：

vi /etc/profile

在文件末尾添加以下内容：

export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk
export JRE_HOME=$JAVA_HOME/jre
export CLASSPATH=.:$JAVA_HOME/lib:$JRE_HOME/lib
export PATH=$JAVA_HOME/bin:$PATH

保存并退出后，执行以下命令使配置生效：

source /etc/profile

验证安装是否成功：

java -version

终端输出 openjdk version "1.8.0_xxx" 即表示环境配置成功。

1.2 安装 MySQL 5.7 数据库

档案管理软件需要 MySQL 5.7 作为数据存储。为了确保兼容性，严禁使用 MySQL 8.0 或 MariaDB。

下载并安装 MySQL Yum 源：

wget https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm
yum localinstall -y mysql57-community-release-el7-11.noarch.rpm

安装 MySQL 服务：

yum install -y mysql-community-server

启动 MySQL 并设置开机自启：

systemctl start mysqld
systemctl enable mysqld

MySQL 5.7 安装后会生成一个临时密码，通过 grep 命令获取：

grep 'temporary password' /var/log/mysqld.log

复制输出中的密码，登录数据库并修改 root 密码（这里修改为 GzArchives@2024，生产环境请自行修改）：

mysql -uroot -p
输入临时密码登录后执行：
SET PASSWORD = PASSWORD('GzArchives@2024');

二、数据库初始化与配置

环境准备就绪后，需要专门为赣州档案管理软件创建数据库实例，并导入基础表结构。

2.1 创建数据库与授权用户

登录 MySQL 控制台，执行以下 SQL 语句。请严格按照以下字符集和排序规则设置，否则会导致中文乱码。

CREATE DATABASE `gz_archives_db` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER 'gz_admin'@'%' IDENTIFIED BY 'GzAdmin@Pass123';
GRANT ALL PRIVILEGES ON gz_archives_db. TO 'gz_admin'@'%';
FLUSH PRIVILEGES;

2.2 导入初始化表结构

假设软件包中包含 init.sql 初始化脚本文件。将该文件上传至服务器 /opt/software 目录下，然后执行导入命令。

执行导入命令：

mysql -ugz_admin -p'GzAdmin@Pass123' gz_archives_db < /opt/software/init.sql

为了验证导入是否成功，可以检查表数量：

mysql -ugz_admin -p'GzAdmin@Pass123' -e "USE gz_archives_db; SHOW TABLES;"

三、软件部署与核心配置

本环节将软件包部署到服务器，并进行最关键的数据库连接和文件存储路径配置。

3.1 创建应用目录与上传文件

在服务器创建规范的应用目录结构，便于后续维护。

mkdir -p /opt/gz-archives/{app,logs,upload}

将赣州档案管理软件的安装包 gz-archives-v1.0.jar 上传至 /opt/gz-archives/app 目录下。

3.2 编写 application.yml 配置文件

在 /opt/gz-archives/app 目录下创建 application.yml 文件。这是软件启动的核心配置，必须完整准确。请根据前面步骤设置的实际密码修改下方配置中的 username 和 password。

server:
port: 8080
servlet:
context-path: /archives
spring:
datasource:
url: jdbc:mysql://127.0.0.1:3306/gz_archives_db?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
username: gz_admin
password: GzAdmin@Pass123
driver-class-name: com.mysql.jdbc.Driver
type: com.zaxxer.hikari.HikariDataSource
hikari:
minimum-idle: 5
maximum-pool-size: 20
connection-timeout: 30000
servlet:
multipart:
max-file-size: 500MB
max-request-size: 500MB
enabled: true
mybatis:
mapper-locations: classpath:mapper/.xml
type-aliases-package: com.gz.archives.entity
logging:
level:
root: INFO
com.gz.archives.dao: DEBUG
file:
path: /opt/gz-archives/logs

注意： 配置中的 logging.file.path 必须对应之前创建的日志目录，否则因无权限写日志会导致启动失败。

四、配置系统服务并启动

为了防止窗口关闭后程序停止，我们需要将软件注册为 Systemd 系统服务，实现开机自启和守护进程。

4.1 创建 Systemd 服务文件

创建服务文件 /etc/systemd/system/gz-archives.service，内容如下：

[Unit]
Description=Ganzhou Archives Management System
After=syslog.target network.target mysql.service
[Service]
Type=simple
User=root
WorkingDirectory=/opt/gz-archives/app
ExecStart=/usr/lib/jvm/java-1.8.0-openjdk/bin/java -jar /opt/gz-archives/app/gz-archives-v1.0.jar --spring.config.location=/opt/gz-archives/app/application.yml
Restart=always
RestartSec=10
StandardOutput=journal
StandardError=journal
[Install]
WantedBy=multi-user.target

4.2 启动服务与状态检查

执行以下命令重新加载 systemd 配置并启动服务：

systemctl daemon-reload
systemctl start gz-archives
systemctl status gz-archives

如果状态显示 Active: active (running)，说明启动成功。若显示失败，请查看详细日志：

journalctl -u gz-archives -n 50 --no-pager

或者查看具体的日志文件：

tail -f /opt/gz-archives/logs/spring.log

五、Nginx 反向代理配置

通常我们不建议直接暴露 8080 端口给外网。通过 Nginx 进行反向代理，可以提供 80 端口访问、SSL 支持以及静态资源缓存。

5.1 安装与配置 Nginx

安装 Nginx：

yum install -y nginx

编辑 Nginx 配置文件：

vi /etc/nginx/conf.d/gz_archives.conf

粘贴以下完整配置：

server {
listen 80;
server_name your-domain-or-ip;
client_max_body_size 500M;
location /archives/ {
proxy_pass http://127.0.0.1:8080/archives/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
location /upload/ {
alias /opt/gz-archives/upload/;
autoindex on;
}
}

检查 Nginx 配置语法并启动：

nginx -t
systemctl start nginx
systemctl enable nginx

六、常见故障排查

在部署过程中，若遇到无法访问的情况，请按以下顺序排查。

6.1 端口占用检查

如果 8080 端口被占用，会导致 Java 进程启动失败。执行以下命令查看端口占用情况：

netstat -tunlp | grep 8080

如果发现其他进程占用，请在 application.yml 中修改 server.port 为其他端口（如 8081），并杀掉占用进程或停止对应服务。

6.2 数据库连接失败

日志中出现 Communications link failure。请检查：

1. MySQL 服务是否启动：systemctl status mysqld
2. 防火墙是否放行 3306 端口（本机连接可忽略，但需检查用户 host 权限）。
3. application.yml 中的数据库密码是否与实际设置的一致。

6.3 文件上传权限不足

如果系统提示“文件上传失败”，通常是因为 /opt/gz-archives/upload 目录权限不足。执行以下命令赋予写权限：

chmod -R 755 /opt/gz-archives/upload
chown -R root:root /opt/gz-archives/upload

完成以上所有步骤后，在浏览器中输入 http://服务器IP/archives，即可看到赣州档案管理软件的登录界面。默认管理员账号通常为 admin，密码为 123456（首次登录后请立即在系统内部修改）。