从零搭建轻量开源档案管理B/S版并实现基础利用操作

一、前置环境准备

本次使用的轻量开源B/S档案管理工具为Mayan EDMS 精简社区版，仅需Docker即可快速部署，适配Windows、macOS、Linux全平台。

1. 安装Docker与Docker Compose

• Windows/macOS：直接访问Docker官网下载Docker Desktop（地址：https://www.docker.com/products/docker-desktop/），安装后启动并确保右下角/顶部状态栏有Docker图标且显示“Running”。
• Linux（以Ubuntu 22.04为例）：依次执行以下命令安装： ```bash 更新apt源 sudo apt update 安装依赖 sudo apt install -y apt-transport-https ca-certificates curl software-properties-common 添加Docker官方GPG密钥 curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg 添加Docker稳定版仓库 echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null 再次更新apt源并安装 sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin 启动Docker并设置开机自启 sudo systemctl start docker sudo systemctl enable docker ```

二、快速部署Mayan EDMS精简B/S版

部署步骤仅需创建配置文件+启动容器，5分钟内完成。

1. 创建部署目录与配置文件

• Windows/macOS：在桌面新建文件夹命名为mayan-edms，进入后新建文本文档，重命名为docker-compose.yml（注意必须去掉.txt后缀）。
• Linux：执行以下命令： ```bash 在家目录下创建部署目录 mkdir -p ~/mayan-edms cd ~/mayan-edms 创建并编辑配置文件 nano docker-compose.yml ```

将以下完整、可直接复制的配置粘贴到文件中： ```yaml version: '3.8' services: mayan-edms: image: mayanedms/mayanedms:4.4.9-slim container_name: mayan-edms ports: - "8000:8000" environment: - MAYAN_CELERY_BROKER_URL=redis://redis:6379/0 - MAYAN_CELERY_RESULT_BACKEND=redis://redis:6379/0 - MAYAN_DATABASES=default:ENGINE=django.db.backends.postgresql,NAME=mayan,USER=mayan,PASSWORD=mayan123,HOST=db,PORT=5432 - MAYAN_SECRET_KEY=your-own-random-secret-key-at-least-50-chars-long-change-this! - MAYAN_INSTALLATION_COMMON=true depends_on: - db - redis volumes: - mayan_data:/var/lib/mayan restart: unless-stopped db: image: postgres:14-alpine container_name: mayan-db environment: - POSTGRES_DB=mayan - POSTGRES_USER=mayan - POSTGRES_PASSWORD=mayan123 volumes: - postgres_data:/var/lib/postgresql/data restart: unless-stopped redis: image: redis:7-alpine container_name: mayan-redis volumes: - redis_data:/data restart: unless-stopped volumes: mayan_data: postgres_data: redis_data: ```

配置修改提示：仅需将MAYAN_SECRET_KEY替换为至少50位的随机字符串（可使用在线随机密钥生成工具：https://www.random.org/strings/?num=1&len=60&digits=on&upperalpha=on&loweralpha=on&unique=on&format=html&rnd=new），其他参数可按需调整（默认密码生产环境必须修改，演示可保留）。

保存配置文件：Windows/macOS直接Ctrl/Cmd+S；Linux按Ctrl+O回车确认，再按Ctrl+X退出。

2. 启动容器

• Windows/macOS：在mayan-edms文件夹空白处右键，选择“在终端打开”（Windows 11/macOS Ventura及以上）或“在Windows PowerShell中打开”（Windows 10），执行： ```bash docker compose up -d ```
• Linux：在刚才的部署目录下执行： ```bash sudo docker compose up -d ```

启动等待：首次启动需下载约300MB镜像并初始化数据库，约3-10分钟，可通过docker logs -f mayan-edms查看进度，出现Starting development server at http://0.0.0.0:8000/或类似日志表示启动成功。

三、B/S版基础利用操作

启动成功后，访问http://本机IP:8000（本机可访问http://localhost:8000），默认登录账号为admin，密码为admin，首次登录需强制修改密码。

1. 创建档案分类（必要前提）

档案分类用于组织文件，类似文件夹树，操作步骤：

1. 登录后点击左侧导航栏的「归档」→「分类」；
2. 点击右上角的「创建」按钮；
3. 输入分类名称（如「2024年度合同」「员工人事档案」），填写可选的描述，点击「保存」；
4. 如需创建子分类，点击父分类右侧的「子分类」→「创建」即可。

2. 批量上传档案

支持单文件、多文件、压缩包（zip/rar/tar.gz）批量上传，操作步骤：

1. 点击左侧导航栏的「文档」→「上传」；
2. 选择目标分类（必须选择，否则无法归档）；
3. 点击「选择文件」或拖拽文件到上传区域；
4. 若上传压缩包，勾选「解压并作为单独文档处理」；
5. 点击「开始上传」，上传完成后自动跳转到已上传文档列表。

3. 档案全文检索（核心利用功能）

Mayan EDMS支持PDF、Word、Excel、TXT等100+格式的全文检索，操作步骤：

1. 点击左侧导航栏顶部的搜索框；
2. 输入关键词（如「劳动合同」「员工张三」）；
3. 点击搜索图标，或直接回车；
4. 搜索结果可通过「筛选条件」（分类、上传时间、文件类型、权限等）进一步缩小范围。

全文检索开启提示：首次上传的非图片类文档，Mayan EDMS会后台自动解析（耗时取决于文档大小与数量），解析完成后才能检索到内容。可通过左侧导航栏「系统」→「任务队列」查看解析进度。

4. 档案借阅与权限控制

演示基础权限配置，操作步骤：

1. 点击左侧导航栏的「用户管理」→「用户」，点击右上角「创建」，输入用户名、密码、邮箱，点击「保存」；
2. 点击左侧导航栏的「用户管理」→「角色」，点击右上角「创建」，输入角色名称（如「档案借阅员」），点击「保存」；
3. 点击新建角色右侧的「权限」，勾选「文档」相关权限（如「查看文档」「搜索文档」「下载文档」），点击「保存」；
4. 点击左侧导航栏的「用户管理」→「用户」，点击新建用户右侧的「角色」，勾选「档案借阅员」，点击「保存」；
5. 点击左侧导航栏的「归档」→「分类」，点击目标分类右侧的「权限」，选择「档案借阅员」角色，勾选对应的权限（如「查看分类内文档」），点击「保存」；
6. 用新建用户登录，只能看到被授权分类的档案，只能执行被授权的操作。

5. 档案下载与导出

操作步骤：

1. 在文档列表或搜索结果中，点击目标文档右侧的「下载」图标，可直接下载单文件；
2. 如需批量下载，勾选目标文档左侧的复选框，点击顶部的「操作」→「下载所选」即可；
3. 如需导出档案元数据（文件名、分类、上传时间、关键词等），点击顶部的「操作」→「导出所选为CSV」。

四、常见问题快速解决

• 无法访问B/S界面：检查防火墙是否开放8000端口，或本机IP是否正确；
• 全文检索无结果：检查任务队列是否完成解析，或确认文档格式是否支持；
• 容器启动失败：检查docker-compose.yml文件格式是否正确（注意缩进必须用2个空格，不能用Tab），或查看日志docker logs -f mayan-edms排查。