昌江黎族自治县数字档案馆系统本地部署实操详细指南

一、前置准备

需准备以下软件及资源（全部为官方稳定版本，直接复制下载链接即可获取）：

• 服务器：CentOS7.9 64位（内存≥4G，磁盘≥50G）
• JDK1.8.0_291：https://download.oracle.com/java/8u291-b10/jdk-8u291-linux-x64.tar.gz
• MySQL5.7.36：https://downloads.mysql.com/archives/get/p/23/file/mysql-5.7.36-linux-glibc2.12-x86_64.tar.gz
• Nginx1.20.1：http://nginx.org/download/nginx-1.20.1.tar.gz
• 系统安装包：http://zwdt.changjiang.gov.cn/tech/archive/archive-system-v1.0.0.zip

二、基础环境配置

1. JDK安装与环境变量配置

上传JDK压缩包至服务器/usr/local目录，依次执行：

``` cd /usr/local tar -zxvf jdk-8u291-linux-x64.tar.gz mv jdk1.8.0_291 jdk1.8 ```

编辑/etc/profile文件添加环境变量，执行：

``` echo -e 'export JAVA_HOME=/usr/local/jdk1.8\nexport PATH=$JAVA_HOME/bin:$PATH\nexport CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar' >> /etc/profile source /etc/profile ```

验证：执行java -version，输出java version "1.8.0_291"即安装成功。

2. MySQL安装与数据库初始化

上传MySQL压缩包至/usr/local目录，执行：

``` cd /usr/local tar -zxvf mysql-5.7.36-linux-glibc2.12-x86_64.tar.gz mv mysql-5.7.36-linux-glibc2.12-x86_64 mysql5.7 mkdir -p /data/mysql chown -R mysql:mysql /data/mysql ```

初始化数据库，记录临时密码（日志末尾生成）：

``` cd /usr/local/mysql5.7/bin ./mysqld --initialize --user=mysql --datadir=/data/mysql --basedir=/usr/local/mysql5.7 ```

配置并启动MySQL服务：

``` cp /usr/local/mysql5.7/support-files/mysql.server /etc/init.d/mysqld chmod +x /etc/init.d/mysqld service mysqld start ```

登录MySQL修改密码并创建系统数据库：

``` mysql -uroot -p -- 输入刚才记录的临时密码 ALTER USER 'root'@'localhost' IDENTIFIED BY 'Changjiang@2024'; FLUSH PRIVILEGES; CREATE DATABASE archive_system DEFAULT CHARACTER SET utf8mb4; GRANT ALL PRIVILEGES ON archive_system. TO 'root'@'%' IDENTIFIED BY 'Changjiang@2024'; FLUSH PRIVILEGES; ```

3. Nginx安装

上传Nginx压缩包至/usr/local目录，执行：

``` cd /usr/local tar -zxvf nginx-1.20.1.tar.gz yum install -y pcre pcre-devel zlib zlib-devel openssl openssl-devel cd nginx-1.20.1 ./configure --prefix=/usr/local/nginx --with-http_ssl_module --with-http_stub_status_module make && make install ```

验证：/usr/local/nginx/sbin/nginx -v，输出版本即安装成功。

三、档案系统部署实操

上传系统安装包至/usr/local目录，解压并重命名：

``` cd /usr/local unzip archive-system-v1.0.0.zip mv archive-system /usr/local/archive-system ```

修改核心配置文件/application.yml，路径/usr/local/archive-system/config/application.yml，完整内容如下：

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

创建文件存储目录并授权：

``` mkdir -p /data/archive-files chown -R root:root /data/archive-files ```

启动档案系统：

``` cd /usr/local/archive-system/bin nohup ./startup.sh & ```

验证启动：执行tail -f /usr/local/archive-system/logs/catalina.out，输出“Started Application in XXX seconds”即启动成功。

四、反向代理配置与测试

修改Nginx配置文件/usr/local/nginx/conf/nginx.conf，在http块中添加：

``` server { listen 80; server_name 服务器公网IP; location /archive { proxy_pass http://127.0.0.1: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; } } ```

重启Nginx生效配置：/usr/local/nginx/sbin/nginx -s reload

功能测试：浏览器访问http://服务器公网IP/archive，默认账号admin，密码Changjiang@2024，登录后可正常进入档案管理页面即部署完成。

五、常见问题快速排查

• 端口占用：执行lsof -i:8080查看占用进程，kill -9 进程ID释放端口，或修改application.yml的server.port为其他未占用端口；
• 数据库连接失败：检查MySQL服务状态（service mysqld status），确认配置文件中数据库账号密码、端口是否正确；
• 系统启动无响应：执行tail -f /usr/local/archive-system/logs/catalina.out查看错误日志，对应解决（如启动脚本无权限需执行chmod +x /usr/local/archive-system/bin/startup.sh）。