从零搭建轻量级开源档案管理系统，三十分钟零基础可直接上手使用

一、前置准备：2个核心操作环境快速配置

1.1 安装Docker Desktop（Windows/Mac通用版）

本次教程使用Docker容器化部署，无需手动配置复杂的数据库、Web服务器，直接用已封装好的Mayan EDMS镜像——这是目前最易用、功能覆盖全个人/小团队的轻量级开源档案管理系统。

• Windows用户：下载地址 https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe；Mac Intel芯片：https://desktop.docker.com/mac/main/amd64/Docker.dmg；Mac M系列：https://desktop.docker.com/mac/main/arm64/Docker.dmg
• 安装后重启电脑，打开Docker Desktop，等待左下角Docker图标变成绿色RUNNING状态即成功

1.2 准备Docker Compose配置文件

这是容器编排的核心文件，定义了系统所有组件的关系、端口映射、数据持久化（防止重启丢失档案）。

• 在电脑D盘（或其他非系统盘，避免重装丢失）新建文件夹，命名为mayan-edms-local
• 在文件夹内右键新建文本文档，命名为docker-compose.yml（注意后缀名必须是.yml，Windows需开启“文件扩展名显示”：资源管理器顶部「查看」→ 勾选「文件扩展名」）
• 用记事本或VS Code打开该文件，完整复制粘贴以下内容，不要修改缩进（YAML对缩进要求严格，必须用2个空格）：

```yaml version: '3.8' services: db: image: postgres:15-alpine environment: POSTGRES_DB: mayan POSTGRES_PASSWORD: mayanuser123! POSTGRES_USER: mayan volumes: - postgres_data:/var/lib/postgresql/data/ restart: always redis: image: redis:7-alpine restart: always volumes: - redis_data:/data mayan-edms: image: mayanedms/mayanedms:4.7 environment: MAYAN_DATABASE_ENGINE: django.db.backends.postgresql MAYAN_DATABASE_HOST: db MAYAN_DATABASE_NAME: mayan MAYAN_DATABASE_PASSWORD: mayanuser123! MAYAN_DATABASE_USER: mayan MAYAN_REDIS_HOST: redis volumes: - mayan_data:/var/lib/mayan ports: - "8000:8000" depends_on: - db - redis restart: always volumes: postgres_data: redis_data: mayan_data: ```

二、系统部署：只需1条命令即可启动

2.1 打开命令行工具进入部署文件夹

• Windows用户：按下Win+R键，输入cmd回车，在命令行中输入d:回车切换到D盘，再输入cd mayan-edms-local回车进入文件夹
• Mac用户：按下Command+Space键，搜索「终端」打开，在终端中输入cd ~/Desktop/mayan-edms-local（如果文件夹在桌面）或cd /Volumes/你的非系统盘名/mayan-edms-local回车进入

2.2 执行部署命令

在进入部署文件夹的命令行工具中，输入以下命令并回车，首次执行需要5-10分钟下载镜像，等待期间不要关闭命令行：

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

执行成功后会出现绿色的Starting db ... doneStarting redis ... doneStarting mayan-edms ... done字样，Docker Desktop的Containers/Apps页面也会显示3个绿色的Running容器。

三、首次登录与基础配置：5分钟快速上手

3.1 登录系统

打开任意浏览器（Chrome/Edge/Firefox均可），在地址栏输入http://localhost:8000回车，进入登录页面：

• 默认用户名：admin
• 默认密码：admin
• 首次登录必须强制修改密码，设置一个包含大小写字母、数字、符号的强密码并牢记

3.2 基础配置（必须完成，否则无法上传档案）

① 创建档案分类

系统默认没有分类，点击左侧导航栏「文档类型」→ 右上角「创建」按钮：

• 「标签」填「合同档案」（或你需要的分类名，如个人简历、发票凭证）
• 点击「保存」，重复操作可创建多个分类

② 配置OCR识别模块（自动提取图片/扫描件文字）

点击左侧导航栏「设置」→ 下拉找到「OCR」→ 点击「OCR设置」→ 勾选「启用OCR」和「启用自动OCR」→ 点击「保存」。

OCR默认支持中文（简体/繁体），无需额外配置语言包。

③ 添加文档来源（可选但推荐，方便批量导入）

如果想直接把电脑某个文件夹的文件自动同步到系统，点击左侧导航栏「文档来源」→ 右上角「创建」：

• 「标签」填「本地批量导入」
• 「来源类型」选「文件系统文件夹」
• 「文件夹路径」填/var/lib/mayan/watch_folder（这是容器内预设的同步路径，后续会讲如何映射到电脑本地）
• 点击「保存」

四、核心功能实操：上传、检索、管理档案

4.1 单份档案上传

点击左侧导航栏「文档」→ 右上角「上传文档」按钮：

• 点击「选择文件」选中电脑上的PDF/图片/Word文档
• 「文档类型」选之前创建的分类
• 可添加标签（如「2024年」「技术」）方便后续检索
• 点击「上传」，上传成功后自动进入文档详情页，等待10-30秒（OCR识别时间，取决于文件大小）即可看到自动提取的文字内容

4.2 批量档案同步（如果完成了「添加文档来源」的配置）

需要修改docker-compose.yml文件，添加电脑本地同步文件夹的映射：

• 关闭Docker Desktop的所有容器（在Containers/Apps页面点击mayan-edms-local右侧的停止按钮）
• 打开之前的docker-compose.yml文件，在mayan-edms服务的volumes下添加一行（缩进2个空格，注意冒号后有一个空格）：

```yaml - d:/mayan-local-watch:/var/lib/mayan/watch_folder Windows用户，d:/mayan-local-watch换成你自己的本地文件夹路径（必须先在电脑上创建这个文件夹） 或者Mac用户： - /Users/你的用户名/Desktop/mayan-local-watch:/var/lib/mayan/watch_folder ```

• 保存文件后，在命令行工具中重新执行部署命令docker-compose up -d
• 现在只需把要上传的文件放到电脑本地的同步文件夹，系统会每30秒自动扫描并上传归档

4.3 高级检索

点击左侧导航栏「文档」→ 顶部搜索框输入关键词：

• 支持关键词检索（自动匹配标题、标签、OCR提取的文字）
• 支持精确筛选：点击搜索框右侧的「高级搜索」，可按文档类型、创建时间、标签、OCR状态等条件组合筛选

4.4 档案管理（编辑、删除、导出）

在文档详情页或文档列表页：

• 点击「编辑」可修改标题、标签、文档类型
• 点击「操作」→ 「下载」可导出原始文档；「删除」可删除文档（删除后需手动清空回收站，在左侧导航栏「文档」→ 「回收站」）
• 点击文档预览区域下方的「编辑OCR」可手动修改自动提取的错误文字

五、日常维护与备份

5.1 停止/启动系统

• 停止：在部署文件夹的命令行工具中输入docker-compose stop回车
• 启动：输入docker-compose start回车

5.2 数据备份（重要，防止系统故障丢失档案）

数据全部存储在Docker卷中，执行以下命令备份所有卷（Windows用户需先确保Docker Desktop在运行）：

```bash 备份到当前目录的mayan_backup.tar文件 docker run --rm -v mayan-edms-local_postgres_data:/data/postgres -v mayan-edms-local_redis_data:/data/redis -v mayan-edms-local_mayan_data:/data/mayan -v $(pwd):/backup alpine tar czf /backup/mayan_backup_$(date +%Y%m%d).tar.gz /data ```

Windows CMD中需把$(pwd)换成%cd%，备份文件会自动加上当前日期。