交通档案管理系统从零部署到核心功能配置全流程实操指南

一、前置环境准备

本次部署采用通用云服务器环境，最低配置要求为2核4G内存、50G云盘、CentOS7.9 64位操作系统，所有操作均通过SSH连接服务器执行。

1.1 基础依赖安装

依次执行以下命令安装所有必需依赖，所有命令可直接复制执行：

``` 安装JDK1.8 yum install -y java-1.8.0-openjdk-devel 验证安装，返回openjdk version "1.8.0_xxx"即为成功 java -version 安装MySQL8.0 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'初始密码' 执行以下SQL修改密码并创建业务库 ALTER USER 'root'@'localhost' IDENTIFIED BY 'Root@2024'; create database traffic_archive default character set utf8mb4 collate utf8mb4_general_ci; create user 'traffic'@'%' identified by 'Traffic@2024'; grant all on traffic_archive. to 'traffic'@'%'; flush privileges; exit; 安装Redis6.x yum install -y epel-release yum install -y redis systemctl start redis systemctl enable redis 设置Redis密码 redis-cli config set requirepass Redis@2024 redis-cli config rewrite 安装Nginx1.20 yum install -y nginx systemctl start nginx systemctl enable nginx ```

二、系统部署实操

2.1 后端服务部署

执行以下命令下载部署包并配置：

``` 创建部署目录 mkdir -p /opt/traffic-archive cd /opt/traffic-archive 下载后端jar包 wget https://gitee.com/open-traffic/traffic-archive-system/releases/download/v1.0.0/traffic-archive-admin.jar 创建配置文件 vi application.yml ```

application.yml完整配置如下，可直接复制使用：

``` server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/traffic_archive?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: traffic password: Traffic@2024 redis: host: 127.0.0.1 port: 6379 password: Redis@2024 servlet: multipart: max-file-size: 100MB max-request-size: 100MB mybatis-plus: mapper-locations: classpath:mapper/.xml configuration: map-underscore-to-camel-case: true logging: level: com.traffic.archive: info file: name: /var/log/traffic-archive/admin.log ```

配置完成后执行以下命令启动后端服务，并配置开机自启：

``` 创建日志目录 mkdir -p /var/log/traffic-archive 创建开机自启服务 vi /etc/systemd/system/traffic-archive-admin.service ```

自启服务配置内容如下：

``` [Unit] Description=traffic-archive-admin After=network.target mysqld.service redis.service [Service] Type=simple User=root WorkingDirectory=/opt/traffic-archive ExecStart=/usr/bin/java -jar traffic-archive-admin.jar --spring.config.location=./application.yml Restart=always RestartSec=5 [Install] WantedBy=multi-user.target ```

执行以下命令启动服务：

``` systemctl daemon-reload systemctl start traffic-archive-admin systemctl enable traffic-archive-admin 验证启动是否成功，返回200即为正常 curl -I http://127.0.0.1:8080/doc.html ```

2.2 前端页面部署

执行以下命令部署前端页面：

``` 下载前端部署包 wget https://gitee.com/open-traffic/traffic-archive-system/releases/download/v1.0.0/traffic-archive-web.zip 解压到Nginx站点目录 unzip traffic-archive-web.zip -d /usr/share/nginx/html/traffic-archive 创建Nginx配置文件 vi /etc/nginx/conf.d/traffic-archive.conf ```

Nginx配置内容如下，将`你的服务器IP`替换为你实际的公网IP：

``` server { listen 80; server_name 你的服务器IP; location / { root /usr/share/nginx/html/traffic-archive; index index.html index.htm; try_files $uri $uri/ /index.html; } location /prod-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; } } ```

执行以下命令重载Nginx配置：

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

此时直接在浏览器访问你的服务器公网IP，即可进入系统登录页，默认账号：admin，默认密码：Admin@123456。

三、核心功能配置实操

3.1 档案分类配置

• 第一步：登录系统后进入系统管理-字典管理模块，找到字典类型为`traffic_archive_type`的字典项，点击编辑
• 第二步：按需新增档案分类，比如道路施工档案、客运车辆档案、违法处理档案、从业人员档案，对应字典值分别填写1、2、3、4，排序按需设置后保存
• 第三步：进入档案管理-档案设置模块，对应每个分类配置必填字段，比如客运车辆档案需勾选车牌号码、所属企业、车辆类型、年检有效期，配置后点击保存即可生效

3.2 业务规则配置

• 上传大小调整：修改application.yml中`spring.servlet.multipart.max-file-size`参数，比如调整为200MB后，重启后端服务即可生效
• 查询权限配置：进入系统管理-角色管理，新建“档案查询员”角色，仅勾选档案管理下的档案查询、档案导出权限，绑定对应用户后，该用户仅能查询无权修改删除档案
• OCR自动识别配置（可选）：如果需要自动识别驾驶证、行驶证信息，在application.yml中新增以下配置，填入你在百度智能云申请的OCR接口密钥，重启后端服务即可： ``` ocr: enable: true app-key: 你的百度OCR AppKey secret-key: 你的百度OCR SecretKey ```

四、常见问题排查

• 后端启动失败：查看日志`cat /var/log/traffic-archive/admin.log`，常见错误为MySQL/Redis连接失败，检查对应服务是否启动、配置文件中的密码是否正确
• 前端访问404：检查Nginx配置的root路径是否正确，解压的前端文件是否完整存放在`/usr/share/nginx/html/traffic-archive`目录下
• 档案上传失败：检查文件大小是否超过配置的上限，执行`df -h`查看服务器磁盘使用率是否满额