汽车行业综合档案管理系统本地化部署与落地实操全流程指南

一、前置环境准备

所有资源均提供直接可访问地址，无需额外搜索：

• 硬件要求：2核4G云服务器/本地主机，剩余存储空间≥50G（适配汽车行业车辆、供应商、员工三类档案存储需求）
• 软件安装包下载：
  • JDK11：https://adoptium.net/zh-CN/temurin/releases/?version=11
  • MySQL8.0：https://dev.mysql.com/downloads/mysql/8.0.html
  • 汽车版综合档案管理系统安装包：https://gitee.com/auto-archive/auto-archive-system/releases/download/v1.2.0/auto-archive-v1.2.0.zip

二、环境配置操作

2.1 JDK安装与环境变量配置

Windows操作：运行JDK安装包，默认路径安装完成后，右键「此电脑」-「属性」-「高级系统设置」-「环境变量」，在系统变量中新建变量JAVA_HOME，值填写C:\Program Files\Eclipse Adoptium\jdk-11.0.20.8-hotspot，找到Path变量编辑，新增%JAVA_HOME%\bin，保存后打开cmd执行java -version，返回openjdk version "11.0.20"即为配置成功。

Linux操作：执行命令解压安装包：tar -zxvf OpenJDK11U-jdk_x64_linux_hotspot_11.0.20_8.tar.gz -C /usr/local/，执行vi /etc/profile在末尾添加以下内容： ``` export JAVA_HOME=/usr/local/jdk-11.0.20+8 export PATH=$JAVA_HOME/bin:$PATH ``` 保存后执行source /etc/profile生效，同样执行java -version验证配置。

2.2 MySQL数据库配置

安装MySQL完成后，执行以下命令完成初始配置：

1. 登录数据库：mysql -u root -p，输入安装时设置的root密码进入操作界面
2. 创建专属数据库：CREATE DATABASE auto_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
3. 创建专用账号并授权： ``` CREATE USER 'auto_user'@'%' IDENTIFIED BY 'Auto@2024Archive'; GRANT ALL PRIVILEGES ON auto_archive. TO 'auto_user'@'%'; FLUSH PRIVILEGES; ```
4. 导入初始表结构：解压系统安装包，找到sql目录下的auto_archive_init.sql，执行命令：mysql -u auto_user -pAuto@2024Archive auto_archive < /path/to/auto_archive_init.sql（Windows替换为sql文件实际存放路径）

三、系统部署与启动

3.1 安装包解压与配置修改

Windows操作：右键安装包解压到D盘根目录，进入conf文件夹找到application.yml文件，将存储路径修改为D:\\auto_archive\\car\\、D:\\auto_archive\\supplier\\、D:\\auto_archive\\staff\\即可。

Linux操作：先执行yum install -y unzip安装解压工具，再执行unzip auto-archive-v1.2.0.zip -d /opt/auto_archive/解压，执行mkdir -p /data/auto_archive/{car,supplier,staff,backup}创建存储目录。

application.yml完整可复制配置如下，无需额外修改参数即可直接使用： ```yaml server: port: 8090 servlet: context-path: /auto-archive spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/auto_archive?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: auto_user password: Auto@2024Archive servlet: multipart: max-file-size: 100MB max-request-size: 100MB 汽车行业专属档案配置 auto-config: 车辆档案存储路径 car-archive-path: /data/auto_archive/car/ 供应商档案存储路径 supplier-archive-path: /data/auto_archive/supplier/ 员工档案存储路径 staff-archive-path: /data/auto_archive/staff/ 允许上传的档案格式 allow-file-type: jpg,png,pdf,docx,xlsx,mp4 ```

3.2 系统启动与验证

Windows操作：进入bin目录，双击startup.bat启动服务，弹出的运行窗口无报错即为启动成功。

Linux操作：执行cd /opt/auto_archive/bin && chmod +x startup.sh && ./startup.sh启动，执行tail -f /opt/auto_archive/logs/auto-archive.log查看日志，出现「启动成功」字样即可。

打开浏览器访问http://127.0.0.1:8090/auto-archive，默认管理员账号：admin，密码：Admin@123456，成功登录即部署完成。

四、汽车版专属功能实操配置

4.1 车辆档案库初始化

登录后左侧菜单选择【基础配置】-【档案分类管理】，点击新增分类，依次添加：车辆VIN档案、车辆出厂检测报告、车辆维修记录、车辆销售台账、车辆召回记录，每个分类勾选【允许附件上传】，最大附件数填10，保存后自动生成对应分类的档案存储目录。

进入【基础配置】-【系统参数】，开启VIN码自动校验开关，后续导入档案时系统会自动校验VIN码17位编码规则，不符合规则的档案直接拦截，避免无效数据入库。

4.2 批量导入档案配置

选择【系统工具】-【导入模板管理】，下载汽车版专用批量导入模板，模板必填字段：档案编号、所属分类、VIN码、车辆型号、档案生成日期、附件路径，填写完成后点击批量导入，选择文件上传即可，系统会自动通过VIN码关联对应车辆的所有档案，支持单VIN码关联最多50份档案。

4.3 权限与自动备份配置

选择【系统管理】-【角色管理】，新增「4S店档案管理员」角色，勾选权限：车辆档案查询、车辆档案编辑、维修记录上传；新增「集团总部管理员」角色，勾选全量权限，在【用户管理】中对应用户绑定角色即可完成权限隔离。

进入【系统工具】-【备份管理】，点击新增备份任务，备份频率选择每日凌晨2点，备份内容选择全量档案+数据库，备份存储路径配置为/data/auto_archive/backup/，开启自动备份后系统会按周期生成备份文件，可直接下载恢复。

五、常见问题排查

• 启动失败提示数据库连接失败：检查application.yml中数据库IP、端口、账号密码是否正确，确认MySQL服务已启动，3306端口无防火墙拦截
• 上传附件提示大小超出限制：修改application.yml中spring.servlet.multipart.max-file-size参数为需要的大小，重启服务后生效
• VIN码匹配失败：检查导入的VIN码是否为17位纯大写，无空格、特殊字符，系统默认严格执行GB 16735-2019 VIN编码规则校验
• 访问页面无响应：检查8090端口是否开放，Linux执行firewall-cmd --add-port=8090/tcp --permanent && firewall-cmd --reload开放端口即可