适合莆田社区单位快速搭建的开源数字档案馆实操指南

发布时间: 2026年09月17日 06:00:03 来源: 安答联动浏览量: 0

一、前期准备：确认本地环境+下载指定安装包

本次用完全免费开源的DocuBase Lite 2.0.3搭建，它支持档案分类、上传检索、权限管理，刚好匹配莆田市村级/社区级数字档案基础规范要求，配置门槛低。

1. 本地环境要求

操作系统：Windows 7及以上/ macOS 10.13及以上/ Ubuntu 18.04及以上
软件依赖：JDK 11（必须是LTS长期支持版，不支持17及以上版本的精简JRE）

2. 资源下载（复制链接到浏览器直接下载）

DocuBase Lite 2.0.3 安装包：https://github.com/docuBase/docuBase-lite/releases/download/v2.0.3/docubase-lite-2.0.3.zip
JDK 11 安装包（Windows选x64.msi，macOS选Intel/M1对应.dmg）：https://adoptium.net/zh-CN/temurin/releases/?version=11

二、环境配置：安装JDK 11并配置环境变量

1. Windows系统配置

双击下载的.msi文件，按默认路径（建议C:\Program Files\Eclipse Adoptium\jdk-11.0.22-hotspot，路径中不要有中文）点击“下一步”完成安装
右键“此电脑”→“属性”→“高级系统设置”→“环境变量”
在系统变量栏点击“新建”：
- 变量名：JAVA_HOME
- 变量值：C:\Program Files\Eclipse Adoptium\jdk-11.0.22-hotspot（若改了安装路径就填实际路径）
在系统变量栏找到“Path”变量，点击“编辑”→“新建”，分别添加：
- %JAVA_HOME%\bin
- %JAVA_HOME%\jre\bin
所有窗口点击“确定”保存，按Win+R输入cmd回车，执行java -version，若显示“openjdk version 11.0.22 2024-01-16”则配置成功

2. macOS系统配置

双击.dmg文件，按提示拖动图标到“应用程序”完成安装
打开“终端”（Launchpad→其他→终端），执行以下命令配置环境变量（不同shell略有区别，先执行echo $SHELL确认，以下是zsh/macOS 10.15+默认配置）：
- 编辑配置文件：nano ~/.zshrc
- 在文件末尾粘贴：
```
export JAVA_HOME=/Library/Java/JavaVirtualMachines/temurin-11.jdk/Contents/Home
export PATH=$JAVA_HOME/bin:$PATH
```
- 按Ctrl+O保存，回车确认文件名，再按Ctrl+X退出nano
- 刷新配置文件：source ~/.zshrc
执行java -version，版本正确则配置成功

三、DocuBase Lite 安装与启动

1. 解压与基础配置

将docubase-lite-2.0.3.zip解压到无中文、无空格的路径，比如Windows的D:\docubase、macOS的~/Documents/docubase
打开解压后的文件夹，找到application.yml（Windows若看不到后缀名，点击顶部“查看”→勾选“文件扩展名”），用记事本（Windows）或文本编辑（macOS，需先右键→打开方式→其他→勾选“始终用此应用”→选文本编辑）打开

找到端口配置行，默认是8080，若电脑8080被占用可修改为其他值（比如8081），其他配置无需动，完整配置如下（可直接覆盖原文件）：

server:
port: 8080
spring:
datasource:
url: jdbc:h2:file:./data/docubase;DB_CLOSE_ON_EXIT=FALSE;MODE=MYSQL
driver-class-name: org.h2.Driver
username: sa
password:
h2:
console:
enabled: true
path: /h2-console
jpa:
hibernate:
ddl-auto: update
show-sql: false
properties:
hibernate:
format_sql: false
dialect: org.hibernate.dialect.H2Dialect
docubase:
upload:
path: ./upload/
max-size: 52428800
init:
admin:
username: admin
password: admin123
search:
enable: true

保存并关闭application.yml

2. 系统启动

Windows系统：双击解压文件夹中的start.bat
macOS系统：打开终端，cd到解压后的文件夹（比如cd ~/Documents/docubase），执行chmod +x start.sh（给脚本添加执行权限），再执行./start.sh
等待终端/命令行窗口出现“Started DocuBaseLiteApplication in X.XXX seconds”（X是数字，一般20秒内），说明启动成功
打开任意浏览器（Chrome/Edge/Safari），输入http://localhost:8080（若改了端口就用修改后的），进入登录页面

四、莆田社区单位适配性基础设置

默认系统有通用档案分类，需按《莆田市城乡社区数字档案整理规范》调整分类树，同时设置管理员权限之外的基础档案员账号。

1. 登录系统

适合莆田社区单位快速搭建的开源数字档案馆实操指南

使用预设管理员账号登录：用户名admin，密码admin123

2. 调整档案分类树

点击左侧菜单栏的“档案管理”→“分类管理”
点击右上角的“新建分类”，新增莆田规范的一级分类：文书档案、会计档案、声像档案、实物档案、电子档案、专门档案（每个分类单独新建，一级分类编码按规范设为01-06）
点击一级分类右侧的“+子分类”，新增规范的二级分类（以文书档案为例，子分类设为011党群类、012行政类、013经营管理类）

3. 新建基础档案员账号

点击左侧菜单栏的“系统管理”→“用户管理”
点击右上角的“新建用户”，填写：
- 用户名：比如dangan01
- 密码：设为至少6位数字+字母
- 姓名：对应档案员姓名
- 角色：勾选“档案员”（仅可上传、检索、修改自己负责的分类档案）
点击“保存”

五、档案上传与检索实操

1. 档案上传

用档案员账号登录系统
点击左侧菜单栏的“档案管理”→“档案归档”
点击右上角的“新增档案”，填写必填项：
- 所属分类：选择刚才调整好的对应二级分类
- 档号：按莆田规范格式填写（比如011-2024-WS-001）
- 题名：档案的完整标题
- 归档日期：点击选择实际日期
- 保管期限：点击选择“永久/30年/10年”
点击“上传附件”，选择本地PDF/Word/图片等格式的档案文件（单个最大50MB）
点击“保存”完成归档