司法档案管理系统快速部署实操：零门槛上手可直接落地

实操前置准备

本次实操基于Docker容器部署开源司法档案管理系统，适配主流Linux服务器（Ubuntu 20.04+/CentOS 7+），需提前安装Docker及Docker Compose。若未安装curl，需先执行对应系统的安装命令：

Ubuntu系统安装curl：sudo apt install curl -y

CentOS系统安装curl：sudo yum install curl -y

安装Docker及Docker Compose命令如下：

Ubuntu 20.04+：

``` sudo apt update && sudo apt install -y docker.io docker-compose sudo systemctl enable --now docker ```

CentOS 7+：

``` sudo yum install -y docker docker-compose sudo systemctl enable --now docker ```

具体部署步骤

1. 创建部署目录并拉取配置文件

执行命令创建部署目录并进入目录：

``` mkdir -p /opt/judicial-archives && cd /opt/judicial-archives ```

拉取官方docker-compose配置文件：

``` curl -o docker-compose.yml https://raw.githubusercontent.com/open-source-judicial/archive-management/master/docker-compose.yml ```

2. 修改核心配置（必填）

打开docker-compose.yml文件：vi docker-compose.yml，重点修改两处配置，务必将所有"YourCustomXXX"替换为强密码，避免系统安全风险，完整配置模板如下：

``` version: '3.8' services: db: image: mysql:8.0 restart: always environment: MYSQL_ROOT_PASSWORD: 'YourRootPass@2024' MYSQL_DATABASE: 'archive_db' MYSQL_USER: 'archive_operator' MYSQL_PASSWORD: 'YourUserPass@2024' volumes: - db_data:/var/lib/mysql command: --default-authentication-plugin=mysql_native_password web: image: judicial/archive-web:v1.2 restart: always ports: - '8080:8080' depends_on: - db environment: DB_HOST: db DB_PORT: 3306 DB_USER: archive_operator DB_PASS: YourUserPass@2024 FILE_UPLOAD_PATH: /app/uploads volumes: db_data: ```

3. 启动系统并初始化数据库

执行启动命令，后台运行所有服务：

``` docker-compose up -d ```

查看web服务容器名（替换为实际输出的容器名）：

``` docker ps | grep archive-web ```

执行数据库初始化脚本，创建档案所需表结构：

``` docker exec -it 生成的web容器名 node init-db.js ```

4. 验证系统访问

若为云服务器，需在安全组入站规则中开放TCP 8080端口；本地服务器直接访问：

浏览器输入：http://服务器IP:8080

默认登录账号：admin，默认密码：Admin@2024，第一次登录必须立即修改默认密码，否则无法正常使用系统。

基础配置实操

1. 档案分类模板设置

登录后进入【档案管理-分类设置】，点击“新增分类”，示例配置：

• 分类名称：刑事一审档案
• 关联字段：卷宗编号、被告人姓名、立案日期、判决日期、案卷页数
• 可编辑属性：勾选“允许修改字段”“允许批量导入”

2. 用户权限配置

进入【系统设置-用户管理】，点击“新增用户”：

• 操作员角色：分配“档案录入”“档案查询”“档案导出”权限
• 管理员角色：仅分配给系统维护人员，拥有全权限

常见问题排查

• 端口占用无法启动：修改docker-compose.yml中web服务的端口映射，例如改为9090:8080，重新执行docker-compose up -d
• 数据库连接失败：检查web服务的DB_PASS值是否与db服务的MYSQL_PASSWORD一致，重启服务后重试
• 无法上传档案文件：执行命令创建并赋予上传目录权限：docker exec -it web容器名 mkdir -p /app/uploads && docker exec -it web容器名 chmod 777 /app/uploads
• 初始化脚本执行失败：删除旧数据卷后重新部署：docker-compose down -v && docker-compose up -d