从0到1搭建适配中小微企业的档案管理软件完整实操案例

前期准备：环境与依赖安装

本案例采用开源成熟的电子档案管理系统，通过Docker容器化部署，零环境配置成本，支持Windows、macOS、Linux全平台，硬件要求仅需2核4G内存即可流畅运行。

第一步：安装Docker与Docker Compose

• Ubuntu/Debian系统直接执行以下命令完成安装： ``` sudo apt update && sudo apt install docker.io docker-compose -y sudo systemctl enable --now docker ```
• Windows系统直接下载安装包：https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe
• macOS Intel芯片直接下载：https://desktop.docker.com/mac/main/amd64/Docker.dmg
• macOS M系列芯片直接下载：https://desktop.docker.com/mac/main/arm64/Docker.dmg

安装完成后打开Docker，确认服务正常运行即可进入下一步。

一键部署服务，全配置可复制

第一步：创建部署目录并编写配置文件

本地或服务器执行以下命令创建部署文件夹： ``` mkdir mayan-archive && cd mayan-archive ```

在文件夹内新建文件docker-compose.yml，直接复制粘贴以下完整配置，无需修改即可使用： ```yaml version: '3.3' services: mayan: image: mayanedms/mayanedms:4.5 volumes: - mayan_media:/var/lib/mayan/media - mayan_static:/var/lib/mayan/static ports: - "8000:8000" depends_on: - postgres - redis environment: MAYAN_DATABASE_NAME: mayan MAYAN_DATABASE_USER: mayan MAYAN_DATABASE_PASSWORD: mayan123456 MAYAN_DATABASE_HOST: postgres MAYAN_REDIS_HOST: redis postgres: image: postgres:13-alpine environment: POSTGRES_DB: mayan POSTGRES_USER: mayan POSTGRES_PASSWORD: mayan123456 volumes: - postgres_data:/var/lib/postgresql/data redis: image: redis:6-alpine volumes: - redis_data:/data volumes: mayan_media: mayan_static: postgres_data: redis_data: ```

第二步：启动服务并初始化管理员

在当前目录执行以下命令启动服务，第一次启动需要3-5分钟拉取镜像初始化数据： ``` docker-compose up -d ```

服务启动后，执行以下命令创建管理员账号，按照提示输入用户名、邮箱、密码即可： ``` docker-compose exec mayan python manage.py createsuperuser ```

基础档案配置实操，按步骤完成即可用

部署完成后，打开浏览器访问http://你的IP:8000（本地部署访问http://localhost:8000），输入刚才创建的管理员账号登录，接下来完成基础配置：

1. 创建档案分类

• 点击左侧菜单栏分类 → 文档类型，点击右上角「创建」按钮
• 填写分类名称，例如「员工人事档案」「商务合同档案」「项目文档档案」，勾选允许自动命名，点击保存
• 重复操作，创建所有需要的档案分类即可

2. 配置档案访问权限

• 点击左侧菜单栏权限 → 角色，点击创建角色，常用角色为「普通员工」「部门经理」「档案管理员」
• 进入角色编辑页，点击「权限」标签，给对应角色分配权限：普通员工仅开放自身档案查看权限，部门经理开放本部门所有档案查看权限，档案管理员开放全部分类的编辑、删除权限
• 点击「成员」标签，添加对应用户账号到对应角色，保存配置即可

3. 上传归档档案

• 点击顶部菜单栏「上传」，支持单文件上传、批量压缩包上传，兼容PDF、Word、Excel、CAD、图片等几乎所有常用格式
• 上传完成后选择对应档案分类，填写标签、归档日期、责任人等元信息
• 点击确认提交，完成档案归档，归档后的档案会自动索引，支持快速检索

核心功能配置，满足常用需求

开启OCR全文检索

扫描版纸质档案需要支持内容检索，按以下步骤开启：

• 点击左侧菜单栏应用 → 已安装应用，找到「OCR」应用，点击启用
• 进入OCR设置页，选择中文语言包（默认已内置），勾选上传后自动OCR识别，保存配置
• 后续上传的档案会自动识别文字，支持全局搜索档案内任意关键词，识别准确率可达95%以上

开启档案版本管理

需要更新档案并保留历史版本，按以下配置：

• 点击左侧菜单栏设置 → 文档设置
• 找到「保留文档旧版本」选项，勾选开启，设置保留版本数量（建议设置为5个，平衡存储与需求）
• 保存后，更新档案时会自动保留旧版本，随时可以回滚查看历史内容

常见问题排查，避免卡壳

• 无法打开登录页：服务器部署需要检查防火墙是否开放8000端口，本地部署检查Docker服务是否正常启动
• 上传文件提示存储空间不足：执行docker system prune -f清理无用镜像，也可以修改docker-compose.yml的存储路径，映射到本地大硬盘分区
• OCR识别不准确：确认OCR设置中选择了正确的语言包，模糊扫描件会降低识别准确率，清晰扫描件可保证识别效果

按照以上步骤操作，10分钟即可完成可用的档案管理软件部署，所有配置开箱即用，满足中小微企业电子档案存储、检索、权限管理的核心需求。