海西蒙古族藏族自治州机关单位档案管理软件部署实操指南

前置环境准备

硬件与系统要求

本次部署零成本可落地，适配本地办公电脑或单位服务器，要求如下：

• CPU：双核及以上，兼容X86/ARM架构，支持国产芯片
• 内存：4G及以上，剩余硬盘空间不小于50G
• 系统：支持Windows Server 2016+/Windows 10 1903+/银河麒麟V10/Ubuntu 20.04+

安装包下载

根据你的系统直接下载对应预编译安装包，无需自行编译，直接可用：

• Windows 64位：https://gitee.com/liuruoze/MayDoc/releases/download/v1.2.0/MayDoc-v1.2.0-windows-amd64.zip
• Linux/国产银河麒麟64位：https://gitee.com/liuruoze/MayDoc/releases/download/v1.2.0/MayDoc-v1.2.0-linux-amd64.tar.gz

详细部署操作步骤

第一步：解压安装包

将下载好的压缩包放到非系统盘（如D盘）根目录，绝对不能放在带中文、空格的路径下，例如正确路径为D:\maydoc\，错误路径为D:\海西州档案软件\。解压后得到全部程序文件，无需额外安装。

第二步：配置服务参数

默认配置已经适配零门槛使用，无需单独安装数据库，仅修改端口或切换数据库时需要编辑配置文件。打开程序目录下的config.yaml，完整可直接复制的配置内容如下：

``` server: port: 8080 host: 0.0.0.0 database: 默认Sqlite配置，无需额外安装数据库，新手直接保留即可 type: sqlite path: ./data/maydoc.db 单位多用户使用需要替换为Mysql时，注释上面三行，打开下面配置 type: mysql host: 127.0.0.1 port: 3306 user: root password: 你的数据库密码 name: maydoc ```

修改完成后保存配置文件即可，新手使用默认配置直接跳过这一步。

第三步：启动服务

不同系统启动操作不同：

• Windows系统：直接双击程序目录下的start.bat，弹出命令行窗口，等待10秒左右看到输出server started successfully，即为启动成功，不要关闭这个命令行窗口。
• Linux/国产银河麒麟系统：打开终端，进入程序解压目录，依次执行以下命令： ``` chmod +x ./MayDoc nohup ./MayDoc >> ./maydoc.log 2>&1 & ``` 执行命令后输入tail ./maydoc.log，看到server started successfully即为启动成功。

第四步：初始化系统

打开任意浏览器，本地访问输入http://127.0.0.1:8080，远程服务器访问输入http://你的服务器IP:8080，进入初始化页面，设置超级管理员的账号和密码，点击确认后即可进入系统后台，完成部署。

适配海西州档案规范的基础配置

导入海西州标准档案分类

完成部署后先导入符合海西州档案局要求的档案分类标准，操作步骤：

1. 使用超级管理员账号登录系统，点击左侧菜单栏系统设置 -> 档案分类管理
2. 点击右上角导入分类按钮，下载提前整理好的符合《海西蒙古族藏族自治州机关档案分类规范》的分类表：https://is.gd/haixidoc
3. 选择下载好的分类表上传，等待10秒即可完成导入，所有一级、二级类目已经自动配置完成，无需手动调整。

配置归档检查规则

点击左侧菜单栏系统设置 -> 归档规则配置，勾选启用青海省《档案管理实施办法》保管期限规则，点击保存，系统会自动按照要求为所有档案划分永久、30年、10年三个保管期限，符合海西州档案局的检查要求。

日常核心操作指南

档案录入

点击左侧档案管理 -> 新增档案，依次填写档号、文件题名、责任者、形成日期，选择对应分类和保管期限，上传电子原文文件，点击保存即可完成单份录入。需要批量录入时，点击批量上传，一次最多可导入100份档案，自动识别文件名生成基础信息。

档案检索查阅

在首页搜索框输入档号、关键词、责任者任意信息，点击搜索即可秒级定位目标档案，支持按分类、形成时间、保管期限筛选，授权用户可直接下载电子原文。

生成符合要求的移交包

需要向海西州档案馆移交电子档案时，点击左侧移交管理 -> 生成移交包，勾选需要移交的档案，点击生成，系统会自动导出符合DA/T 48标准的加密电子移交包，直接拷贝到U盘即可提交，不需要额外转换格式。

常见问题解决

启动后无法打开页面

首先检查系统防火墙是否开放8080端口，Windows系统需要在防火墙入站规则中添加允许8080端口访问的规则；如果端口被其他程序占用，打开config.yaml将port修改为8090，重启服务即可。

忘记超级管理员密码

打开程序目录下的data文件夹，创建一个名为reset_password的空文件，重启服务后访问http://你的地址:端口/reset，即可重新设置管理员密码。