三亚中小微企事业单位档案管理系统本地部署零门槛实操指南
一、前置环境准备
1.1 必备软件获取
本方案适配三亚本地档案归档合规要求,全开源可商用,零成本落地,所有必备软件可直接通过以下地址或命令获取,不需要额外找资源:
- JDK1.8 64位Windows版:
https://download.oracle.com/java/18/archive/jdk-8u391-windows-x64.exe;Linux版直接执行对应命令:Debian/Ubuntu用sudo apt install openjdk-8-jdk -y,CentOS用sudo yum install java-1.8.0-openjdk -y - MySQL8.0 Windows版:
https://cdn.mysql.com/Downloads/MySQL-8.0/mysql-8.0.36-winx64.zip;Linux命令:sudo apt install mysql-server-8.0 -y - 三亚适配版档案管理系统安装包:
https://gitee.com/hi-dhl/open-dms/archive/v1.2.0-sanya.zip
1.2 环境配置完整步骤
JDK安装验证:Windows下双击exe按引导完成安装后,配置环境变量:右键此电脑→属性→高级系统设置→环境变量,新建系统变量JAVA_HOME,值为你的JDK实际安装路径(默认是C:\Program Files\Java\jdk1.8.0_391),然后编辑系统变量Path,新增两条:%JAVA_HOME%\bin、%JAVA_HOME%\jre\bin,保存后按Win+R输入cmd,执行java -version,输出版本号即成功。
MySQL安装配置(Windows版,Linux版安装后直接改密码建库即可):将下载的zip包解压到D盘根目录,路径为D:\mysql-8.0,在该目录新建文本文档,改名为my.ini,将以下内容完整复制进去:

``` [mysqld] port=3306 basedir=D:\\mysql-8.0 datadir=D:\\mysql-8.0\\Data max_connections=200 max_connect_errors=10 default-storage-engine=INNODB default_authentication_plugin=mysql_native_password character-set-server=utf8mb4 [client] default-character-set=utf8mb4 [mysql] default-character-set=utf8mb4 ```
以管理员身份打开cmd,执行以下命令:
cd D:\mysql-8.0\binmysqld --initialize --console,记住输出末尾的临时root密码mysqld install,安装完成后执行net start mysql启动服务- 执行
mysql -u root -p,输入临时密码登录,执行:ALTER USER 'root'@'localhost' IDENTIFIED BY 'Dms@123456';修改密码,再执行create database opendms default character set utf8mb4 collate utf8mb4_general_ci;创建数据库,环境配置完成。
二、系统配置与启动
2.1 修改配置文件
将下载的系统安装包解压到D盘根目录,打开解压目录下的config/application-prod.yml,将数据源配置替换为以下内容,如果你的数据库信息和上文一致,可以直接复制使用,不需要修改:
``` spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/opendms?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai username: root password: Dms@123456 server: port: 8080 sanya: archive-verify: true ```
系统已经预先开启三亚档案归档合规校验,不需要额外修改配置。
2.2 启动系统
Windows下找到解压目录中的start.bat,右键以管理员身份运行,等待1-2分钟,控制台输出Started OpenDmsApplication即启动成功;Linux下进入解压目录,执行chmod +x start.sh && ./start.sh即可启动。
三、初始化与日常操作
3.1 登录初始化
打开浏览器,本地部署访问http://127.0.0.1:8080,服务器部署访问http://你的服务器IP:8080,默认管理员账号:admin,默认密码:admin123,登录后第一时间在个人中心修改密码。
3.2 基础配置
- 点击左侧菜单系统管理→全宗配置,新增全宗,填入单位名称和三亚档案局分配的3位全宗号,保存即可
- 点击系统管理→用户管理,添加单位内部的档案管理员、查阅用户,按部门分配权限,符合档案保密要求
- 系统已经预设三亚要求的12种常用档案类型,包括文书、会计、工程、声像档案,不需要的可以直接禁用,需要新增自定义类型点击新增即可。
3.3 档案录入归档
- 点击档案管理→新增档案,选择对应档案类型,带红色星号的是三亚归档要求的必填项,按要求填写
- 上传档案电子扫描件,支持PDF、JPG、PNG格式,单文件最大支持100M,支持批量上传
- 填写完成点击提交,再点击归档,系统会自动校验是否符合三亚归档标准,不符合会给出具体修改提示,修正后重新归档即可,归档完成的档案支持在线查阅、下载、打印。
四、常见问题解决
- 启动提示端口被占用:打开application-prod.yml,将8080改为其他未占用端口,比如8081,重新启动即可
- 提示无法连接数据库:检查MySQL服务是否启动,检查库名、密码和配置文件是否一致
- 归档校验不通过:按提示补全全宗号、保管期限、归档年度等必填项即可,所有必填项都是三亚归档的强制要求。