CentOS7环境下开源文书档案管理系统从零到可用部署实操全指南

一、前置环境准备

1. 服务器基础要求

最低配置：2核4G内存、40G系统盘、CentOS7.9 64位操作系统，提前开放安全组端口80、8080、3306、6379。

执行以下命令临时关闭防火墙（生产环境建议按需放行端口即可）：

``` systemctl stop firewalld setenforce 0 ```

2. 依赖组件安装

首先更新yum源：

``` yum update -y ```

安装JDK1.8：

``` yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel 验证安装，返回版本号即为成功 java -version ```

安装MySQL5.7：

``` wget http://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm rpm -ivh mysql57-community-release-el7-11.noarch.rpm yum install -y mysql-community-server --nogpgcheck 启动并设置开机自启 systemctl start mysqld systemctl enable mysqld ```

获取MySQL初始密码并修改，创建系统专用数据库：

``` 提取初始密码 grep 'temporary password' /var/log/mysqld.log | awk '{print $NF}' 登录MySQL，输入上述提取的初始密码 mysql -uroot -p 执行以下SQL修改root密码、创建档案系统库和账号 ALTER USER 'root'@'localhost' IDENTIFIED BY 'Root@2024_Archive'; CREATE DATABASE easy_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; GRANT ALL ON easy_archive. TO 'archive_user'@'%' IDENTIFIED BY 'Archive@2024_User'; FLUSH PRIVILEGES; exit; ```

安装Redis5：

``` yum install -y redis systemctl start redis systemctl enable redis 验证安装，返回PONG即为成功 redis-cli ping ```

二、系统包下载与配置

1. 安装包获取

执行以下命令下载稳定版v2.3.1系统包和配置文件到指定目录：

``` mkdir -p /opt/archive/ wget https://ghproxy.com/https://github.com/dromara/easy-archive/releases/download/v2.3.1/easy-archive.jar -P /opt/archive/ wget https://ghproxy.com/https://github.com/dromara/easy-archive/releases/download/v2.3.1/application.yml -P /opt/archive/ ```

2. 配置文件修改

编辑/opt/archive/application.yml文件，完整可直接复制的配置内容如下，仅需修改对应数据库、redis的账号密码即可，其余参数默认无需调整：

```yaml server: port: 8080 servlet: context-path: /archive spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/easy_archive?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: archive_user password: Archive@2024_User redis: host: 127.0.0.1 port: 6379 password: '' servlet: multipart: max-file-size: 100MB max-request-size: 100MB archive: file-storage-path: /opt/archive/file/ admin-username: admin admin-password: Admin@123456 ```

创建档案文件存储目录并赋权：

``` mkdir -p /opt/archive/file/ chmod 777 -R /opt/archive/file/ ```

三、系统启动与验证

1. 后台启动服务

执行以下命令后台启动系统，并查看启动日志：

``` cd /opt/archive/ nohup java -jar easy-archive.jar > run.log 2>&1 & 查看日志，出现「Started EasyArchiveApplication in X seconds」即为启动成功 tail -f run.log ```

本地验证服务可用性：

``` curl http://127.0.0.1:8080/archive 返回200状态码即为正常 ```

2. Nginx反向代理配置（公网访问可选）

在/etc/nginx/conf.d/目录下创建archive.conf配置文件，内容如下：

```nginx server { listen 80; server_name 你的公网IP或绑定的域名; client_max_body_size 100M; 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：

``` nginx -t 返回test is successful后执行重载 systemctl reload nginx ```

公网访问验证：浏览器打开http://你的公网IP/archive，使用初始账号admin、密码Admin@123456登录，可正常进入系统后台即为部署完成。

四、常见问题与优化

• 启动失败提示数据库连接错误：检查application.yml中的数据库账号密码是否正确，确认mysql的archive_user账号是否授权了远程访问权限，安全组3306端口是否开放
• 上传档案提示权限不足：执行chmod 777 -R /opt/archive/file/重新给存储目录赋权即可
• 公网访问超时：检查安全组80、8080端口是否开放，执行firewall-cmd --add-port=80/tcp --permanent && firewall-cmd --reload放行端口
• 服务异常中断自动重启配置：创建/etc/systemd/system/archive.service文件，内容如下： ``` [Unit] Description=easy-archive After=network.target mysqld.service redis.service [Service] Type=simple User=root WorkingDirectory=/opt/archive ExecStart=/usr/bin/java -jar easy-archive.jar Restart=always RestartSec=10 [Install] WantedBy=multi-user.target ``` 执行systemctl daemon-reload && systemctl enable archive && systemctl start archive即可实现开机自启、异常自动重启