档案数字化系统本地从零部署全流程实操技术指南

一、前置环境准备

本文基于Ubuntu 22.04系统部署，零代码环境配置，仅需Docker即可完成，所有命令可直接复制执行。

1. 安装Docker及依赖工具

执行以下命令一键安装Docker和Docker Compose：

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

添加当前用户到Docker用户组，避免每次操作需输入sudo，执行：

``` sudo usermod -aG docker $USER && newgrp docker ```

验证安装结果，执行docker --version，输出版本号（如24.0.6）即安装成功。

二、部署档案数字化核心系统

本次选用开源合规的Mayan EDMS档案数字化系统，官方镜像可直接拉取，无需额外编译。

1. 创建部署目录及配置文件

在用户目录创建专属部署文件夹：

``` mkdir -p ~/arch-digital && cd ~/arch-digital ```

创建docker-compose.yml配置文件，内容完整可直接复制（含数据库及系统核心服务配置）：

```yaml version: '3.8' services: mayan: image: mayanedms/mayanedms:4.10.0 container_name: arch-digital-core ports: - "8080:8000" environment: - MAYAN_DATABASE_ENGINE=django.db.backends.mysql - MAYAN_DATABASE_NAME=arch_digital - MAYAN_DATABASE_USER=root - MAYAN_DATABASE_PASSWORD=ArchDigital@2024 - MAYAN_DATABASE_HOST=db - MAYAN_BINARY_ROOT=/var/lib/mayan/media depends_on: - db volumes: - arch-media:/var/lib/mayan/media db: image: mysql:8.0 container_name: arch-digital-db environment: - MYSQL_ROOT_PASSWORD=ArchDigital@2024 - MYSQL_DATABASE=arch_digital volumes: - arch-db-data:/var/lib/mysql volumes: arch-media: arch-db-data: ```

2. 启动系统容器

执行启动命令，后台运行系统及数据库服务：

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

等待40秒后，执行docker ps，若显示arch-digital-core和arch-digital-db两个容器状态为Up，说明部署成功。

三、系统初始配置

1. 首次登录设置

打开浏览器输入http://localhost:8080，系统跳转初始化页面，必填操作：使用默认账号admin，密码Mayan@2024登录，首次登录强制修改为8位以上含大小写、数字、特殊字符的密码。

2. 数字化合规参数配置

登录后进入「系统设置」→「数字化管理」，按档案行业标准配置核心参数：

• 扫描分辨率：设置为300dpi（纸质档案数字化要求）
• 输出文件格式：选择PDF/A-1b（长期保存标准格式，规避格式损坏风险）
• 自动校正：开启「倾斜校正」「污渍清除」「页码自动排序」

配置完成后点击「保存配置」，等待10秒系统自动重启生效。

四、日常档案数字化实操步骤

1. 批量导入原始档案

将待数字化的纸质档案扫描为JPG/PNG格式，按「卷-件」层级建立文件夹（如：2024年度→001卷→1-200页），上传至服务器的~/arch-digital/import文件夹（可提前执行mkdir -p ~/arch-digital/import创建）。

2. 一键批量数字化

进入「档案管理」→「原始档案」，选中已上传的文件夹，点击「批量数字化转换」，系统自动完成以下操作：

• 将单页图片合并为单份PDF文件
• 执行OCR识别生成索引文本（可搜索）
• 存储至合规的PDF/A格式库

转换完成后，进入「数字化档案」模块，点击「预览」确认内容完整、格式合规，无误后标记为已归档。

五、常见问题快速排查

1. 端口占用导致无法启动：执行sudo lsof -i :8080，查看占用进程，杀死进程后修改docker-compose.yml中的端口映射（如改为8081:8000），执行docker-compose restart即可。

2. 数据库连接失败：核对docker-compose.yml中「MAYAN_DATABASE_PASSWORD」与db服务的「MYSQL_ROOT_PASSWORD」是否一致，不一致则修改配置文件后，执行docker-compose down && docker-compose up -d重启服务。

3. 页面无法访问：执行docker logs arch-digital-core，查看日志中是否有端口错误或数据库连接错误，按对应提示调整配置。