交通档案系统本地部署、数据迁移及权限配置全流程实操指南

一、前置准备工作

1.1 硬件&软件依赖

硬件最低配置：2核4G云服务器/本地主机，50G以上可用硬盘；软件依赖统一采用稳定版：CentOS7/Ubuntu20.04及以上操作系统，JDK11，MySQL8.0，Redis6.x，Nginx1.20+。

1.2 安装包获取

直接下载国内开源稳定版安装包，下载地址：https://gitee.com/open-traffic/traffic-archive-system/releases/download/v1.2.0/traffic-archive-v1.2.0.zip，下载后上传到服务器/opt目录，执行解压命令：

``` unzip /opt/traffic-archive-v1.2.0.zip -d /opt/traffic-archive ```

二、系统部署实操

2.1 基础环境安装

以CentOS7系统为例，执行以下命令安装所有依赖：

首先安装JDK11：

``` yum install -y java-11-openjdk java-11-openjdk-devel 验证安装，返回openjdk version "11.x.x"即为成功 java -version ```

然后安装MySQL8.0：

``` yum install -y https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm yum install -y mysql-community-server systemctl start mysqld && systemctl enable mysqld ```

安装完成后执行初始化操作，创建系统数据库：

``` 登录MySQL，初始密码在/var/log/mysqld.log中，执行grep 'temporary password' /var/log/mysqld.log获取 mysql -uroot -p你获取的初始密码 执行以下SQL创建数据库 CREATE DATABASE traffic_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; 导入初始表结构 use traffic_archive; source /opt/traffic-archive/sql/init.sql; exit; ```

安装Redis6.x：

``` yum install -y epel-release yum install -y redis systemctl start redis && systemctl enable redis ```

2.2 后端服务部署

进入后端目录cd /opt/traffic-archive/backend，修改application.yml配置文件，完整可复制配置如下：

```yaml server: port: 8080 servlet: context-path: /traffic spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/traffic_archive?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: root password: 你自己的MySQL密码 请替换为实际密码 redis: host: localhost port: 6379 password: "" 没有密码留空即可 servlet: multipart: max-file-size: 50MB max-request-size: 100MB cache: ttl: 1800 缓存默认时长30分钟，单位秒 ```

注意替换datasource下的password为你自己的MySQL密码，其他配置默认即可。然后启动后端服务：

``` nohup java -jar traffic-archive-admin.jar > /dev/null 2>&1 & 验证启动成功，执行以下命令返回{"status":"UP"}即为正常 curl http://localhost:8080/traffic/actuator/health ```

2.3 前端部署

将前端dist目录上传到/usr/share/nginx/html目录，修改Nginx配置文件/etc/nginx/nginx.conf，在http块下新增以下server配置：

``` server { listen 80; server_name 你的服务器公网IP; root /usr/share/nginx/html/dist; index index.html; 接口反向代理 location /traffic/ { proxy_pass http://localhost:8080/traffic/; proxy_set_header Host $host; } } ```

验证Nginx配置并重启：

``` nginx -t 返回success后执行重启 systemctl restart nginx ```

部署完成后访问http://你的服务器IP，默认管理员账号：admin，默认密码：123456。

三、核心功能配置实操

3.1 档案分类配置

登录后台后依次点击【系统管理】→【字典管理】，找到编码为traffic_archive_type的字典，点击右侧编辑按钮，根据业务需求新增档案分类，比如机动车档案、驾驶人档案、道路运输档案，对应的字典值分别为1、2、3，保存即可。注意字典值不可重复，否则会导致档案分类查询报错。

3.2 历史数据迁移导入

依次点击【档案管理】→【批量导入】→【下载模板】，打开模板后填写必填字段：档案编号、主体名称、档案类型、归档日期，其他字段按需填写。填写完成后点击【选择文件】上传，单次导入文件大小不能超过50M，数据量不超过10000条，超出请拆分文件分批导入。导入后可在【导入记录】页面查看导入结果，下载失败清单修改后重新上传即可。

3.3 分级权限配置

交通档案涉及敏感信息，必须配置分级权限，依次点击【系统管理】→【角色管理】→【新增角色】，按需求创建不同层级角色：

• 市级管理员：勾选全部权限，可操作全市所有档案
• 区级管理员：仅勾选本区档案的查询、编辑、归档权限
• 普通办事员：仅勾选档案查询权限，禁止开放删除、导出权限

创建完成后依次点击【系统管理】→【用户管理】，找到对应用户点击【分配角色】，绑定对应角色后保存即可。所有操作日志会自动留存，可在【操作日志】页面追溯所有用户操作记录。

四、常见问题排查

4.1 部署后无法访问后台

按以下步骤排查：

• 检查服务器安全组、防火墙是否开放80、8080端口，执行命令firewall-cmd --list-ports查看，未开放则执行firewall-cmd --add-port=80/tcp --permanent && firewall-cmd --reload开放端口
• 检查后端服务是否正常运行，执行ps -ef | grep java查看是否有traffic-archive-admin.jar进程，无进程则查看/opt/traffic-archive/backend/logs/error.log排查错误
• 检查Nginx配置是否正确，执行nginx -t验证，返回ok则配置正常

4.2 档案导入失败

排查以下几点：

• 检查文件格式是否为.xlsx，不得修改模板表头字段
• 检查必填字段是否为空，档案编号是否重复
• 检查归档日期格式是否为yyyy-MM-dd，不得使用其他格式

4.3 档案查询速度慢

执行以下优化操作：首先给数据库表加索引，执行以下SQL：

```sql ALTER TABLE `traffic_archive` ADD INDEX idx_archive_no (`archive_no`), ADD INDEX idx_archive_type (`archive_type`), ADD INDEX idx_create_time (`create_time`); ```

然后修改application.yml中的cache.ttl值为3600（缓存1小时），重启后端服务即可。