双河档案管理软件Linux服务器部署配置详解

一、基础环境准备

双河档案管理软件基于Java开发，采用前后端分离架构。在正式部署前，需确保服务器环境已安装JDK 1.8、MySQL 5.7及以上版本以及Nginx。本指南以CentOS 7.9操作系统为例，演示从零开始的部署流程。

1.1 安装JDK 1.8环境

首先检查系统是否已安装Java环境，若未安装则执行以下命令进行安装：

 检查Java版本
java -version
如果未安装，使用yum安装JDK 1.8
yum install java-1.8.0-openjdk java-1.8.0-openjdk-devel -y
配置JAVA_HOME环境变量
echo "export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk" >> /etc/profile
echo "export PATH=\$JAVA_HOME/bin:\$PATH" >> /etc/profile
source /etc/profile
验证安装结果
java -version

1.2 安装MySQL 5.7数据库

双河档案管理软件依赖MySQL存储数据。执行以下命令下载并安装MySQL官方Yum源仓库：

 下载MySQL 5.7的rpm包
wget https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm
安装rpm包
rpm -ivh mysql57-community-release-el7-11.noarch.rpm
安装MySQL服务器
yum install mysql-server -y
启动MySQL服务并设置开机自启
systemctl start mysqld
systemctl enable mysqld

安装完成后，需获取临时密码并修改root密码：

 获取临时密码（输出中的 'password is generated for root@localhost:' 后面即为密码）
grep 'temporary password' /var/log/mysqld.log
登录MySQL（输入上述获取的临时密码）
mysql -uroot -p
在MySQL命令行中执行，修改root密码为 'Shuanghe@2024'（注意：密码策略需包含大小写、数字及符号）
SET PASSWORD = PASSWORD('Shuanghe@2024');
刷新权限并退出
FLUSH PRIVILEGES;
EXIT;

1.3 安装Nginx

Nginx用于反向代理后端接口及托管前端静态资源：

 安装EPEL源
yum install epel-release -y
安装Nginx
yum install nginx -y
启动Nginx并设置开机自启
systemctl start nginx
systemctl enable nginx

二、数据库初始化与导入

环境准备就绪后，需创建专用数据库并导入初始化SQL脚本。假设软件包中包含 shuanghe_init.sql 文件。

2.1 创建数据库与用户

登录MySQL创建专用的数据库实例和授权用户，避免直接使用root用户运行业务：

 登录MySQL
mysql -uroot -pShuanghe@2024
执行以下SQL语句
CREATE DATABASE shuanghe_archive_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER 'shuanghe_user'@'localhost' IDENTIFIED BY 'Shuanghe@User2024';
GRANT ALL PRIVILEGES ON shuanghe_archive_db. TO 'shuanghe_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

2.2 导入初始化数据

将 shuanghe_init.sql 文件上传至服务器的 /opt/shuanghe 目录，然后执行导入命令：

 创建目录
mkdir -p /opt/shuanghe
导入数据（请根据实际文件名调整）
mysql -ushuanghe_user -p'Shuanghe@User2024' shuanghe_archive_db < /opt/shuanghe/shuanghe_init.sql
验证表是否导入成功
mysql -ushuanghe_user -p'Shuanghe@User2024' -e "USE shuanghe_archive_db; SHOW TABLES;"

三、后端服务部署与配置

后端服务通常打包为JAR文件。本步骤将配置应用参数并将其注册为系统服务。

3.1 上传与目录规划

将后端JAR包 shuanghe-admin.jar 上传至 /opt/shuanghe/backend 目录：

mkdir -p /opt/shuanghe/backend
假设已通过rz或scp上传至该目录

3.2 创建配置文件

为了便于管理，建议创建外部配置文件 application.yml，覆盖JAR包内的默认配置。在 /opt/shuanghe/backend 目录下创建该文件：

vim /opt/shuanghe/backend/application.yml

输入以下完整配置内容（请根据实际情况修改端口和密码）：

server:
port: 8080
servlet:
context-path: /
session:
timeout: 30m
spring:
datasource:
url: jdbc:mysql://localhost:3306/shuanghe_archive_db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
username: shuanghe_user
password: Shuanghe@User2024
driver-class-name: com.mysql.cj.jdbc.Driver
type: com.zaxxer.hikari.HikariDataSource
hikari:
minimum-idle: 5
maximum-pool-size: 20
mybatis:
mapper-locations: classpath:mapper//Mapper.xml
type-aliases-package: com.shuanghe.project..entity
logging:
level:
root: INFO
com.shuanghe.project: DEBUG
file:
path: /opt/shuanghe/logs

3.3 配置Systemd服务

创建Systemd服务文件以实现开机自启和守护进程管理：

vim /etc/systemd/system/shuanghe.service

写入以下内容：

[Unit]
Description=Shuanghe Archive Management Backend
After=syslog.target network.target mysql.service
[Service]
Type=simple
User=root
WorkingDirectory=/opt/shuanghe/backend
ExecStart=/usr/bin/java -jar /opt/shuanghe/backend/shuanghe-admin.jar --spring.config.location=/opt/shuanghe/backend/application.yml
ExecStop=/bin/kill -15 $MAINPID
Restart=always
RestartSec=10
StandardOutput=append:/opt/shuanghe/logs/backend.log
StandardError=append:/opt/shuanghe/logs/backend_error.log
[Install]
WantedBy=multi-user.target

保存后执行以下命令启动后端服务：

 创建日志目录
mkdir -p /opt/shuanghe/logs
重新加载systemd配置
systemctl daemon-reload
启动服务
systemctl start shuanghe
查看启动状态
systemctl status shuanghe
查看启动日志（如有报错可在此排查）
tail -f /opt/shuanghe/logs/backend.log

四、前端Nginx配置与部署

将前端打包好的 dist 目录上传至服务器，并配置Nginx进行代理。

4.1 部署静态资源

 创建前端目录
mkdir -p /opt/shuanghe/frontend
将dist目录内的所有文件移动或上传至此目录
假设 dist/ 内容已在 /opt/shuanghe/frontend 下

4.2 配置Nginx虚拟主机

编辑Nginx主配置文件或创建新站点配置：

vim /etc/nginx/conf.d/shuanghe.conf

输入以下配置内容，实现静态资源托管及API接口转发：

server {
listen 80;
server_name your_server_ip;  请替换为实际域名或服务器IP
前端静态资源根目录
root /opt/shuanghe/frontend;
index index.html;
Gzip压缩配置
gzip on;
gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
后端API接口代理
location /api/ {
proxy_pass http://localhost:8080/;
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;
文件上传大小限制
client_max_body_size 100m;
}
Vue Router History模式支持，所有未匹配请求指向index.html
location / {
try_files $uri $uri/ /index.html;
}
}

测试并重启Nginx服务：

 测试配置文件语法
nginx -t
重载Nginx配置
systemctl reload nginx

五、防火墙与系统验证

开放防火墙端口并进行全链路访问测试。

5.1 配置防火墙

若服务器启用了Firewalld，需开放HTTP服务端口：

 查看防火墙状态
systemctl status firewalld
若为running状态，执行以下命令
firewall-cmd --permanent --add-service=http
firewall-cmd --permanent --add-port=8080/tcp
firewall-cmd --reload

5.2 系统验证

打开浏览器，访问 http://服务器IP地址。系统应显示双河档案管理软件的登录界面。

默认登录信息参考：

• 系统管理员账号：admin
• 系统默认密码：123456

登录后，请务必立即进入系统管理模块修改默认密码，并检查“系统监控”或“连接测试”功能，确认前后端与数据库的连接状态正常。至此，双河档案管理软件部署完成。