吴忠档案管理软件基于Docker快速部署实操

环境准备与基础依赖安装

在开始部署吴忠档案管理软件之前，我们需要准备一台干净的服务器环境。本指南基于CentOS 7.9或Ubuntu 20.04+系统编写，使用Docker容器化技术进行部署，以确保环境的一致性和迁移的便捷性。核心选型采用开源的Mayan EDMS作为底层引擎，它支持OCR识别、文档版本控制及详细的元数据管理，完全符合档案管理的硬性需求。

执行以下命令更新系统内核并安装必要的工具：

```bash CentOS系统执行 yum update -y yum install -y yum-utils device-mapper-persistent-data lvm2 curl Ubuntu系统执行 apt-get update -y apt-get install -y curl gnupg2 apt-transport-https lsb-release ca-certificates ```

接下来，安装Docker及Docker Compose。为了确保版本兼容，建议安装较新的稳定版：

```bash 安装Docker curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun 启动Docker服务并设置开机自启 systemctl start docker systemctl enable docker 安装Docker Compose (如果未自带) curl -L "https://github.com/docker/compose/releases/download/v2.20.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose chmod +x /usr/local/bin/docker-compose 验证安装 docker --version docker-compose --version ```

目录规划与配置文件编写

为了避免数据丢失，我们需要将容器内的数据映射到宿主机。请在服务器根目录下创建专门的部署目录：

```bash mkdir -p /opt/wuzhong_archive/{data,media,db,redis} cd /opt/wuzhong_archive ```

在该目录下创建docker-compose.yml文件。这是整个部署的核心配置文件，定义了数据库、缓存及主应用的运行参数。请直接复制以下完整内容，不要遗漏任何缩进或配置项：

```yaml version: '3.8' services: PostgreSQL 数据库服务 mayan-edms-db: image: postgres:13 volumes: - ./db:/var/lib/postgresql/data environment: - POSTGRES_USER=mayanuser - POSTGRES_PASSWORD=mayandbpass123 - POSTGRES_DB=mayandb restart: always Redis 缓存服务 mayan-edms-redis: image: redis:6.2 volumes: - ./redis:/data restart: always Mayan EDMS 主程序服务 mayan-edms: image: mayanedms/mayanedms:latest ports: - "80:80" depends_on: - mayan-edms-db - mayan-edms-redis volumes: - ./media:/var/lib/mayan/media environment: 基础配置 - MAYAN_DATABASE_ENGINE=django.db.backends.postgresql - MAYAN_DATABASE_NAME=mayandb - MAYAN_DATABASE_USER=mayanuser - MAYAN_DATABASE_PASSWORD=mayandbpass123 - MAYAN_DATABASE_HOST=mayan-edms-db - MAYAN_DATABASE_PORT=5432 Redis配置 - MAYAN_CELERY_BROKER_URL=redis://mayan-edms-redis:6379/0 - MAYAN_CELERY_RESULT_BACKEND=redis://mayan-edms-redis:6379/1 初始化配置（首次启动必须） - MAYAN_INITIAL_ADMIN_EMAIL=admin@wuzhong.local - MAYAN_INITIAL_ADMIN_PASSWORD=wuzhong_admin_123 - MAYAN_INITIAL_ADMIN_USERNAME=wuzhong_admin OCR与语言包配置（支持中文识别） - MAYAN_AI_INSTALLED_PACKAGES=tesseract-ocr,tesseract-ocr-chi-sim - MAYAN_OCR_AUTO_OCR=True restart: always ```

配置说明：上述配置中，我们将服务器的80端口映射给容器，这意味着部署完成后直接通过浏览器输入服务器IP即可访问。初始管理员账号已预设为wuzhong_admin，密码为wuzhong_admin_123。同时，我们集成了中文OCR包，这对于吴忠档案管理中的中文纸质件数字化至关重要。

容器启动与初始化验证

配置文件保存完毕后，执行以下命令拉取镜像并启动所有服务：

```bash cd /opt/wuzhong_archive docker-compose up -d ```

首次启动需要下载镜像，大小约为1GB左右，请耐心等待。可以使用以下命令实时查看日志，确认服务是否正常启动：

```bash docker-compose logs -f mayan-edms ```

当日志中出现类似“Starting Mayan EDMS”或“Booting worker with pid”字样时，说明启动成功。按Ctrl+C退出日志查看模式。

为了确保服务彻底就绪，等待约30秒后，检查容器状态：

```bash docker-compose ps ```

所有服务的Status列必须显示为Up。如果出现Exit或不断重启，请使用docker-compose logs排查报错信息，通常是因为数据库连接超时或端口被占用。

系统初始化与基础设置

服务启动成功后，打开浏览器，访问http://服务器IP地址。使用配置文件中预设的账号登录：

• 用户名：wuzhong_admin
• 密码：wuzhong_admin_123

登录成功后，首先需要进行系统基础设置以符合档案管理规范。

1. 创建文档类型

在顶部导航栏点击设置 -> 文档类型 -> 创建。输入名称，例如“吴忠市行政档案”，点击保存。这一步将作为后续档案分类的顶层容器。

2. 配置元数据

档案管理核心在于元数据的检索。点击刚才创建的“吴忠市行政档案”，进入元数据类型选项卡。

• 点击添加，选择类型为标签，名称设为“密级”，用于标记“公开/内部/机密”。
• 再次点击添加，选择类型为文本，名称设为“归档年度”。
• 再次点击添加，选择类型为选择，名称设为“保管期限”，并在选项中定义“永久/30年/10年”。

配置完成后，记得点击右上角的保存按钮使元数据生效。

3. 设置智能标签

为了实现自动化归档，我们可以设置简单的智能标签。在设置 -> 标签中，创建一个名为“吴忠本地文件”的标签。在规则设置中，可以定义“当文件名包含‘吴忠’时自动添加此标签”。这样上传文件时系统会自动打标，减少人工操作成本。

日常操作与OCR识别实战

现在开始模拟一份档案的入库流程。

1. 上传档案

在首页左侧导航栏选择文档，点击右上角的新建文档按钮。在弹出的对话框中，选择之前创建的“吴忠市行政档案”类型，点击下一步。

点击选择文件，上传一份本地的PDF或图片文件（支持多页PDF）。上传进度条走完后，点击完成。

2. 验证OCR识别

点击刚上传的文档进入详情页。系统会自动触发后台OCR任务（因为我们在环境变量中开启了MAYAN_OCR_AUTO_OCR=True）。在页面右侧可以看到“内容”面板，稍等片刻，刷新页面，中文内容将直接显示在面板中。你可以直接在页面搜索这些文字，实现了从“图像”到“数据”的转化。

3. 填写元数据

在文档详情页，向下滚动到元数据区域。根据我们之前的定义，手动选择“保管期限”为“永久”，输入“归档年度”为“2023”。这些信息将作为检索索引。

4. 版本控制

如果档案需要更新，不要直接删除。点击右上角的新版本，上传修改后的文件。Mayan EDMS会保留历史版本，你可以随时回滚到任意旧版本，这是档案管理系统区别于普通网盘的核心功能。

数据备份与灾难恢复

对于吴忠档案管理软件，数据安全是底线。我们需要定期备份数据库和文件存储。

创建一个备份脚本backup.sh并赋予执行权限：

```bash vi /opt/wuzhong_archive/backup.sh ```

输入以下内容：

```bash !/bin/bash DATE=$(date +%Y%m%d_%H%M%S) BACKUP_DIR=/opt/wuzhong_archive/backups mkdir -p $BACKUP_DIR 备份数据库 docker exec wuzhong_archive_mayan-edms-db_1 pg_dump -U mayanuser mayandb > $BACKUP_DIR/mayan_db_$DATE.sql 备份媒体文件 tar -czvf $BACKUP_DIR/mayan_media_$DATE.tar.gz /opt/wuzhong_archive/media 删除7天前的备份 find $BACKUP_DIR -name ".sql" -mtime +7 -exec rm {} \; find $BACKUP_DIR -name ".tar.gz" -mtime +7 -exec rm {} \; ```

注意：脚本中的容器名称wuzhong_archive_mayan-edms-db_1可能根据实际docker-compose生成的名称略有不同，请使用docker ps确认真实名称。

设置定时任务，每天凌晨2点执行备份：

```bash chmod +x /opt/wuzhong_archive/backup.sh crontab -e 添加以下行 0 2 /opt/wuzhong_archive/backup.sh ```

恢复数据时，只需先停止容器，导入SQL文件，并解压media文件夹覆盖原目录，最后重启容器即可。整个过程无需重新安装软件，确保了业务的连续性。