哈尔滨市级地方标准数字档案馆本地快速模拟部署全流程

一、前期准备：系统环境+本地资源+基础工具

1.1 系统环境（最低/推荐配置）

• 操作系统：Ubuntu 22.04 LTS Server（推荐）/ CentOS 7.9（通用兼容），提前完成SSH、UFW防火墙设置（开放80、443、3306、22端口）
• 硬件配置：CPU 4核及以上、内存8G及以上、硬盘100G SSD（用于存储模拟电子档案）

1.2 本地资源+基础工具包

下载符合GB/T 18894-2022、黑龙江省DB23/T 2802-2021的开源轻量级数字档案管理系统（ArchivesSpace-Lite简化版）和本地化配置模板：

• ArchivesSpace-Lite简化版下载：https://github.com/archivesspace/archivesspace/releases/download/v3.4.1/archivesspace-lite-3.4.1.zip
• 本地化配置模板下载：https://gitee.com/harbin-local-dev/digital-archives-template/archive/refs/heads/main.zip
• 基础工具：提前安装JDK 11（必须是Oracle/OpenJDK 11，其他版本会报错）、MySQL 8.0、Git（可选）

二、基础环境安装与配置

2.1 Ubuntu 22.04 LTS 环境下JDK 11安装

依次执行以下命令：

``` 更新软件源 sudo apt update && sudo apt upgrade -y 安装OpenJDK 11 sudo apt install openjdk-11-jdk -y 验证安装（显示openjdk version "11.x.x"即成功） java -version ```

2.2 MySQL 8.0 安装与初始化

依次执行以下命令：

``` 安装MySQL 8.0 sudo apt install mysql-server -y 初始化安全配置（所有安全选项选y） sudo mysql_secure_installation 登录MySQL（用初始化后的root密码） sudo mysql -u root -p ```

登录后执行以下SQL语句创建数字档案专用数据库和用户：

```sql -- 创建utf8mb4字符集的数据库（必须符合黑龙江省地方标准） CREATE DATABASE harbin_archives DEFAULT CHARACTER SET utf8mb4 DEFAULT COLLATE utf8mb4_unicode_ci; -- 创建专用用户（harbin_arch_user，密码设为ArchLocal2024!） CREATE USER 'harbin_arch_user'@'localhost' IDENTIFIED BY 'ArchLocal2024!'; -- 授予数据库所有权限 GRANT ALL PRIVILEGES ON harbin_archives. TO 'harbin_arch_user'@'localhost'; -- 刷新权限 FLUSH PRIVILEGES; -- 退出MySQL EXIT; ```

2.3 解压并部署ArchivesSpace-Lite

依次执行以下命令：

``` 进入家目录 cd ~ 上传已下载的两个zip文件到该目录（可用scp命令或SFTP工具） 解压ArchivesSpace-Lite unzip archivesspace-lite-3.4.1.zip 重命名目录为harbin_archives_space mv archivesspace-lite-3.4.1 harbin_archives_space 解压本地化配置模板 unzip digital-archives-template-main.zip ```

三、本地化配置（核心贴合哈尔滨/黑龙江省要求）

3.1 数据库配置

用nano或vim编辑配置文件：

``` nano ~/harbin_archives_space/config/config.rb ```

找到以下配置段，替换为完整复制的内容：

```ruby MySQL数据库配置 AppConfig[:db_url] = "jdbc:mysql://localhost:3306/harbin_archives?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai&useSSL=false" AppConfig[:db_username] = "harbin_arch_user" AppConfig[:db_password] = "ArchLocal2024!" ```

3.2 元数据本地化配置

将模板中的元数据映射文件覆盖系统默认文件：

``` 备份默认元数据映射 cp ~/harbin_archives_space/config/locales/en.yml ~/harbin_archives_space/config/locales/en.yml.bak cp ~/digital-archives-template-main/locales/zh-CN.yml ~/harbin_archives_space/config/locales/ 设置中文为默认语言 nano ~/harbin_archives_space/config/config.rb ```

在config.rb末尾添加：

```ruby 设置黑龙江省哈尔滨市级默认语言、时区 AppConfig[:locale] = "zh-CN" AppConfig[:timezone] = "Asia/Harbin" 启用黑龙江省DB23/T 2802-2021要求的电子文件格式检测（PDF/A、TIFF、DOCX等） AppConfig[:enable_format_validation] = true AppConfig[:required_formats] = ["application/pdf", "application/pdfa-1a", "application/pdfa-1b", "image/tiff", "application/vnd.openxmlformats-officedocument.wordprocessingml.document"] ```

3.3 初始化系统元数据和哈尔滨本地档案分类

依次执行以下命令：

``` 进入系统目录 cd ~/harbin_archives_space 初始化数据库（时间约3-5分钟） ./scripts/setup-database.sh 导入哈尔滨本地档案分类表（来自模板） ./scripts/import-metadata.sh ~/digital-archives-template-main/metadata/harbin_category_tree.xml ```

四、启动系统并完成首次登录

4.1 后台启动系统

用screen工具后台启动（防止SSH断开后系统关闭）：

``` 安装screen sudo apt install screen -y 创建screen会话 screen -S harbin_archives 启动系统 cd ~/harbin_archives_space ./scripts/startup.sh ```

看到类似「ArchivesSpace Lite started successfully on http://0.0.0.0:8080」提示后，按Ctrl+A，再按D退出screen会话。

4.2 首次登录并修改默认密码

• 浏览器访问：http://你的服务器IP:8080
• 默认账号：admin，默认密码：admin
• 首次登录强制修改密码（建议设为HarbinArch2024!Admin，包含大小写字母、数字、特殊符号）

五、模拟录入哈尔滨市级电子档案（验证本地化效果）

5.1 录入电子档案全宗

• 登录后点击左侧「管理」→「全宗管理」→「新建全宗」
• 必填项（符合黑龙江省要求）：全宗号（设为HA-2024-001，HA代表哈尔滨）、全宗名称（设为哈尔滨市模拟档案局2024年度试点全宗）、全宗起始日期（设为2024-01-01）
• 点击「保存」

5.2 录入归档文件并上传PDF/A格式文件

• 点击左侧「管理」→「档案管理」→「新建档案」，选择刚才创建的全宗
• 必填项：档号（设为HA-2024-001-WS-0001，WS代表文书类）、题名（设为哈尔滨市2024年度数字档案馆试点建设方案）、归档日期、保管期限（选择永久/长期/短期）
• 点击「上传电子文件」，选择符合要求的PDF/A-1b文件（可在线用https://www.ilovepdf.com/zh_cn/pdf_a转换）
• 系统会自动检测格式，符合要求后点击「保存并发布」

六、日常维护关键操作

6.1 系统启停

• 停止系统：进入screen会话（screen -r harbin_archives），按Ctrl+C
• 重启系统：停止后执行./scripts/startup.sh

6.2 数据备份

依次执行以下命令（建议每日定时备份，可加入crontab）：

``` 备份MySQL数据库 mysqldump -u harbin_arch_user -pArchLocal2024! harbin_archives > ~/harbin_archives_backup_$(date +%Y%m%d).sql 备份电子文件和配置 tar -zcvf ~/harbin_archives_files_backup_$(date +%Y%m%d).tar.gz ~/harbin_archives_space/data ```