园林绿化工程档案管理系统本地化部署与日常运维实操全指南

一、前置准备（10分钟完成）

1.1 硬件要求

最低配置：2核4G云服务器/本地主机、50G可用硬盘、公网带宽1M以上，适配CentOS7/Windows Server2016及以上系统。

1.2 依赖安装

所有依赖均为开源免费组件，CentOS系统直接执行以下命令完成安装：

```shell 安装JDK1.8 yum install -y java-1.8.0-openjdk-devel 安装MySQL5.7 yum install -y https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm rpm --import https://repo.mysql.com/RPM-GPG-KEY-mysql-2022 yum install -y mysql-community-server systemctl start mysqld && systemctl enable mysqld 安装Redis5.x yum install -y epel-release && yum install -y redis systemctl start redis && systemctl enable redis 安装Nginx1.18+ yum install -y nginx && systemctl start nginx && systemctl enable nginx ```

安装完成后执行以下命令校验版本：

• java -version （返回1.8.x版本即为正常）
• mysql -V （返回5.7.x版本即为正常）
• redis-server -v （返回5.x版本即为正常）
• nginx -v （返回1.18及以上版本即为正常）

1.3 安装包下载

系统安装包直接下载地址：https://gitee.com/eco-tech/garden-archive-system/releases/download/v1.2.0/garden-archive-v1.2.0.zip，下载后上传到服务器/opt目录下即可。

二、系统部署实操（20分钟完成）

2.1 数据库初始化

先获取MySQL初始密码：grep 'temporary password' /var/log/mysqld.log，登录后执行以下SQL创建库和账号：

```sql -- 建库 CREATE DATABASE garden_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 创建专用账号（密码自行修改，建议包含大小写+数字+符号） CREATE USER 'garden'@'%' IDENTIFIED BY 'Garden@2024'; -- 授权 GRANT ALL PRIVILEGES ON garden_archive. TO 'garden'@'%'; FLUSH PRIVILEGES; -- 导入基础数据（注意替换路径） source /opt/garden-archive-v1.2.0/sql/init.sql; ```

2.2 后端服务部署

解压安装包：unzip /opt/garden-archive-v1.2.0.zip -d /opt/garden-archive，进入后端目录cd /opt/garden-archive/backend，修改application.yml配置文件，完整可复制配置如下：

```yaml server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/garden_archive?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: garden password: Garden@2024 替换为你设置的数据库密码 driver-class-name: com.mysql.cj.jdbc.Driver redis: host: 127.0.0.1 port: 6379 password: "" 未设置Redis密码则留空 database: 0 servlet: multipart: max-file-size: 50MB max-request-size: 100MB mybatis-plus: mapper-locations: classpath:mapper/.xml configuration: map-underscore-to-camel-case: true ```

启动后端服务：nohup java -jar garden-archive-admin.jar &，执行tail -f nohup.out查看日志，出现“Started GardenArchiveApplication in X seconds”即为启动成功。

2.3 前端部署

修改Nginx配置文件/etc/nginx/conf.d/garden.conf，完整可复制配置如下：

```nginx server { listen 80; server_name 你的服务器IP或域名; root /opt/garden-archive/frontend/dist; index index.html index.htm; location / { try_files $uri $uri/ /index.html; } location /api/ { 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; } client_max_body_size 100M; } ```

执行nginx -t校验配置，返回success后执行systemctl restart nginx重启Nginx，此时访问服务器IP即可进入系统登录页，默认账号密码为admin/123456，首次登录必须修改密码。

三、核心功能配置（15分钟完成）

3.1 档案分类初始化

进入【系统设置→档案分类】，按以下规则新增分类，支持二级嵌套：

• 一级分类：项目立项类（权限：管理员、甲方负责人可编辑）
• 一级分类：施工过程类（权限：施工单位、监理可编辑）
• 一级分类：竣工验收类（权限：管理员、验收组可编辑）
• 一级分类：养护运维类（权限：养护单位可编辑）

3.2 上传规则配置

进入【系统设置→上传规则】，按以下要求配置：

• 允许格式：pdf、jpg、png、dwg、docx、xlsx
• 单文件上限：50M
• 自动编号规则：{项目编码}-{分类编码}-{年份}-{4位流水号}
• 开启上传自动水印：水印内容为档案编号+上传时间

3.3 借阅流程配置

进入【工作流→流程设计】，点击导入，选择安装包doc目录下的garden_flow.json模板，默认流程为：申请人提交→部门负责人审批→档案管理员审批→自动开通7天访问权限，超时3天未审批自动驳回。

四、日常运维与问题排查

4.1 自动备份配置

新建/opt/backup/backup_garden.sh脚本，内容如下：

```shell !/bin/bash backup_dir="/opt/backup/garden_archive" date_str=$(date +%Y%m%d%H%M%S) mkdir -p $backup_dir mysqldump -ugarden -pGarden@2024 garden_archive > $backup_dir/garden_archive_$date_str.sql find $backup_dir -name ".sql" -mtime +7 -delete ```

执行crontab -e新增定时任务：0 2 /bin/bash /opt/backup/backup_garden.sh，即可实现每天凌晨2点自动备份，保留7天备份文件。

4.2 常见问题排查

• 前端访问404：检查Nginx配置的root路径是否正确，执行chmod 755 -R /opt/garden-archive/frontend/dist授予目录权限
• 后端启动失败：检查application.yml的数据库、Redis密码是否正确，确认3306、6379端口未被防火墙拦截
• 大文件上传失败：确认Nginx配置的client_max_body_size为100M，后端配置的max-file-size为50MB
• 登录提示账号密码错误：执行SQL UPDATE sys_user SET password = '$2a$10$7JB720yubVSzj.4K62zq/.eJ1VqLd80k06t18xGLX73eFhP00PnAW' WHERE username = 'admin'; 即可重置密码为123456