码头数字档案馆：从零到可用的实操搭建与功能指南

前期环境快速搭建

步骤1：安装Docker运行环境

直接执行官方一键安装命令，适配绝大多数Linux系统：

``` curl -fsSL https://get.docker.com | sudo sh sudo systemctl enable --now docker ```

执行sudo docker --version验证安装，确保Docker版本不低于20.10，若版本过低，Ubuntu系统执行sudo apt update && sudo apt install docker.io升级。

步骤2：启动码头数字档案馆核心服务

执行以下命令拉取并运行ArchivesSpace开源数字档案系统镜像，端口映射为8080（Web访问）和8081（管理后台）：

``` sudo docker run -d -p 8080:8080 -p 8081:8081 --name archivespace \ -e "APP_URI=http://你的服务器IP:8080" \ archivesspace/archivesspace:latest ```

等待5分钟（首次启动需初始化数据），之后在浏览器输入http://你的服务器IP:8080访问系统，默认登录账号为admin，密码为admin，首次登录需修改密码（密码长度≥8位，含字母+数字）。

码头档案核心功能配置

步骤1：搭建档案分类模板

登录后进入左侧【管理】菜单，点击【档案分类】，按以下规则创建分类：

• 点击【新建分类】，输入分类名称（如“码头船舶档案”“码头设备维护档案”）
• 设置唯一分类ID（如DOCKER-SHIP-001、DOCKER-EQUIP-001），避免重复
• 勾选【可见】选项，点击【保存】即可

最多设置3级分类，层级过多会导致查询效率下降，所有分类需提前统一规划，匹配码头现有档案类别。

步骤2：单个档案快速录入

进入左侧【档案】菜单，点击【新建档案】，按要求填写必填项：

• 档案编号：格式建议为“年份-分类码-序号”（如2024-DOCKER-SHIP-001）
• 档案名称：需明确档案主题（如“XX轮2024年1月靠港审批记录”）
• 归档日期：填写纸质档案的实际归档日期
• 附件上传：点击【上传】，选择本地扫描的PDF/TIFF格式文件，单次最多上传10个

必填项全部填写完成后点击【保存】，系统自动生成唯一档案ID，不可修改。

步骤3：档案查询与导出

进入左侧【档案查询】菜单，输入档案编号/名称/分类名称，点击【搜索】；结果列表中点击任意档案，可查看完整元数据和附件；点击【导出】，选择导出格式：

• PDF导出：包含档案元数据+所有附件压缩包，符合国内档案管理规范
• CSV/JSON导出：用于数据分析或系统对接

导出文件自动命名为“档案编号-导出日期”，可直接存档。

数据备份与日常维护

步骤1：设置自动备份任务

手动备份执行以下命令，备份文件会同步到容器内/data/backup目录：

``` sudo docker exec archivespace /app/archivesspace/scripts/backup.sh /data/backup ```

设置每日凌晨2点自动备份，执行sudo crontab -e，在文件末尾添加一行：

``` 0 2 sudo docker exec archivespace /app/archivesspace/scripts/backup.sh /data/backup ```

同步备份到本地服务器，执行命令：

``` sudo docker cp archivespace:/data/backup /你的本地备份路径/码头档案备份 ```

每月将备份文件转移到离线存储介质，防止服务器故障导致数据丢失。

步骤2：服务状态检查

执行命令检查服务运行状态：

``` sudo docker ps | grep archivespace ```

若输出显示状态为Up X minutes，说明服务正常；若状态为Exited，执行sudo docker start archivespace即可重启。

每周至少检查一次服务状态，避免容器崩溃导致档案无法访问。

上线前最终验证

完成配置后执行3项必做验证：

• 随机上传3份不同分类的测试档案，验证搜索准确率
• 导出其中一份测试档案，检查附件是否完整、元数据是否正确
• 使用2台不同设备（如电脑、手机）访问系统，确认多端可用

所有验证通过后，即可正式投入码头档案数字化管理使用。