建设用地规划许可证档案管理系统从零部署实操全流程指南

一、前置环境准备

1.1 硬件配置要求

最低配置（支持50万条以内档案存储、10人同时在线）：2核4G云服务器、50G高效云盘、公网带宽1M；推荐配置：4核8G云服务器、100G SSD云盘、公网带宽5M。

1.2 基础软件安装

操作系统统一使用CentOS7.9，执行以下命令完成全部基础软件安装：

``` 安装JDK11 yum install -y java-11-openjdk java-11-openjdk-devel 验证安装 java -version 安装MySQL8 rpm -ivh https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm yum install -y mysql-community-server --nogpgcheck systemctl start mysqld systemctl enable mysqld 获取初始密码 grep 'temporary password' /var/log/mysqld.log 登录MySQL修改初始密码（将临时密码替换为查询到的内容） mysql -uroot -p[临时密码] ALTER USER 'root'@'localhost' IDENTIFIED BY 'Archive@2024'; CREATE DATABASE permit_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; exit; 安装Nginx yum install -y nginx systemctl start nginx systemctl enable nginx ```

二、系统部署实操步骤

2.1 源码拉取与编译

执行以下命令拉取开源版源码并编译打包：

``` 安装Git和Maven yum install -y git maven 拉取源码 git clone https://gitee.com/open-city/construction-land-use-permit-archive-system.git cd construction-land-use-permit-archive-system 编译打包（跳过单元测试） mvn clean package -DskipTests 提取打包后的可执行文件 cp target/permit-archive-system.jar /opt/ 提取前端打包文件 cp -r dist /usr/share/nginx/html/permit-archive/ ```

2.2 配置文件修改

在/opt/目录下新建application.yml文件，复制以下完整配置内容直接使用：

``` server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/permit_archive?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: Archive@2024 driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 50MB max-request-size: 100MB thymeleaf: cache: false mybatis-plus: configuration: map-underscore-to-camel-case: true mapper-locations: classpath:mapper/.xml file: upload-path: /opt/permit-archive/files/ ```

执行命令创建文件存储目录：mkdir -p /opt/permit-archive/files/

2.3 数据库导入

执行以下命令导入初始表结构和基础数据：

``` mysql -uroot -pArchive@2024 permit_archive < /opt/construction-land-use-permit-archive-system/sql/init.sql ```

2.4 服务启动与反向代理配置

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

``` nohup java -jar /opt/permit-archive-system.jar --spring.config.location=/opt/application.yml > /opt/permit-archive/logs.log 2>&1 & ```

修改Nginx配置文件/etc/nginx/conf.d/permit-archive.conf，复制以下内容：

``` server { listen 80; server_name 你的服务器公网IP; root /usr/share/nginx/html/permit-archive/dist; index index.html index.htm; 接口反向代理 location /api/ { proxy_pass http://127.0.0.1:8080/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } } ```

执行命令生效配置：nginx -s reload，同时放行服务器端口：

``` firewall-cmd --add-port=80/tcp --permanent firewall-cmd --reload ```

三、核心功能实操验证

3.1 登录验证

在浏览器输入服务器公网IP，进入登录页，默认管理员账号：admin，默认密码：Admin@123456，登录后第一时间修改密码。

3.2 档案入库操作

操作流程：左侧菜单点击【档案录入】→选择【建设用地规划许可证】分类→必填项必须全部填写：许可证编号、用地单位名称、用地位置、用地面积、发证日期、电子版扫描件（支持PDF/JPG格式，单文件不超过50M）→点击提交，系统自动生成唯一档案编号，可在【档案列表】中查看录入结果。

3.3 查询调阅操作

支持多维度检索：在【档案查询】页可输入许可证编号、用地单位名称、发证日期范围任意条件查询，调阅档案需提交申请，管理员审核通过后可下载电子版扫描件，所有调阅记录自动留痕。

3.4 权限配置操作

管理员进入【系统设置】→【用户管理】，可新增普通用户，分配录入、查询、审核、删除等不同权限，支持按部门划分数据权限，不同部门仅可查看本部门录入的档案。

四、常见问题排查

• 服务启动失败：执行cat /opt/permit-archive/logs.log查看错误日志，若提示端口被占用，执行netstat -tunlp | grep 8080获取占用进程PID，执行kill -9 PID后重启服务即可。
• 文件上传失败：若提示大小超限，修改application.yml中spring.servlet.multipart.max-file-size参数，重启服务即可；若提示无权限，执行chmod 777 /opt/permit-archive/files/授予目录权限。
• 页面无法访问：首先检查服务器安全组是否放行80端口，其次执行nginx -t验证Nginx配置是否正确，最后执行curl 127.0.0.1:8080验证后端服务是否正常启动。
• 数据库连接失败：检查application.yml中的数据库密码是否正确，执行telnet 127.0.0.1 3306验证端口连通性，若MySQL未启动执行systemctl start mysqld启动即可。