轻量级开源电子档案系统Mayan EDMS本地全流程落地实操

一、前置环境准备

1.1 硬件/系统要求

使用普通Windows/macOS/Linux电脑即可（建议CPU双核以上、内存4GB以上，系统盘预留10GB）；本教程以Windows10/11为例，macOS/Linux仅需替换部分Python/MySQL操作命令。

1.2 基础软件安装（按顺序来，别跳）

所有软件均选择64位稳定版：

• Python 3.10.x：下载地址https://www.python.org/downloads/release/python-31013/，安装时务必勾选Add Python 3.10 to PATH。
• MySQL 8.0.x：下载社区版安装包https://dev.mysql.com/downloads/mysql/，安装时设置root密码（记住！）、创建名为mayan的字符集为utf8mb4的空数据库（无需建表）。
• 虚拟环境工具venv：Python3.3+自带，无需额外安装。

二、Mayan EDMS核心安装

2.1 创建并激活虚拟环境

在D盘根目录新建文件夹mayan_edms_local，打开命令提示符（管理员权限），依次执行以下命令：

• d:
• cd mayan_edms_local
• python -m venv venv（创建名为venv的虚拟环境）
• venv\Scripts\activate（激活虚拟环境，激活后命令前缀会显示(venv)）

2.2 安装Mayan EDMS及依赖

保持虚拟环境激活状态，执行命令：

• pip install mayan-edms==4.4.15（指定稳定4.4.15版本，避免兼容性问题）
• pip install mysql-connector-python==8.0.33（MySQL数据库驱动）

三、Mayan EDMS配置文件修改

3.1 生成初始配置

虚拟环境激活下执行：mayan-edms.py initialsetup，会在venv\Lib\site-packages\mayan\settings下生成相关配置，同时提示首次创建管理员账号密码（按提示输入即可，记住！）。

3.2 修改数据库配置

找到文件venv\Lib\site-packages\mayan\settings\local.py，用记事本/VS Code打开，删除全部内容，粘贴以下完整配置（需修改两处：YOUR_MYSQL_ROOT_PASSWORD替换为MySQL的root密码，D:\mayan_edms_local\storage为你存放档案文件的目录，可自定义）：

```python from .base import 导入基础配置 数据库配置 DATABASES = { 'default': { 'ENGINE': 'mysql.connector.django', 'NAME': 'mayan', 'USER': 'root', 'PASSWORD': 'YOUR_MYSQL_ROOT_PASSWORD', 'HOST': '127.0.0.1', 'PORT': '3306', 'OPTIONS': { 'charset': 'utf8mb4', 'autocommit': True, 'init_command': "SET sql_mode='STRICT_TRANS_TABLES'", }, } } 档案文件存储路径配置 MEDIA_ROOT = 'D:\\mayan_edms_local\\storage' ```

保存后，在mayan_edms_local文件夹下手动创建名为storage的空文件夹。

3.3 执行数据库迁移（生成表结构）

虚拟环境激活下依次执行：

• mayan-edms.py makemigrations（检查并生成迁移文件）
• mayan-edms.py migrate（执行迁移，创建所有表）

四、Mayan EDMS启动与登录

4.1 启动开发服务器

虚拟环境激活下执行：mayan-edms.py runserver 0.0.0.0:8000（0.0.0.0表示局域网内其他设备也能访问，仅本地访问可改成127.0.0.1）。

注意：启动过程中不要关闭命令提示符窗口，关闭即停止服务。

4.2 首次登录与管理员设置

打开任意浏览器（建议Chrome/Edge），访问地址http://127.0.0.1:8000（局域网内其他设备访问可替换成你的电脑IP），用3.1步骤创建的管理员账号密码登录。

登录后点击右上角用户名→个人资料→修改密码，重新设置更安全的密码。

五、基础档案管理流程配置（零代码，纯界面操作）

5.1 创建档案分类

点击左侧菜单档案管理→分类→新建，填写分类名称（如“人事档案”“合同档案”）、父级分类（可选），点击保存，重复操作创建所需的所有分类。

5.2 创建档案元数据模板（定义档案必填/选填项）

点击左侧菜单系统设置→数据结构→元数据类型→新建：

• 输入元数据类型名称（如“合同编号”“员工姓名”）
• 选择输入类型（如“文本”“日期”“下拉菜单”）
• 勾选必填项（可选）
• 点击保存

点击左侧菜单系统设置→数据结构→元数据模板→新建：

• 输入模板名称（如“人事档案模板”“采购合同模板”）
• 点击元数据类型右侧的添加，选择刚才创建的元数据类型并设置顺序
• 点击保存

5.3 创建文档类型并绑定分类、元数据模板

点击左侧菜单档案管理→文档类型→新建：

• 输入文档类型名称（如“劳动合同”“离职证明”）
• 点击默认分类右侧的添加，选择对应的分类
• 点击元数据模板右侧的添加，选择对应的模板
• 点击保存

六、日常档案操作（直接上手用）

6.1 上传档案

点击左侧菜单档案管理→上传：

• 选择文档类型
• 点击选择文件（支持批量上传PDF、Word、图片等主流格式）
• 填写元数据（必填项必须填）
• 点击上传

6.2 检索与查看档案

点击左侧菜单档案管理→文档：

• 通过分类筛选、文档类型筛选、搜索框（支持模糊搜索元数据、文件名、文档内容（PDF/Word/OCR图片需提前配置OCR，后续可看官方文档））快速找到档案
• 点击档案标题可查看详情，点击下载可保存到本地，点击预览可在线查看（支持PDF/图片直接预览）

6.3 整理档案

在文档详情页或列表页：

• 可修改分类、修改元数据
• 可删除档案（删除前会提示确认）

七、后续优化建议（可选但实用）

• 配置OCR识别：安装Tesseract OCR并在Mayan EDMS中配置路径，可识别图片/PDF中的文字并支持全文检索。
• 配置自动备份：使用Windows任务计划程序/ Linux crontab定时备份MySQL数据库和storage文件夹。
• 使用生产级服务器：如果要多人长期使用，建议换成Nginx+Gunicorn部署，稳定性更高。