基于开源技术栈的轻量化档案云平台搭建实操全流程案例指南

一、前置环境准备

1.1 硬件要求

最低配置即可跑通全功能，生产环境可根据档案量级扩容：

• CPU：2核及以上，生产推荐4核8G
• 存储：≥100G固态硬盘，生产建议挂载对象存储
• 带宽：≥5M，公网访问建议升级到10M以上
• 系统：CentOS7.9 / Ubuntu22.04 无桌面版

1.2 依赖安装

全程采用容器化部署，无需手动编译依赖，执行以下命令安装Docker和Docker Compose：

CentOS系统执行：

``` 卸载旧版Docker sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine 安装依赖 sudo yum install -y yum-utils sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo sudo yum install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin 启动并设置开机自启 sudo systemctl start docker && sudo systemctl enable docker ```

Ubuntu系统执行：

``` 卸载旧版Docker sudo apt-get remove docker docker-engine docker.io containerd runc 安装依赖 sudo apt-get update sudo apt-get install -y ca-certificates curl gnupg lsb-release sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt-get update sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin 启动并设置开机自启 sudo systemctl start docker && sudo systemctl enable docker ```

安装完成后执行docker -v和docker compose version，返回版本号即为安装成功。

二、核心服务部署

本次采用开源档案管理系统Mayan EDMS作为核心服务，支持OCR识别、权限管控、日志审计等全量档案管理功能，完整部署配置可直接复制使用。

2.1 创建挂载目录

执行以下命令创建数据持久化目录，避免容器重启后数据丢失：

``` sudo mkdir -p /opt/mayan/{db,redis,app,backup} sudo chmod -R 777 /opt/mayan ```

2.2 编写部署配置

在/opt/mayan目录下创建docker-compose.yml文件，内容如下，注意替换配置中的数据库密码为自定义密码：

```yaml version: '3.9' services: db: image: postgres:14-alpine container_name: mayan-db environment: - POSTGRES_USER=mayan - POSTGRES_PASSWORD=自定义数据库密码 - POSTGRES_DB=mayan volumes: - /opt/mayan/db:/var/lib/postgresql/data restart: unless-stopped healthcheck: test: ["CMD-SHELL", "pg_isready -U mayan"] interval: 10s timeout: 5s retries: 5 redis: image: redis:7-alpine container_name: mayan-redis restart: unless-stopped volumes: - /opt/mayan/redis:/data mayan-edms: image: mayanedms/mayanedms:4.4 container_name: mayan-app ports: - "80:8000" environment: - MAYAN_DATABASE_HOST=db - MAYAN_DATABASE_NAME=mayan - MAYAN_DATABASE_USER=mayan - MAYAN_DATABASE_PASSWORD=和上面一致的自定义数据库密码 - MAYAN_REDIS_HOST=redis - MAYAN_TIME_ZONE=Asia/Shanghai volumes: - /opt/mayan/app:/var/lib/mayan restart: unless-stopped depends_on: db: condition: service_healthy redis: condition: service_started ```

2.3 启动服务

执行以下命令启动服务，首次启动需要初始化数据库，耗时5-10分钟：

``` cd /opt/mayan && sudo docker compose up -d ```

执行sudo docker compose logs -f mayan-app查看日志，出现“Listening at: http://0.0.0.0:8000”即为启动成功，访问服务器公网IP即可进入平台登录页。

三、初始配置实操

3.1 管理员账号配置

默认登录账号为admin，默认密码为admin，登录后第一时间修改密码，路径：右上角用户头像→账户设置→更改密码，输入新密码后保存即可。

3.2 档案分类配置

根据业务需求创建档案分类，路径：左侧菜单→管理→文档类型，点击“创建”，可分别设置人事档案、合同档案、项目档案等分类，同时可在“元数据类型”中创建对应字段（如人事档案的姓名、部门、入职时间），绑定到对应文档类型即可实现档案信息结构化存储。

3.3 权限体系配置

路径：左侧菜单→管理→角色，可创建多类角色：

• 超级管理员：拥有全平台权限
• 档案管理员：拥有档案上传、编辑、删除、归档权限
• 普通员工：仅拥有所属部门档案的查看权限

创建用户后绑定对应角色即可完成权限分配。

四、核心功能实操

• 档案上传归档：左侧菜单→文档→上传，支持单文件、批量ZIP包上传，系统自动完成OCR文字识别、缩略图生成，可配置工作流规则实现自动分类、自动打标签。
• 档案检索：顶部搜索框支持全文检索、元数据检索、标签检索，支持模糊匹配，响应时间≤1秒。
• 档案导出：选中目标档案，点击批量操作→导出，支持导出原文件、PDF格式，普通角色默认无导出权限，需管理员在角色配置中开启。
• 日志审计：路径：管理→事件日志，所有用户的登录、上传、下载、修改、删除操作均有完整记录，支持按时间、用户、操作类型筛选，满足合规要求。

五、生产环境优化（可选）

5.1 存储扩容

档案量级较大时可挂载对象存储，以阿里云OSS为例，安装ossfs后执行以下命令挂载：

``` 安装ossfs sudo yum install -y ossfs 配置密钥 echo 你的OSS_AccessKey:你的OSS_SecretKey > /etc/passwd-ossfs chmod 640 /etc/passwd-ossfs 挂载 ossfs 你的OSS桶名 /opt/mayan -ourl=oss-cn-beijing.aliyuncs.com -o allow_other ```

5.2 自动备份

创建/opt/mayan/backup.sh脚本，内容如下：

```bash !/bin/bash DATE=$(date +%Y%m%d%H%M) docker exec mayan-db pg_dump -U mayan mayan > /opt/mayan/backup/mayan_backup_$DATE.sql 保留最近7天备份 find /opt/mayan/backup -mtime +7 -name ".sql" -delete ```

执行chmod +x /opt/mayan/backup.sh，然后执行crontab -e添加定时任务：0 1 /opt/mayan/backup.sh，即可实现每日凌晨1点自动备份。

六、常见问题排查

• 访问页面失败：检查防火墙是否开放80端口，CentOS执行sudo firewall-cmd --add-port=80/tcp --permanent && sudo firewall-cmd --reload，Ubuntu执行sudo ufw allow 80/tcp。
• 启动失败：查看日志提示权限不足时，重新执行sudo chmod -R 777 /opt/mayan即可。
• 中文OCR识别不准确：进入容器执行sudo docker exec -it mayan-app apt update && apt install -y tesseract-ocr-chi-sim，重启容器即可。