法律数字档案馆系统从零部署实操指南 全步骤可直接落地复用

一、前置准备

1.1 硬件要求

最低配置：2核4G内存云服务器/本地主机，磁盘≥100G（存储电子卷宗），公网带宽≥5M（如需外网访问）

1.2 软件依赖安装

所有依赖均提供官方稳定版安装路径/命令，可直接执行：

• JDK11：下载地址 https://jdk.java.net/java-se-ri/11，CentOS/Ubuntu可直接执行命令：
  ```bash Ubuntu/Debian apt update && apt install openjdk-11-jdk -y CentOS yum install java-11-openjdk-devel -y ``` 安装后执行java -version验证，返回版本号为11.x即为成功
• MySQL8.0：官方镜像安装命令：
  ```bash docker run -d --name mysql-law -p 3306:3306 -e MYSQL_ROOT_PASSWORD=root@123456 -e MYSQL_DATABASE=law_archive -e MYSQL_USER=law_user -e MYSQL_PASSWORD=law@123456 mysql:8.0 --lower-case-table-names=1 ``` 必须添加--lower-case-table-names=1参数，否则会出现表不存在报错，执行后等待30秒，执行docker ps看到mysql-law容器状态为up即为成功
• MinIO对象存储（存储电子档案文件）：安装命令：
  ```bash docker run -d --name minio-law -p 9000:9000 -p 9001:9001 -v /opt/minio/data:/data -e MINIO_ROOT_USER=minioadmin -e MINIO_ROOT_PASSWORD=minio@123456 minio/minio server /data --console-address ":9001" ``` 安装后访问http://你的服务器IP:9001，用上面的账号密码登录，创建名为law-archive的存储桶，权限设置为私有即可

二、系统部署全步骤

2.1 系统包下载

执行以下命令直接下载稳定版安装包：

```bash cd /opt && wget https://gitee.com/open-law-platform/law-digital-archive/releases/download/v1.2.0/law-archive.jar ```

2.2 配置文件编写

在/opt目录下创建application.yml文件，复制以下完整配置，只需修改自定义参数即可：

```yaml server: port: 8090 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/law_archive?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: law_user password: law@123456 如果你修改了MySQL用户密码请替换此处 driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 100MB 单卷宗最大支持100M max-request-size: 100MB minio: endpoint: http://127.0.0.1:9000 accessKey: minioadmin secretKey: minio@123456 如果你修改了MinIO密钥请替换此处 bucketName: law-archive ocr: enable: true 开启卷宗OCR自动识别功能 model-path: /opt/ocr-model ```

OCR模型下载命令：cd /opt && wget https://paddleocr.bj.bcebos.com/PP-OCRv3/chinese/ch_PP-OCRv3_infer.tar && tar -xf ch_PP-OCRv3_infer.tar && mv ch_PP-OCRv3_infer ocr-model

2.3 服务启动与验证

执行以下命令启动服务：

```bash nohup java -jar law-archive.jar --spring.config.location=./application.yml > archive.log 2>&1 & ```

启动后等待2分钟，执行tail -f archive.log查看日志，出现“启动成功”字样即为部署完成。访问http://你的服务器IP:8090，默认管理员账号：admin 密码：admin@123456，登录成功即可进入系统。

三、核心功能实操配置

3.1 档案元数据模板配置

法律档案需固定录入字段，可直接按以下步骤配置模板：

• 登录后进入【系统管理】-【元数据模板】，点击新增
• 依次添加字段：案件编号（字符串、必填）、当事人姓名（字符串、必填）、案由（字符串、必填）、立案日期（日期、必填）、归档日期（日期、必填）、保管期限（下拉选项：30年/永久/10年、必填）
• 保存后勾选该模板为默认模板，后续录入档案时自动带出所有字段，无需手动添加

3.2 权限分级配置

符合司法档案保密要求，可配置三级角色：

• 系统管理员：拥有全部权限，负责系统配置、用户管理
• 档案录入员：仅可上传、编辑自己负责的档案，不可下载、导出涉密档案
• 档案查询员：仅可查询公开范围的档案，不可编辑、下载

操作路径：【系统管理】-【角色管理】，新增对应角色，勾选对应菜单权限后，在用户管理中给相应用户分配角色即可。

3.3 电子卷宗上传与识别

上传操作：进入【档案管理】-【新增档案】，填写元数据后，上传PDF/图片格式的卷宗，系统自动触发OCR识别，提取卷宗内的文字内容，支持全文检索。

四、常见卡壳问题排查

• 端口占用报错：执行lsof -i:8090查看占用进程ID，执行kill -9 进程ID杀死进程后重新启动即可
• 数据库连接失败：检查MySQL容器是否正常运行，确认配置文件中数据库密码、用户名和安装时设置的一致，3306端口未被防火墙拦截
• 卷宗上传失败：检查MinIO容器是否正常运行，law-archive存储桶是否存在，配置文件中MinIO密钥是否正确
• OCR识别失败：确认/opt/ocr-model目录下存在模型文件，执行ls /opt/ocr-model能看到model.pdiparams等文件即为正常，否则重新下载模型

部署完成后可直接投入使用，所有功能均符合《人民法院电子诉讼档案管理办法》的合规要求。