重庆档案管理系统开源轻量版本地零门槛快速部署实操指南

一、前置准备：确认3项基础环境

本次部署使用的是支持GB/T 18894-2016重庆档案数字化标准兼容的开源轻量档案系统「档案通Lite」，无需复杂服务器，普通Windows/Mac电脑即可完成。

1.1 检查电脑存储空间

至少预留10GB空闲C盘（Windows）/系统盘（Mac）+10GB非系统盘，前者存基础运行环境，后者存档案文件与数据库备份。

1.2 确认JDK 11安装状态

系统依赖JDK 11，按以下步骤操作：

• Windows：右键开始菜单→【Windows终端（管理员）】/【命令提示符（管理员）】，输入命令java -version，回车后显示版本包含「11.0.xx」即可；
• Mac：打开【启动台→其他→终端】，输入同样命令java -version，显示版本符合要求即可。

未安装的话，直接下载官方免费JDK 11压缩包：

• Windows：https://download.java.net/java/GA/jdk11/9/GPL/openjdk-11.0.2_windows-x64_bin.zip
• Mac（Intel/M1通用Rosetta）：https://download.java.net/java/GA/jdk11/9/GPL/openjdk-11.0.2_osx-x64_bin.tar.gz

1.3 提前创建本地档案目录

在非系统盘（如D盘、E盘、Mac的文稿文件夹子目录）新建3个文件夹，名字严格对应：

• dangan_data：存档案扫描件、电子文件；
• dangan_backup：存系统自动/手动生成的数据库备份；
• dangan_log：存系统运行日志（排查问题用）。

二、部署步骤：从下载到启动仅需5分钟

2.1 下载并解压档案通Lite安装包

官方下载地址（仅提供重庆标准兼容版）： https://gitee.com/dangantong/dangantong-lite-chongqing-standard/releases/download/v1.0.0/dangantong-lite-chongqing-v1.0.0.zip

• Windows：下载后右键压缩包→【解压到当前文件夹】，得到文件夹dangantong-lite-chongqing-v1.0.0；
• Mac：下载后双击压缩包自动解压，得到同名文件夹。

2.2 快速配置系统参数

打开解压后的文件夹，找到并双击打开配置文件application.yml（Windows用记事本、Mac用文本编辑，注意别改后缀），按以下步骤修改仅有的3项参数：

• 找到dangan.file-path这一行，将后面的默认路径改成你刚才创建的dangan_data的绝对路径（Windows路径分隔符用双反斜杠\\，Mac用单斜杠/）；
• 找到dangan.backup-path这一行，改成dangan_backup的绝对路径；
• 找到dangan.log-path这一行，改成dangan_log的绝对路径。

修改后的完整配置文件示例（Windows为例）：

```yaml server: port: 8080 dangan: file-path: D:\\dangan_system\\dangan_data backup-path: D:\\dangan_system\\dangan_backup log-path: D:\\dangan_system\\dangan_log standard: chongqing-gbt18894-2016 spring: datasource: url: jdbc:h2:file:./data/dangantong;DB_CLOSE_ON_EXIT=FALSE driver-class-name: org.h2.Driver username: admin password: admin123 h2: console: enabled: true path: /h2-console ```

修改完成后按Ctrl+S（Windows）/Cmd+S（Mac）保存并关闭。

2.3 启动系统

• Windows：打开解压后的文件夹，找到并双击start.bat文件；
• Mac：打开终端，输入cd （注意cd后面有空格），然后将解压后的文件夹拖到终端窗口自动补全路径，回车，再输入命令sh start.sh，回车。

等待终端出现「Started DangantongLiteApplication in X.XXX seconds」的提示，就说明系统启动成功了，不要关闭终端窗口，否则系统会停止。

三、首次登录与基础档案录入操作

3.1 浏览器登录系统

打开Chrome、Edge、Safari等主流浏览器，地址栏输入http://localhost:8080，回车进入登录页，默认账号密码：

• 账号：admin
• 密码：admin123

登录后系统会强制你修改密码，按要求设置8-16位包含数字和字母的新密码，修改后重新登录。

3.2 创建重庆标准兼容的档案分类

系统左侧菜单栏点击【档案分类→新建分类】，弹出窗口按重庆常用文书档案标准填写：

• 分类名称：文书档案
• 分类代码：WS
• 保管期限模板：选择「GB/T 18894-2016 重庆保管期限（永久/30年/10年）」
• 归档范围模板：选择「重庆市级机关文书档案归档范围」

点击【保存】完成。如需添加科技、会计、声像等其他重庆标准分类，重复此步骤，分类代码分别对应KJ、KJ-ZJ（会计账簿类子分类示例）、SX等。

3.3 单份/批量录入重庆标准档案

左侧菜单栏点击【档案管理→新增档案】：

• 单份录入：选择分类后，填写重庆标准必填项（带红色星号），包括档号、题名、责任者、成文日期、保管期限、页数、归档年度、全宗号（全宗号首次录入需输入，后续会自动保留），点击【上传文件】添加PDF/JPG扫描件或Word/Excel电子文件，最后点击【保存并归档】；
• 批量录入：点击新增档案页面右上角的【导入模板下载】，下载重庆标准Excel模板，按模板要求填写所有必填项，保存后点击【批量导入Excel】，上传文件和填写好的Excel表格（注意文件命名要和Excel模板中的「电子文件名」列完全一致），系统会自动匹配并归档。

四、日常维护与数据备份

4.1 手动备份数据库

左侧菜单栏点击【系统设置→数据备份】，点击【立即备份】，系统会自动将备份文件存入刚才配置的dangan_backup文件夹，文件名格式为「dangantong_备份时间.zip」，建议每月备份1次，年底备份2次（分别存电脑和U盘）。

4.2 恢复数据库

如果系统出问题需要恢复，点击【系统设置→数据恢复】，选择之前备份的zip文件，点击【开始恢复】，恢复完成后系统会自动重启，重新登录即可。

4.3 关闭系统的正确方式

不要直接关闭终端窗口，按以下步骤操作：

• Windows：在终端窗口按Ctrl+C，等待出现「Shutdown completed」提示后再关闭；
• Mac：在终端窗口按Ctrl+C，等待提示后关闭。

五、常见问题快速排查

• 问题1：启动start.bat/start.sh后闪退：检查是否正确安装了JDK 11，或者配置文件application.yml中的路径分隔符是否正确；
• 问题2：浏览器打不开http://localhost:8080：检查终端窗口是否显示系统启动成功的提示，或者端口8080是否被占用（如果被占用，打开配置文件application.yml，将server.port改成8081或其他未占用的端口，重启系统后用新端口登录）；
• 问题3：批量导入时提示文件不匹配：检查Excel模板中的「电子文件名」列和实际上传的文件命名是否完全一致（包括大小写、扩展名）。