一、前置准备
我们选择「档案大师开源社区版」(完全免费,原生支持公路运输多类型档案),需要先准备3项可复制操作的环境:
- 本地/云服务器一台:建议配置2核4G云服务器(腾讯云轻量、阿里云ECS学生版/入门版均可),Windows Server 2019+或CentOS 7.9+;本地的话用Windows 10/11家庭版/专业版
- 数据库:MySQL 8.0.36(不要用5.7以下版本,社区版支持多字段模糊检索)
- JDK 17:档案大师基于SpringBoot 3.0开发,必须用JDK 17及以上LTS版本
1.1 环境一键安装(Windows通用版)
为避免卡壳,直接用「小皮面板(phpStudy)」一键安装环境,步骤如下:
- 访问小皮面板官网下载Windows版:https://www.xp.cn/download.html
- 下载完成后双击安装,默认路径即可,勾选「创建桌面快捷方式」
- 打开小皮面板,点击左侧「软件商店」,搜索安装以下3项:
- JDK 17.0.10(带OpenJDK标识的免费版即可)
- MySQL 8.0.36
- PHPStudy Nginx 1.24(可选,用于本地局域网外部访问)
- 安装完成后,点击左侧「首页」,一键启动JDK、MySQL、Nginx
- 验证JDK:按Win+R输入cmd,回车后输入
java -version,显示「openjdk version "17.0.10"」即为成功
- 验证MySQL:点击小皮面板左侧「数据库」,默认用户名root,密码root,点击「管理」打开phpMyAdmin能进入即为成功
二、软件下载与数据库配置
2.1 软件下载
访问档案大师开源社区版Gitee仓库:https://gitee.com/jianguo-cloud/archive-master/releases,下载最新版本的「archive-master-community-x.x.x.jar」包,保存到D盘根目录下(路径尽量简单,不要有中文)。
2.2 数据库创建与导入
- 在小皮面板的phpMyAdmin页面,点击左侧「新建」,输入数据库名
archive_transport,选择排序规则utf8mb4_general_ci,点击「创建」
- 再次访问Gitee仓库的「assets」目录:https://gitee.com/jianguo-cloud/archive-master/tree/master/assets,下载
archive_transport.sql文件
- 回到phpMyAdmin的
archive_transport数据库,点击顶部「导入」,选择下载的archive_transport.sql文件,点击「执行」,显示「导入成功,共执行127条查询」即为完成
2.3 修改软件配置文件
配置文件不需要额外安装编辑器,右键jar包所在的D盘根目录,新建文本文档,命名为application-transport.yml,完整内容如下(所有参数可直接复制使用,如有特殊需求再改):
```yaml
server:
port: 8080
spring:
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/archive_transport?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
username: root
password: root
servlet:
multipart:
max-file-size: 100MB
max-request-size: 100MB
archive:
storage:
type: local
local:
path: D:/transport_archive_files
```
注意:将配置文件的后缀从.txt改为.yml,保存时编码选择「UTF-8 with BOM」或者「UTF-8」(避免中文乱码)。
三、软件启动与本地/局域网访问
3.1 本地启动
- 在D盘根目录下,新建文本文档,命名为
start_transport_archive.bat,内容如下:
```batch
@echo off
chcp 65001
java -jar archive-master-community-x.x.x.jar --spring.profiles.active=transport
pause
```
注意:将archive-master-community-x.x.x.jar替换成你实际下载的文件名(比如archive-master-community-1.2.3.jar),保存为.bat文件,编码同样选UTF-8。
- 双击
start_transport_archive.bat,等待10-30秒,显示「Started ArchiveMasterApplication in x.xxx seconds」即为启动成功
- 本地访问:打开Chrome/Edge浏览器,输入
http://localhost:8080,进入登录界面
3.2 局域网外部访问(企业员工共享档案用)
- 打开小皮面板左侧「网站」,点击「创建网站」,域名填写你的局域网IP(按Win+R输入cmd,回车后输入
ipconfig,找到IPv4地址,比如192.168.1.100),端口保留80,根目录随便选,点击「创建」
- 点击该网站的「设置」,进入「反向代理」,点击「添加反向代理」,代理名称填
transport_archive,代理目录填/,目标URL填http://127.0.0.1:8080,点击「保存」
- 局域网内其他员工,输入你的IPv4地址(比如
http://192.168.1.100)即可访问
四、公路运输专属档案配置与数据录入
4.1 初始登录与权限设置

默认账号:admin,默认密码:123456,登录后必须先修改密码:点击右上角头像→「个人中心」→「密码修改」,输入旧密码和新密码(建议至少8位,包含字母和数字),点击「保存」。
添加员工账号:点击左侧「系统管理」→「用户管理」→「新增」,填写账号、姓名、密码,角色选择「档案管理员」(可操作所有档案)或「普通员工」(仅可查看、上传自己负责的档案),部门可自定义(比如「运输一部」「行政部」),点击「保存」。
4.2 配置公路运输专属档案分类
系统已内置部分通用分类,我们需要补充运输专属的,步骤如下:
- 点击左侧「档案管理」→「分类管理」→「新增」
- 创建一级分类「公路运输核心档案」,点击「保存」
- 选中「公路运输核心档案」,点击「新增子分类」,依次创建以下4个二级子分类:
- 车辆档案:上传行驶证、营运证、保险单、维修记录、年检报告
- 司机档案:上传驾驶证、从业资格证、身份证、健康证、入职合同
- 运单档案:上传纸质运单扫描件、电子运单PDF、回执单
- 合同档案:上传运输合同、车辆租赁/购买合同、司机外包合同
4.3 批量录入数据(车辆档案为例)
单个录入太麻烦,我们用系统的批量导入功能:
- 点击左侧「档案管理」→「档案列表」→「导入」
- 选择分类「公路运输核心档案→车辆档案」,点击「下载导入模板」
- 打开下载的Excel模板,按要求填写必填项(带的):
- 档案名称:格式为「车牌号+车辆类型」,比如「粤A12345 重型半挂牵引车」
- 档案编号:格式为「CL-YYYYMMDD-序号」,比如「CL-20240601-001」
- 档案到期日:比如保险单到期日、年检到期日
- 负责人:选择已添加的员工账号
- 保存Excel模板,回到导入页面,选择模板文件,点击「预览导入」,确认无误后点击「确认导入」
- 导入成功后,点击「档案列表」,选中刚导入的车辆档案,点击「批量上传附件」,选择对应的行驶证、营运证等扫描件,点击「上传」
五、高频实用功能设置
5.1 到期提醒设置(避免超期)
点击左侧「系统管理」→「提醒规则」→「新增」,依次设置车辆保险、年检,司机驾驶证、从业资格证的到期提醒:
- 提醒名称:比如「车辆保险到期提醒」
- 触发字段:选择「档案到期日」
- 提前天数:设置30天、15天、7天各一条
- 提醒对象:选择「档案负责人」
- 提醒方式:勾选「系统内消息」
5.2 多条件检索设置(快速找档案)
点击左侧「档案管理」→「分类管理」,选中任意子分类,点击「编辑」,在「自定义字段」区域添加运输专属字段:
- 车辆档案:车牌号、车辆类型、载重吨数、发动机号、车架号
- 司机档案:姓名、驾驶证号、从业资格证号、准驾车型、入职日期
- 运单档案:运单号、发货方、收货方、货物类型、运输金额
保存后,在「档案列表」页面可以直接用这些自定义字段进行多条件模糊检索。