从零快速部署南充适用中小微本地化通用档案管理软件全配置步骤

前置准备：软硬件环境与官方开源工具选择

一、硬件环境要求（零门槛最低配置）

• CPU：Intel i3 或 AMD 同级别及以上
• 内存：8GB DDR4 及以上
• 存储：本地SSD 50GB 及以上（建议预留200GB做长期归档）
• 操作系统：Windows 10/11 专业版/企业版 64位 或 CentOS Stream 8/9 最小化安装版

二、软件环境与工具下载（100%无广告无付费开源链）

本次使用的是国内政务/中小微通用开源南充适配版档案管理原型Mayan EDMS汉化分支南充版V4.4.12_NC，该分支已内置南充市常用的文书、科技、会计、声像、实物5类档案元数据模板，无需手动大量调整。

下载地址（Gitee国内镜像）：https://gitee.com/nc-archives-open-source/mayan-edms-nc/releases/tag/V4.4.12_NC

配套环境下载（可一键打包Docker镜像+Compose配置，小白推荐Windows直接用Docker Desktop，Linux用Podman Compose）：

• Windows Docker Desktop：https://download.docker.com/win/stable/Docker%20Desktop%20Installer.exe
• Linux Podman+Compose安装脚本（复制到终端直接运行）：

  
  CentOS Stream 8/9
  sudo dnf -y update
  sudo dnf -y install podman podman-compose
  sudo systemctl enable --now podman
  sudo systemctl enable --now podman.socket
  

正式部署：Windows/Linux 全流程统一（仅Compose文件复制路径不同）

一、Windows环境部署（10分钟内完成）

• 步骤1：解压工具包

下载Gitee上的mayan-edms-nc-V4.4.12_NC.zip到桌面，右键解压到当前文件夹，得到mayan-edms-nc子文件夹，内含docker-compose.yml完整配置、nc-templates元数据模板包、nc-backup自动备份脚本。

• 步骤2：配置Docker Desktop

双击打开Docker Desktop，首次启动需同意服务协议并等待Docker Engine启动（右下角托盘出现鲸鱼图标且变绿即完成）；若启动失败，可在BIOS中开启Intel VT-x/AMD-V虚拟化技术。

• 步骤3：部署Mayan EDMS南充版

打开mayan-edms-nc子文件夹，在地址栏输入cmd并回车，进入命令行窗口，输入以下命令并回车：

docker-compose up -d

等待5-8分钟，直到命令行窗口出现Creating mayan-edms-nc_db_1 ... doneCreating mayan-edms-nc_app_1 ... done等3个done提示。

• 步骤4：首次访问与初始化



打开浏览器（推荐Chrome/Edge最新版），输入地址http://localhost:8000；首次登录账号密码均为admin，登录后立即修改密码（右上角头像→修改密码→输入原密码admin→输入2次新密码→点击保存）。

二、Linux环境部署（15分钟内完成）

• 步骤1：上传工具包

使用FileZilla或WinSCP（下载地址https://winscp.net/eng/download.php）将mayan-edms-nc-V4.4.12_NC.zip上传到Linux服务器的/opt目录，然后通过SSH终端（推荐Xshell）执行以下命令解压：

cd /opt
sudo unzip mayan-edms-nc-V4.4.12_NC.zip
sudo chmod -R 777 mayan-edms-nc/

• 步骤2：部署Mayan EDMS南充版

进入mayan-edms-nc目录，执行部署命令：

cd /opt/mayan-edms-nc
sudo podman-compose up -d

等待6-10分钟，直到终端出现3个done提示。

• 步骤3：首次访问与初始化

同Windows步骤4，地址替换为Linux服务器的内网IP（如http://192.168.1.100:8000），外网访问需在路由器/防火墙开放8000端口，并绑定域名（可选）。

南充本地化元数据与归档流程配置（5分钟内落地）

一、一键导入南充市常用档案元数据模板

• 步骤1：进入系统设置

登录后点击左侧菜单栏设置→导入/导出→导入配置。

• 步骤2：选择并上传模板

点击选择文件，找到解压后的nc-templates文件夹，选择nc-5-types-archives-metadata.json，点击上传并导入，等待10秒出现“导入成功”提示。

• 步骤3：验证模板是否生效

点击左侧菜单栏文档类型，查看是否已出现“文书档案-永久/30年/10年”“科技档案-基建/设备/科研”等11个南充常用文档类型。

二、配置自动归档与OCR识别（仅需点击3次）

• 步骤1：开启默认OCR

点击左侧菜单栏设置→OCR→默认OCR后端，选择Tesseract OCR 4，点击保存。

• 步骤2：设置自动分类与命名规则

以文书档案-永久为例：点击左侧菜单栏文档类型→找到“文书档案-永久”→点击右侧编辑→找到默认命名模板，输入{{ document.metadata_value_of.年度 }}-{{ document.metadata_value_of.保管期限 }}-{{ document.metadata_value_of.件号 }}-{{ document.metadata_value_of.责任者 }}-{{ document.metadata_value_of.题名 }}→找到自动分类到文件夹，选择“默认归档文件夹”→点击保存。

• 步骤3：配置每日自动备份

Windows环境：双击打开mayan-edms-nc文件夹中的nc-daily-backup.bat，右键点击“创建快捷方式”，将快捷方式剪切到C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp文件夹（需开启隐藏文件查看）；Linux环境：执行以下命令添加定时任务：

sudo crontab -e
在打开的文件末尾添加一行（每天凌晨2点备份）
0 2    /opt/mayan-edms-nc/nc-daily-backup.sh

日常使用：3个核心操作（快速上手）

• 操作1：上传档案

点击左侧菜单栏上传文档→选择文档类型（如文书档案-永久）→填写必填元数据（年度、保管期限、件号、责任者、题名，其他可选）→选择本地文件（支持PDF、Word、Excel、JPG、PNG等格式）→点击上传，系统会自动OCR识别、分类、命名。

• 操作2：检索档案

点击顶部搜索栏，输入关键词（如“2023年度工资表”），支持全文检索、元数据检索、文件类型检索，点击搜索结果即可预览或下载。

• 操作3：权限管理

点击左侧菜单栏设置→用户与组→用户→创建用户，输入用户名、密码、邮箱，选择所属用户组（如“档案管理员组”“普通查阅组”），点击保存；可在文档类型→权限中为不同用户组设置不同权限（如查阅、下载、编辑、删除）。

常见卡壳问题解决（1分钟内修复）

• 问题1：访问地址打不开

Windows：打开Docker Desktop托盘，点击Restart重启所有容器；Linux：执行sudo podman-compose restart。

• 问题2：OCR识别失败

打开浏览器控制台（F12），若提示“Tesseract未安装中文包”，执行以下命令（Windows需在Docker Desktop终端，点击左侧菜单栏Containers→找到mayan-edms-nc_app_1→点击右侧CLI）：

apt-get update && apt-get install -y tesseract-ocr-chi-sim

• 问题3：忘记admin密码

进入容器终端（同上），执行以下命令重置密码为admin123：

mayan-edms.py changepassword admin

然后输入2次新密码admin123即可。