档案软件接入区块链档案实操培训零门槛落地操作指南

准备工作

1. 基础环境要求

需使用Ubuntu 22.04 LTS桌面版，内存≥4GB，硬盘≥50GB，已激活root权限。

2. 必装工具安装

打开终端，依次执行以下命令（必须严格复制，无修改）：

``` sudo apt update && sudo apt upgrade -y sudo apt install docker.io docker-compose openjdk-17-jdk maven git -y sudo usermod -aG docker $USER newgrp docker ```

以上命令完成后，执行docker --version、docker-compose --version，输出Docker版本≥24.0，compose版本≥2.17即为安装成功。

实操第一步：搭建基础档案系统（Archivematica开源工具）

1. 下载稳定版预置环境

执行命令克隆官方测试仓库：

``` git clone https://github.com/artefactual/archivematica-compose.git cd archivematica-compose git checkout 1.17.x ```

2. 启动档案系统服务

修改docker-compose.override.yml，直接粘贴以下配置：

```yaml version: '3.8' services: archivematica-dashboard: ports: - "8000:80" ```

启动服务并等待初始化：

``` docker-compose up -d sleep 300 ```

打开浏览器访问http://localhost:8000，账号：admin，密码：admin，登录成功即档案系统搭建完成。

实操第二步：部署轻量区块链测试节点（Hyperledger Fabric 2.4.6）

1. 下载Fabric二进制工具

执行命令安装并配置Fabric环境：

``` curl -sSL https://raw.githubusercontent.com/hyperledger/fabric/main/scripts/bootstrap.sh | bash -s -- 2.4.6 1.5.6 mv bin $HOME/fabric-bin echo 'export PATH=$PATH:$HOME/fabric-bin' >> ~/.bashrc source ~/.bashrc ```

执行which peer，输出/home/[你的用户名]/fabric-bin/peer即为成功。

2. 创建单节点测试网络

创建工作目录并下载网络配置：

``` mkdir -p ~/fabric-single-node && cd ~/fabric-single-node curl -sSL https://raw.githubusercontent.com/hyperledger/fabric/v2.4.6/testnetwork/docker-compose.yml -o docker-compose.yml ```

启动网络并创建档案专属通道：

``` docker-compose up -d orderer ca peer0 sleep 10 peer channel create -o localhost:7050 -c archive-channel -f ./channel-artifacts/archive-channel.tx sleep 10 ```

执行后若生成archive-channel.block，表示通道创建成功。

实操第三步：部署档案专属区块链链码

链码是区块链处理档案数据的核心逻辑，直接执行以下命令安装并实例化：

``` peer chaincode install -n archive-chaincode -v 1.0 -p github.com/hyperledger/fabric-samples/chaincode/archive -l golang peer chaincode instantiate -o localhost:7050 --ordererTLSHostnameOverride orderer.example.com --tls --cafile $HOME/fabric-single-node/crypto-config/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem -C archive-channel -n archive-chaincode -v 1.0 -c '{"Args":["init"]}' -P "OR ('Org1MSP.peer')" sleep 30 ```

执行后输出chaincode instantiate successful，表示链码部署完成。

实操第四步：配置档案元数据上链映射

1. 元数据必填字段规范

档案需匹配区块链可识别的结构化字段，包含：

• 档案唯一ID：UUID（系统自动生成）
• 档案名称：字符串
• 创建时间：ISO 8601格式
• 文件哈希：SHA256（用于防篡改验证）

2. 自定义元导出插件配置

登录Archivematica后台→【系统管理】→【插件】→【元导出】→【添加插件】，选择【自定义Python插件】，粘贴以下完整代码：

```python import json import hashlib from datetime import datetime def compute_file_hash(file_path): sha256 = hashlib.sha256() with open(file_path, 'rb') as f: while chunk := f.read(4096): sha256.update(chunk) return sha256.hexdigest() def export_archive_metadata(uuid, name, file_path): return json.dumps({ "archive_id": uuid, "name": name, "create_time": datetime.utcnow().isoformat(), "file_hash": compute_file_hash(file_path) }) ```

保存后设置为【默认元导出插件】。

实操第五步：档案上链全流程操作

1. 单份档案上链

在Archivematica后台上传PDF测试档案，等待加工完成后点击【元数据导出】，保存生成的metadata.json到本地目录。

执行命令将元数据上传至区块链（替换[你的用户名]为当前系统用户名）：

``` peer chaincode invoke -o localhost:7050 --ordererTLSHostnameOverride orderer.example.com --tls --cafile $HOME/fabric-single-node/crypto-config/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem -C archive-channel -n archive-chaincode --peerAddresses localhost:7051 --tlsRootCertFiles $HOME/fabric-single-node/crypto-config/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt -c '{"function":"AddArchive","Args":["'$(cat metadata.json)'"]}' sleep 10 ```

输出transaction committed表示单份档案成功上链。

2. 批量档案上链与验证

创建批量上传脚本batch_upload.sh，内容如下：

```bash !/bin/bash cd ~/archivematica-compose for i in {1..5} do UUID=$(curl -s http://localhost:8000/api/transfer/ | jq -r '.transfer_uuid') METADATA=$(curl -s http://localhost:8000/api/transfer/$UUID/metadata/) peer chaincode invoke -o localhost:7050 --ordererTLSHostnameOverride orderer.example.com --tls --cafile $HOME/fabric-single-node/crypto-config/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem -C archive-channel -n archive-chaincode --peerAddresses localhost:7051 --tlsRootCertFiles $HOME/fabric-single-node/crypto-config/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt -c '{"function":"AddArchive","Args":["'$METADATA'"]}' sleep 10 done ```

赋予执行权限并运行：

``` chmod +x batch_upload.sh ./batch_upload.sh ```

验证批量上链结果，执行查询命令：

``` peer chaincode query -C archive-channel -n archive-chaincode -c '{"function":"GetAllArchives","Args":[]}' ```

输出包含5条档案元数据，且哈希值与本地档案匹配即为验证通过。

收尾操作（资源清理）

如需停止服务，执行：

``` cd ~/archivematica-compose && docker-compose down cd ~/fabric-single-node && docker-compose down ```

如需清理所有测试资源，执行：

``` docker system prune -a -f --volumes rm -rf ~/archivematica-compose ~/fabric-single-node ~/fabric-bin ```