阿拉尔企事业单位轻量开源档案管理软件部署实操指南

一、前期准备：选择适配阿拉尔本地常用格式的开源方案

本文选用Mayan EDMS轻量版，原因是它支持阿拉尔常用的维吾尔文/汉文双语PDF扫描件存储、分类编号规则自定义（可兼容本地企事业单位编号逻辑）、权限隔离，同时部署简单无需复杂服务器，家用电脑也能临时测试。

硬件/软件环境要求

• 硬件：Windows/macOS/Linux均可，测试环境用4GB内存、20GB以上剩余硬盘；生产环境建议至少8GB内存、2TB固态
• 软件：Docker Desktop（Windows/macOS）或Docker CE（Linux）

二、Docker环境快速安装（以Windows/macOS/常用乌班图Linux为例）

1. Windows 10/11 安装Docker Desktop

步骤1：开启Windows功能

同时按Win+R键，输入optionalfeatures回车，勾选Hyper-V、虚拟机平台、Windows Subsystem for Linux，点击确定后重启电脑。

步骤2：下载安装包

直接访问官网下载地址：https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe，双击安装，全程默认点击Next，完成后重启Docker Desktop。

2. macOS 安装Docker Desktop

直接访问官网下载对应芯片版本：Intel芯片https://desktop.docker.com/mac/main/amd64/Docker.dmg，Apple Silicon芯片https://desktop.docker.com/mac/main/arm64/Docker.dmg，拖拽安装即可。

3. 乌班图22.04 LTS 安装Docker CE

依次复制执行以下命令：

``` 更新apt源 sudo apt update 安装依赖 sudo apt install -y ca-certificates curl gnupg lsb-release 添加Docker官方GPG密钥 sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg 设置Docker稳定版仓库 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 再次更新apt源 sudo apt update 安装Docker CE、CLI、Containerd、Compose插件 sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin ```

三、Mayan EDMS轻量版一键部署

1. 创建配置目录

Windows在D盘（避免系统盘权限问题）创建D:\mayan文件夹，macOS/Linux在终端执行：

``` sudo mkdir -p /srv/mayan/{media,postgres,redis,config} sudo chmod -R 777 /srv/mayan ```

2. 编写docker-compose.yml配置文件

Windows打开记事本，粘贴以下完整内容，另存为D:\mayan\docker-compose.yml，macOS/Linux用vim/nano创建/srv/mayan/docker-compose.yml：

``` version: '3.7' services: postgres: image: docker.io/library/postgres:14-alpine container_name: mayan-postgres environment: POSTGRES_USER: mayan POSTGRES_PASSWORD: mayan_password123 POSTGRES_DB: mayan volumes: - ./postgres:/var/lib/postgresql/data restart: always redis: image: docker.io/library/redis:7-alpine container_name: mayan-redis volumes: - ./redis:/data restart: always mayan-edms: image: docker.io/mayanedms/mayanedms:4.4.22 container_name: mayan-edms depends_on: - postgres - redis environment: MAYAN_DATABASE_ENGINE: django.db.backends.postgresql MAYAN_DATABASE_HOST: postgres MAYAN_DATABASE_NAME: mayan MAYAN_DATABASE_PASSWORD: mayan_password123 MAYAN_DATABASE_USER: mayan MAYAN_CELERY_BROKER_URL: redis://redis:6379/0 MAYAN_CELERY_RESULT_BACKEND: redis://redis:6379/1 MAYAN_SECRET_KEY: mayan_secret_key_change_this_before_production MAYAN_TIME_ZONE: Asia/Shanghai MAYAN_LANGUAGE_CODE: zh-hans LANG: C.UTF-8 LC_ALL: C.UTF-8 ports: - "80:8000" volumes: - ./media:/var/lib/mayan - ./config:/etc/mayan restart: always ```

注意：生产环境必须修改MAYAN_SECRET_KEY和POSTGRES_PASSWORD！

3. 启动服务

Windows打开PowerShell（管理员身份），先切换目录：

``` cd D:\mayan ```

macOS/Linux打开终端，切换目录：

``` cd /srv/mayan ```

所有系统统一执行启动命令：

``` docker compose up -d ```

首次启动需等待10-15分钟（下载镜像、初始化数据库、加载模块），可执行以下命令查看日志确认启动成功：

``` docker compose logs -f mayan-edms ```

看到Starting development server at http://0.0.0.0:8000或类似启动成功提示，按Ctrl+C退出日志查看。

四、适配阿拉尔的配置与基础操作

1. 登录后台

打开浏览器，输入电脑的IP地址（Windows/macOS可在终端输入ipconfig/ifconfig查看）或http://localhost，首次登录账号密码均为admin，登录后立即修改密码。

2. 配置双语支持（开启维吾尔文显示）

步骤1：进入语言设置

点击右上角头像→Preferences→左侧菜单Language & Locale。

步骤2：添加维吾尔语

找到Available languages，勾选Uyghur，点击下方Save。

步骤3：切换界面语言

刷新页面，右上角头像下拉菜单即可切换中文或维吾尔语。

3. 自定义阿拉尔本地档案编号规则

假设本地编号规则为：全宗号（3位数字）-保管期限（永久/30年/10年）-年度（4位）-件号（4位）

步骤1：创建编号模板

点击左侧菜单Documents→Document Numbering Templates→右上角Create。

步骤2：填写模板内容

• Label：阿拉尔标准编号
• Template：{{ document.metadata_value_of.全宗号 }}-{{ document.metadata_value_of.保管期限 }}-{{ document.metadata_value_of.年度 }}-{{ counter,4,d,0 }}
• Counter reset period：选择Yearly（年度件号清零）
• 点击Save

4. 创建元数据类型（对应编号规则的字段）

步骤1：创建全宗号

点击左侧菜单Metadata→Metadata Types→右上角Create，Label填“全宗号”，Name填“quanzonghao”，Data type选Text，Validation pattern填^\d{3}$（限制3位数字），Validation error message填“请输入3位数字全宗号”，点击Save。

步骤2：创建保管期限

重复操作，Label填“保管期限”，Name填“baoguanqixian”，Data type选Select，Options每行填一个选项：永久、30年、10年，点击Save。

步骤3：创建年度

重复操作，Label填“年度”，Name填“niandu”，Data type选Text，Validation pattern填^(20|21)\d{2}$（限制2000-2199年），Validation error message填“请输入4位有效年度”，点击Save。

5. 创建文档类型并绑定编号、元数据

点击左侧菜单Documents→Document Types→右上角Create：

• Label：阿拉尔文书档案
• 勾选Metadata→右侧选择刚才创建的3个元数据，点击向右箭头添加
• 勾选Document Numbering→右侧选择“阿拉尔标准编号”，点击向右箭头添加
• 点击Save

6. 上传并归档一份测试档案

点击左侧菜单Documents→Upload→选择阿拉尔文书档案类型→点击Select files上传PDF扫描件→点击Next→填写全宗号（比如001）、保管期限（永久）、年度（2024）→点击Submit，系统会自动生成编号。

五、日常维护与备份

1. 数据备份

每周固定时间执行以下命令（生产环境可设置定时任务）：

``` 进入配置目录 cd /srv/mayan Windows为D:\mayan 停止服务 docker compose stop 压缩备份整个目录 tar -czf mayan_backup_$(date +%Y%m%d).tar.gz . 重启服务 docker compose up -d ```

备份文件需移动到外部存储设备。

2. 恢复数据

将备份文件解压到原配置目录，启动服务即可：

``` cd /srv/mayan Windows为D:\mayan 解压指定日期的备份（替换20240101为实际日期） tar -xzf mayan_backup_20240101.tar.gz 重启服务 docker compose up -d ```