大理白族自治州数字档案馆系统本地部署实操全流程指南

一、部署环境准备（CentOS7系统）

1. 必须安装的依赖软件

仅需3项核心依赖，执行对应命令即可完成安装与验证：

• JDK1.8（Java运行环境，系统必备）： ``` yum install java-1.8.0-openjdk -y java -version ``` 验证：输出以java version "1.8.0_XXX"开头即为正常
• MySQL5.7（关系型数据库）： ``` yum install mysql-community-server -y systemctl start mysqld grep 'temporary password' /var/log/mysqld.log ``` 验证：记下输出的临时密码，后续需用它修改root密码
• Redis3.2（缓存服务）： ``` yum install redis -y systemctl enable redis ``` 验证：执行redis-cli ping返回PONG即为正常

二、系统包下载与解压

直接执行官方指定下载命令，请勿替换其他来源安装包： ``` wget https://dzda.dali.gov.cn/download/dzda-v1.0.0.zip unzip dzda-v1.0.0.zip && cd dzda ``` 确认当前目录已生成config、sql、logs等子文件夹，后续操作需在此目录执行

三、核心配置文件修改

进入config目录编辑application.yml，替换为以下完整配置（需与您的MySQL信息匹配）： ``` spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/dzda?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: root password: Dali@2024!Pass redis: host: localhost port: 6379 database: 0 server: port: 8080 servlet: context-path: /dzda ``` 重点提醒：1. 务必提前在MySQL中执行CREATE DATABASE dzda; 创建空数据库；2. 将spring.datasource.password替换为您设置的MySQL root密码；3. 确保8080端口未被其他程序占用

四、数据库初始化

在当前dzda目录执行官方初始化脚本： ``` mysql -uroot -p'Dali@2024!Pass' dzda < ./sql/init.sql ``` 注意：将上述命令中的MySQL密码替换为您实际设置的密码，执行后无报错即为初始化成功

五、系统启动与验证

用nohup后台启动Spring Boot应用，避免SSH断开后进程停止： ``` nohup java -jar dzda-v1.0.0.jar > logs/dzda.log 2>&1 & ``` 验证启动状态，等待关键输出： ``` tail -f logs/dzda.log ``` 当日志出现「Started DzdasystemApplication in X.XXX seconds」时，启动完成，此时可停止日志查看（按Ctrl+C）

六、防火墙端口开放

CentOS7默认防火墙会拦截非信任端口，必须开放8080端口： ``` firewall-cmd --add-port=8080/tcp --permanent firewall-cmd --reload firewall-cmd --list-ports ``` 验证：8080/tcp需出现在返回列表中，否则访问会失败

七、首次登录操作

在浏览器访问：http://【您的服务器公网IP】:8080/dzda，默认账号密码：账号admin，密码admin123。 首次登录后请立即在「系统设置-账号管理」中修改初始密码，避免安全风险；若为本地服务器，用localhost替换公网IP即可