从零搭建开源司法文书档案软件 本地部署全流程实操指南

前期准备

软硬件环境要求

CPU最低要求2核，内存最低4G，硬盘剩余空间不低于50G，操作系统支持Windows 10/11、Ubuntu 20.04+、CentOS 7+，本文以Windows 10为例演示，其他系统操作逻辑完全一致。

依赖工具下载安装

需要提前安装4款基础工具，所有安装包直接复制链接下载即可，安装步骤标注如下：

• Git 64位安装包：https://npm.taobao.org/mirrors/git-for-windows/v2.41.0.windows.1/Git-2.41.0-64-bit.exe，安装全程点击下一步即可，安装完成后打开cmd输入git --version，输出版本号即安装成功。
• Java JDK11：https://download.oracle.com/java/11/archive/jdk-11.0.20_windows-x64_bin.exe，默认路径安装即可，安装完成后配置系统环境变量：新建系统变量JAVA_HOME，值为默认安装路径C:\Program Files\Java\jdk-11，在Path变量中新增两条记录：%JAVA_HOME%\bin、%JAVA_HOME%\jre\bin，打开cmd输入java -version，输出版本号即成功。
• MySQL 8.0：https://cdn.mysql.com/Downloads/MySQL-8.0/mysql-8.0.34-winx64.zip，下载后解压到D:\mysql-8.0，在根目录新建my.ini文件，复制粘贴以下完整配置： ``` [mysqld] port=3306 basedir=D:/mysql-8.0 datadir=D:/mysql-8.0/data default-authentication-plugin=mysql_native_password character-set-server=utf8mb4 [client] default-character-set=utf8mb4 ``` 以管理员身份打开cmd，进入D:\mysql-8.0\bin，依次执行以下命令：
  1. 初始化：mysqld --initialize --console，记下输出末尾后的临时密码
  2. 安装服务：mysqld install mysql
  3. 启动服务：net start mysql
  4. 修改密码：mysql -u root -p，输入临时密码登录后，执行ALTER USER 'root'@'localhost' IDENTIFIED BY '123456';，本文统一用密码123456，后续直接使用即可。
• Node.js 16.x：https://nodejs.org/dist/v16.20.0/node-v16.20.0-x64.msi，默认安装即可，安装完成后打开cmd执行命令更换国内源加速：npm config set registry https://registry.npmmirror.com，输入node -v输出版本号即成功。

源码获取与基础配置

拉取项目源码

打开cmd，进入你要存放项目的目录，比如D:\project，执行以下命令拉取完整源码： ``` git clone https://github.com/Code-020/legal-archive-system.git cd legal-archive-system ``` 源码分为后端服务（server目录）和前端页面（client目录）两个部分，无需额外拆分。

初始化数据库

打开cmd，输入mysql -u root -p，输入密码123456登录，依次执行以下命令自动创建数据库并导入数据： ``` CREATE DATABASE legal_archive DEFAULT CHARACTER SET utf8mb4; USE legal_archive; source D:/project/legal-archive-system/server/doc/init.sql; exit; ``` 所有表结构和基础权限数据已经预设在init.sql中，无需手动创建。

修改后端连接配置

打开server/src/main/resources/application-dev.yml，直接替换为以下完整配置，如果你修改过MySQL端口或密码，对应调整即可： ``` server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/legal_archive?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai username: root password: 123456 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: legalarchive: debug ``` 如果8080端口被占用，将server.port修改为其他端口比如8081即可。

启动服务与系统使用

启动后端服务

在项目根目录打开cmd，进入server目录，项目自带Maven包装器，无需提前安装Maven，直接执行打包命令： ``` cd server .\mvnw clean package -DskipTests ``` 等待打包完成，控制台输出BUILD SUCCESS即为成功，然后执行启动命令： ``` java -jar target/legal-archive-1.0.0.jar ``` 等待10-30秒，控制台输出Started LegalArchiveApplication即为后端启动成功，不要关闭该cmd窗口。

启动前端服务

新开一个cmd窗口，进入项目根目录的client目录，依次执行以下命令： ``` cd D:\project\legal-archive-system\client npm install npm run dev ``` 等待编译完成，控制台输出Local: http://localhost:5173/即为前端启动成功。

首次登录与核心功能操作

打开浏览器访问http://localhost:5173，输入默认管理员账号：admin，密码：admin123，点击登录即可进入后台，核心操作步骤如下：

• 文书归档：左侧菜单选择「档案管理」-「新增档案」，填写案号、案件名称、当事人信息、归档日期，上传电子文书PDF，点击提交即可完成归档，系统自动生成全文检索索引。
• 档案检索：在首页搜索框输入案号、当事人姓名或文书关键词，点击搜索即可获取结果，支持按案件类型、归档日期筛选，点击条目可在线预览或下载原文件。
• 权限分配：进入「系统设置」-「用户管理」，点击新增用户，填写账号密码，选择对应角色（管理员/普通科员/档案管理员），不同角色自动分配对应查看、编辑权限，满足分级管理要求。
• 数据备份：进入「系统设置」-「数据备份」，点击「立即备份」，系统自动打包数据库和所有上传文书，下载备份文件保存到安全位置即可，建议每周备份一次。

常见问题排查

• 后端启动提示数据库连接失败：检查MySQL服务是否正常启动，检查配置文件中的密码、端口是否正确，检查防火墙是否拦截3306端口。
• npm install安装失败：执行npm cache clean --force清除缓存后重新安装，确认已经更换淘宝源。
• 上传大文件提示失败：检查配置文件中的max-file-size参数，修改为大于你要上传的文件大小即可。