进口文书档案管理系统本地部署+核心功能配置实操全指南

一、前置环境准备

部署前需完成以下环境安装，所有命令可直接复制执行：

• JDK 11：CentOS执行yum install -y java-11-openjdk-devel，Ubuntu执行apt install -y openjdk-11-jdk，验证命令java -version，返回版本号为11.x即为正常
• MySQL 8.0：安装完成后登录MySQL执行以下命令创建库和用户：

  create database import_archive default character set utf8mb4 collate utf8mb4_general_ci;
  grant all on import_archive. to 'archive_user'@'%' identified by 'Archive@2024';
  flush privileges;

• Redis 6.x：CentOS执行yum install -y redis && systemctl start redis && systemctl enable redis，验证命令redis-cli ping，返回PONG即为正常

系统安装包下载地址：https://gitee.com/opensource-doc/import-archive-system/releases/download/v1.2.0/import-archive-system-v1.2.0.tar.gz

二、系统部署步骤

2.1 基础配置修改

执行以下命令下载并解压安装包：

wget https://gitee.com/opensource-doc/import-archive-system/releases/download/v1.2.0/import-archive-system-v1.2.0.tar.gz
tar zxvf import-archive-system-v1.2.0.tar.gz
cd import-archive-system-v1.2.0

创建文件存储目录：mkdir -p /data/import-archive/files && chmod 755 /data/import-archive/files

修改conf目录下的application.yml配置文件，完整可复制配置如下：

```yaml
server:
port: 8080
spring:
datasource:
url: jdbc:mysql://127.0.0.1:3306/import_archive?useUnicode=true&characterEncoding=utf8mb4&useSSL=false&serverTimezone=Asia/Shanghai
username: archive_user
password: Archive@2024
driver-class-name: com.mysql.cj.jdbc.Driver
redis:
host: 127.0.0.1
port: 6379
password: ''
servlet:
multipart:
max-file-size: 50MB
max-request-size: 100MB
system:
档案存储路径，和上面创建的目录保持一致
archive-storage-path: /data/import-archive/files
进口文书专属32位加密密钥，可自定义修改
encrypt-key: 8a7d6f5e4c3b2a109f8e7d6c5b4a3928
```

2.2 初始化&启动

执行数据库初始化命令：java -jar import-archive-system.jar --init-db，看到控制台输出“数据库初始化完成”后按Ctrl+C终止进程即可。

后台启动系统命令：nohup java -jar import-archive-system.jar > /dev/null 2>&1 &

启动验证：执行curl http://127.0.0.1:8080/health，返回{"code":200,"msg":"success"}即为启动成功。默认后台访问地址为http://你的服务器IP:8080，初始管理员账号admin，密码Admin@123，首次登录必须修改密码。

三、核心功能配置实操

3.1 进口文书分类规则配置

操作路径：登录后台→系统管理→档案分类→新增分类，按以下层级配置分类，必须开启每个分类的「进口专属校验」开关：

• 一级分类：报关单证、商检单证、原产地证、运输单据、合同协议、其他文件
• 二级分类（报关单证下）：进口报关单、随附发票、装箱单、报关委托书
• 二级分类（运输单据下）：海运提单、空运运单、铁路运单

配置自动编号规则：分类管理→编号规则，设置规则为「分类编码+年份+6位流水号」，比如报关单分类编码为BG，2024年第一份档案编号为BG2024000001，系统会自动生成无需手动填写。

3.2 OCR自动识别归档配置

首先开通免费OCR服务：访问https://ai.baidu.com/tech/ocr/general，注册账号后创建通用文字识别应用，获取API Key和Secret Key，免费额度为每天500次调用，满足中小微企业日常需求。

系统配置路径：系统设置→OCR配置，填入获取的API Key和Secret Key，开启「进口文书自动识别归档」开关，必须勾选报关单号、合同号、进出口日期、收发货人4个核心识别字段，保存后即可生效。测试：上传一份扫描版进口报关单，10秒内系统会自动识别核心字段，匹配对应分类归档。

3.3 权限隔离配置

进口文书涉及商业机密，需按角色配置权限，操作路径：权限管理→角色管理，新建3个默认角色：

• 报关员：仅可上传、查看自己提交的文书，无编辑、删除权限
• 档案管理员：可查看、编辑全部分类文书，可审批档案导出申请
• 超级管理员：仅可配置系统参数、管理用户账号，无文书查看权限

必须开启「操作日志审计」开关，所有上传、下载、修改文书的操作都会留痕，可随时导出用于合规审计。

四、日常操作&问题排查

4.1 日常操作规范

• 上传文书仅支持PDF、JPG、PNG格式，单个文件大小不超过50MB
• 报关单号必须为18位海关规范编号，系统会自动校验，不符合规则无法上传
• 导出电子档案需提交申请，经档案管理员审批通过后才可下载

4.2 常见问题排查

• 系统无法访问：检查服务器8080端口是否开放，执行firewall-cmd --add-port=8080/tcp --permanent && firewall-cmd --reload开放端口
• 文件上传失败：检查存储目录权限，执行chmod -R 755 /data/import-archive/files修复权限
• OCR识别失败：检查百度OCR Key是否填写正确，登录百度智能云后台查看是否剩余调用额度