佛山档案管理本地化部署实操指南：用开源工具1小时落地
一、前期准备：确认适配条件与获取资源
本次使用的开源工具是「档案通Lite-适配粤东粤西粤北珠三角通用规范版」（后续简称档案通Lite），专为广东地区（含佛山）的企事业单位、街道社区基层档案需求设计，完全符合《广东省机关文书档案整理规则（2021版）》《佛山市城市建设档案移交目录规范》部分基础要求，无广告、无付费限制基础功能（含立卷归档、目录检索、PDF导出移交包）。
- 硬件/软件环境要求：
- Windows 7及以上/ macOS 10.15及以上/ Ubuntu 20.04及以上任意系统
- CPU：双核2.0GHz以上
- 内存：4GB以上（推荐8GB）
- 硬盘剩余空间：至少20GB（存档案原文用）
- 需提前安装JDK 17（无需配置环境变量，工具自带引导但需先安装）
- 资源获取地址：
- 档案通Lite安装包（全平台通用）：https://gitee.com/gd-dangan/dangantong-lite/releases/download/v1.2.3/dangantong-lite-v1.2.3.zip
- JDK 17安装包（按需选）：
- Windows x64：https://download.oracle.com/java/17/latest/jdk-17_windows-x64_bin.exe
- macOS Intel/Apple Silicon：https://download.oracle.com/java/17/latest/jdk-17_macos-aarch64_bin.dmg（Apple Silicon）/ https://download.oracle.com/java/17/latest/jdk-17_macos-x64_bin.dmg（Intel）
二、环境与工具部署：步骤化零卡壳
2.1 安装JDK 17（核心前置）
以Windows x64为例，其他系统直接按安装包默认引导点击「下一步」即可：
- 双击下载的
jdk-17_windows-x64_bin.exe，进入安装向导 - 勾选「接受许可协议」，点击「下一步」
- 修改安装路径（可选，默认C:\Program Files\Java\jdk-17，建议不改），点击「下一步」
- 等待安装完成，点击「关闭」
2.2 解压并启动档案通Lite
- 右键点击
dangantong-lite-v1.2.3.zip，选择「解压到当前文件夹」（Windows）/ 双击解压（macOS） - 进入解压后的
dangantong-lite文件夹：- Windows：双击
start.bat启动（首次启动会自动配置本地数据库，约10秒） - macOS：打开终端（Launchpad-其他-终端），输入
cd ~/Downloads/dangantong-lite（替换为实际解压路径，比如桌面就是cd ~/Desktop/dangantong-lite），按回车；再输入chmod +x start.sh，按回车；最后输入./start.sh，按回车 - Ubuntu 20.04+：打开终端，输入
cd ~/Downloads/dangantong-lite（替换路径），按回车；输入chmod +x start.sh，回车；输入./start.sh，回车
- Windows：双击
- 看到终端/命令行窗口显示「档案通Lite启动成功，访问地址：http://localhost:8080」后，不要关闭窗口，直接用浏览器打开该地址
- 首次登录：用户名
admin，密码dangantong123，登录后必须立即修改密码（点击右上角「个人中心」-「修改密码」，原密码输入dangantong123，新密码至少8位含字母数字）
三、佛山专属配置：快速适配地方规范
3.1 导入佛山基础元数据模板
佛山常用文书档案、城建档案基层目录元数据已内置在预设模板中，无需手动新建：
- 登录系统后，点击左侧菜单栏「系统管理」-「元数据模板」
- 点击右上角「导入模板」，选择解压文件夹内的
foshan-templates-202405.xlsx（没有的话也可以在系统元数据模板页点击「下载佛山通用模板」获取） - 确认导入成功后，元数据列表会出现「2024佛山文书档案-归档文件级」「2024佛山街道社区文书档案-保管单位级」「2024佛山基层城建档案-小类级」3个模板
3.2 配置移交包生成路径与格式
佛山部分街道/区档案局要求PDF移交包命名为「单位代码+年度+保管期限+类别号」格式，配置步骤：
- 点击左侧菜单栏「系统管理」-「系统参数」
- 找到「移交包配置」模块：
- 移交包格式：选择「PDF+Excel目录」（基层通用要求）
- 移交包命名规则：点击下拉框右侧「自定义」，输入
{orgCode}-{year}-{duration}-{classNo}（orgCode对应单位代码，year对应年度，duration对应保管期限，classNo对应类别号，参数不可修改，顺序可根据要求调整） - 原文存储路径：修改为非系统盘（Windows选D:\dangan-files，macOS/Ubuntu选~/Documents/dangan-files），点击「保存配置」
四、核心实操：从立卷到导出移交包全流程
4.1 新建全宗与年度
- 点击左侧菜单栏「全宗管理」-「全宗设置」
- 点击「新建全宗」，填写必填项：
- 全宗号：按佛山档案局分配的填写，比如「禅城区祖庙街道XX社区」全宗号示例「ZM001」
- 全宗名称：填写单位全称
- 单位代码：填写统一社会信用代码后9位
- 保管期限：勾选「永久」「30年」「10年」
- 点击「保存」，返回全宗设置页，点击对应全宗的「年度管理」
- 点击「新建年度」，输入「2023」（当前归档年度），点击「保存」
4.2 批量录入归档文件（核心高频操作）
以2024佛山文书档案-归档文件级为例，支持单条录入和Excel批量导入，推荐后者：
- 点击左侧菜单栏「归档管理」-「归档文件」
- 选择全宗「ZM001」、年度「2023」、保管期限「永久」、类别号「WS01」（文书档案收文类，可下拉选择佛山预设类别）
- 点击右上角「批量导入」，点击「下载导入模板」
- 打开下载的Excel模板，按表头提示填写：
- 必填项：文件标题、文号、责任者、成文日期（格式YYYY-MM-DD，比如2023-12-31）、页数、保管期限（填永久/30年/10年）、年度（填2023）
- 选填项：文件编号（系统自动生成，可留空）、主题词、备注
- 保存Excel模板后，返回批量导入页，选择「已填好的模板」，选择「原文文件夹」（存放对应PDF原文的文件夹，文件名必须与Excel的「文件标题」完全一致，系统自动匹配），点击「开始导入」
- 等待导入完成，检查「导入失败列表」（如果有，会提示错误原因，比如文件名不匹配、日期格式错误，修改后重新导入对应行即可）
4.3 生成归档目录与移交包
- 在「归档文件」页，选择刚导入的所有文件（勾选第一行全选框）
- 点击右上角「生成目录」，选择「2024佛山文书归档目录Excel版」，点击「生成」，下载后可直接查看/打印
- 再次勾选所有文件，点击右上角「导出移交包」，确认移交包格式、命名规则无误，点击「导出」，等待约1-5分钟（根据文件数量和大小），下载后解压检查内容：
- Excel目录：符合《广东省机关文书档案移交目录规范》
- PDF原文：按系统生成的文件编号排序，每个PDF单独命名
- 移交清单：自动生成移交单位、接收单位、移交时间、数量等信息
五、常见问题快速排查
- 启动start.bat闪退：检查JDK 17是否正确安装，可在命令行输入
java -version（Windows按Win+R，输入cmd，回车），如果显示版本号不对或找不到命令，需重新安装JDK 17 - 原文匹配失败：确认原文文件名与Excel「文件标题」完全一致（包括空格、标点符号、大小写，中文标点和英文标点不能混用）
- 导出移交包速度慢：检查原文存储路径是否在SSD硬盘，关闭其他占用内存的程序
- 忘记修改后的密码：关闭系统窗口，进入解压文件夹的
data子文件夹，删除dangantong.db文件，重新启动系统，使用初始密码admin/dangantong123登录（注意：删除数据库会清空所有数据，请谨慎操作，最好定期备份data文件夹）
相关文章
