荆门企事业单位本地部署档案管理软件从零落地实操指南

一、前期准备清单

• 服务器/本地设备：服务器最低配置2核4G内存，带宽1M，操作系统选Ubuntu 22.04 LTS；个人测试用Windows 10/11即可，硬盘剩余空间不低于20G
• 网络配置：服务器需开放8080、3306端口，云服务器需在安全组放行对应端口，本地部署无需额外配置
• 权限：Linux服务器需root操作权限，本地Windows部署需要预留管理员权限安装软件

二、分场景部署实操步骤

本文提供两种零门槛部署方案，服务器正式使用选Docker一键方案，个人测试选本地Windows方案，均可直接操作。

1. Docker一键部署（服务器推荐，10分钟完成）

远程登录服务器后打开终端，依次执行以下命令即可，所有命令可直接复制：

第一步：更新系统源并安装Docker和Docker Compose：

``` apt update && apt upgrade -y apt install docker docker-compose -y ```

第二步：创建完整的编排配置文件，数据库密码和端口已经预设好，无需修改即可使用：

``` cat > docker-compose.yml << EOF version: '3' services: dms: image: oitc/electronic-dms:latest ports: - "8080:8080" environment: DB_HOST: db DB_USER: root DB_PASSWORD: jingmen123456 DB_NAME: dms_db depends_on: - db restart: always db: image: mariadb:10.6 volumes: - dms_db_data:/var/lib/mysql environment: MYSQL_ROOT_PASSWORD: jingmen123456 MYSQL_DATABASE: dms_db restart: always volumes: dms_db_data: EOF ```

第三步：启动服务并放行端口：

``` docker-compose up -d ufw allow 8080/tcp ufw reload ```

等待3分钟服务启动完成后，打开浏览器访问 http://你的服务器公网IP:8080，使用初始账号 admin/123456 即可登录。

2. 本地Windows部署（个人测试推荐）

依次下载所需安装包，所有链接可直接点击下载：

• Zulu Java 11（64位）：https://cdn.azul.com/zulu/bin/zulu11.68.17-ca-jdk11.0.21-win_x64.msi
• MariaDB 10.6（64位）：https://downloads.mariadb.org/rest-api/mariadb/10.6.16/winx64-packages/mariadb-10.6.16-winx64.msi
• 档案管理程序包：https://github.com/oschina/electronic-dms/releases/download/v1.2.0/dms.war

第一步：安装Java，双击安装包一路点击下一步即可，安装完成后打开CMD，输入 java -version，输出版本信息即安装成功。

第二步：安装MariaDB，安装过程中设置root密码为 jingmen123456，勾选「Add installation directory to your PATH」，完成后打开CMD执行以下命令创建数据库：

``` mysql -u root -p 输入密码jingmen123456 create database dms_db default character set utf8mb4; exit; ```

第三步：启动程序，把下载好的dms.war放到D盘根目录，打开CMD执行以下命令：

``` d: java -jar dms.war --spring.datasource.password=jingmen123456 ```

等待启动完成后，打开浏览器访问 http://localhost:8080，使用初始账号admin/123456登录即可。

三、基础档案配置实操（满足本地单位要求）

1. 配置档案分类

登录后台后，点击左侧菜单 档案管理 > 档案分类，点击右上角「新增分类」，按照荆门本地企事业单位档案分类标准，创建一级分类如「行政文书」「会计档案」「人事档案」「项目档案」，二级分类按需添加，支持无限层级分类，保存即可生效。

2. 档案入库与权限配置

点击左侧菜单 档案管理 > 档案入库，选择对应分类，填写档案编号、档案名称、成文日期、保管期限，点击「上传附件」支持PDF、Word、Excel、图片等多种格式，保存即可完成入库。

权限配置：点击左侧 系统管理 > 权限管理，新增部门角色，给对应角色分配对应分类档案的查看/编辑权限，比如仅管理员可删除档案，普通员工仅可查看本部门档案，满足档案保密管理要求。

3. 档案检索调用

在首页搜索框输入档案编号、关键词即可秒级检索，支持按分类、成文日期、保管期限筛选，找到对应档案后点击下载即可获取原文件，无需线下登记调取。

四、常见卡壳问题解决

• 无法打开登录页：服务器部署先检查云服务器安全组是否放行8080端口，本地部署检查Java是否安装成功，端口被占用时，Docker部署修改docker-compose.yml中「8080:8080」的第一个8080为其他端口即可，本地部署启动时添加参数 --server.port=新端口。
• 忘记管理员密码：连接数据库执行以下命令即可重置为123456：

  update dms_user set password='e10adc3949ba59abbe56e057f20f883e' where username='admin';

• 数据备份：Docker部署执行以下命令即可生成当天备份，下载到本地安全位置保存即可：

  docker-compose exec db mysqldump -u root -pjingmen123456 dms_db > dms_backup_$(date +%Y%m%d).sql

以上全流程没有额外开发依赖，所有步骤都可直接复制执行，完成后即可满足日常档案存储、检索、权限管理的全部核心需求。