基于联盟链的档案软件区块链存证应用落地实操指南

一、环境准备（Ubuntu 20.04+ 可直接执行）

本方案基于开源联盟链FISCO BCOS搭建，适合档案存证场景，无需公链节点，成本低，所有命令可直接复制执行：

1.1 安装基础依赖

执行以下命令安装所有依赖：

``` sudo apt update && sudo apt install -y openssl curl git docker docker-compose ```

1.2 一键部署四节点联盟链

执行以下命令拉取部署脚本并启动节点：

``` 创建工作目录 mkdir -p ~/fisco-archive && cd ~/fisco-archive 拉取官方部署脚本 wget https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v2.9.1/build_chain.sh 生成本地四节点配置 bash build_chain.sh -l 127.0.0.1:4 -p 30300,20200,8545,9545 启动所有节点 cd nodes/127.0.0.1 && bash start_all.sh ```

执行完成后，输入以下命令验证节点是否启动成功：

``` ps aux | grep fisco-bcos | grep -v grep ```

如果输出4个fisco-bcos进程，说明节点部署成功。

二、部署档案存证智能合约

2.1 编写存证合约

合约只存储档案哈希信息，不存储原始档案内容，保护隐私，完整合约代码如下：

``` pragma solidity ^0.6.10; contract ArchiveEvidence { // 存证结构：档案ID映射存证信息 struct ArchiveInfo { string archiveHash; // 档案文件SHA256哈希 string operatorHash; // 操作人账号哈希 uint256 timestamp; // 存证时间戳 } mapping(string => ArchiveInfo) private archives; // 存证事件，用于节点同步 event ArchiveStored(string indexed archiveId, address sender); // 新增存证方法 function storeArchive(string memory archiveId, string memory archiveHash, string memory operatorHash) public { ArchiveInfo storage info = archives[archiveId]; info.archiveHash = archiveHash; info.operatorHash = operatorHash; info.timestamp = block.timestamp; emit ArchiveStored(archiveId, msg.sender); } // 查询存证方法 function getArchive(string memory archiveId) public view returns(string memory, string memory, uint256) { ArchiveInfo memory info = archives[archiveId]; return (info.archiveHash, info.operatorHash, info.timestamp); } } ```

2.2 部署合约到链上

执行以下命令拉取FISCO控制台，部署合约：

``` cd ~/fisco-archive git clone https://github.com/FISCO-BCOS/console.git cd console && ./start.sh ```

进入控制台后，将上面的合约代码保存为ArchiveEvidence.sol放到console/contracts/solidity目录下，然后在控制台执行：

``` deploy ArchiveEvidence ```

部署完成后，控制台会输出合约地址，请保存该地址，后续接口开发会用到。

三、对接现有档案软件的接口开发

本方案无需修改档案软件核心代码，只需新增HTTP接口即可完成对接，使用Node.js开发，步骤如下：

3.1 初始化项目

``` cd ~/fisco-archive && mkdir archive-api && cd archive-api npm init -y npm install express web3 dotenv --save ```

3.2 配置环境变量

新建.env文件，填入以下内容，仅替换成你自己的合约地址即可：

``` NODE_RPC_URL=http://127.0.0.1:8545 CONTRACT_ADDRESS=你刚才部署合约生成的地址 PRIVATE_KEY=0x28993d8a5e9a6c01c2a89d3c0f5a0e2b0d1a5d1c5f5a0e2b0d1a5d1c5f5a0e2b PORT=3000 ```

上面的私钥是FISCO控制台默认测试账号的私钥，可以直接用，生产环境替换成专属部署账号私钥即可。

3.3 完整可运行接口代码

新建app.js，填入以下代码：

``` require('dotenv').config(); const express = require('express'); const Web3 = require('web3'); const contractABI = [ { "inputs": [ {"internalType": "string", "name": "archiveId", "type": "string"}, {"internalType": "string", "name": "archiveHash", "type": "string"}, {"internalType": "string", "name": "operatorHash", "type": "string"} ], "name": "storeArchive", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{"internalType": "string", "name": "archiveId", "type": "string"}], "name": "getArchive", "outputs": [ {"internalType": "string", "name": "", "type": "string"}, {"internalType": "string", "name": "", "type": "string"}, {"internalType": "uint256", "name": "", "type": "uint256"} ], "stateMutability": "view", "type": "function" } ]; const app = express(); app.use(express.json()); const web3 = new Web3(Web3.givenProvider || process.env.NODE_RPC_URL); const archiveContract = new web3.eth.Contract(contractABI, process.env.CONTRACT_ADDRESS); const account = web3.eth.accounts.privateKeyToAccount(process.env.PRIVATE_KEY); // 档案存证接口 app.post('/store', async (req, res) => { const {archiveId, archiveHash, operatorHash} = req.body; try { const encodedABI = archiveContract.methods.storeArchive(archiveId, archiveHash, operatorHash).encodeABI(); const tx = { from: account.address, to: process.env.CONTRACT_ADDRESS, gas: 200000, data: encodedABI }; const signedTx = await web3.eth.accounts.signTransaction(tx, process.env.PRIVATE_KEY); const receipt = await web3.eth.sendSignedTransaction(signedTx.rawTransaction); res.json({code: 0, txHash: receipt.transactionHash}); } catch (e) { res.json({code: 1, msg: e.message}); } }); // 档案验真查询接口 app.post('/verify', async (req, res) => { const {archiveId, currentHash} = req.body; try { const result = await archiveContract.methods.getArchive(archiveId).call(); const onChainHash = result[0]; res.json({code: 0, isVerified: onChainHash === currentHash, onChainHash, timestamp: result[2]}); } catch (e) { res.json({code: 1, msg: e.message}); } }); app.listen(process.env.PORT, () => { console.log(`接口服务启动在端口${process.env.PORT}`); }); ```

启动接口服务：

``` node app.js ```

四、业务落地操作流程

• 存证流程：档案软件上传档案完成后，调用SHA256算法计算档案文件的哈希值，对操作人账号做哈希处理（保护隐私），然后调用http://你的服务器IP:3000/store接口，传入archiveId（档案软件内部的档案ID）、archiveHash、operatorHash，将接口返回的txHash存入档案软件的档案信息表，完成存证。
• 验真流程：需要验证档案是否篡改时，重新计算当前档案的SHA256哈希，调用http://你的服务器IP:3000/verify接口，传入档案ID和当前哈希，接口返回isVerified为true就是未篡改，false就是档案被修改过。

五、常见问题排查

1. 节点启动失败：执行netstat -tunlp |grep 30300查看端口是否被占用，如果被占用，重新执行部署脚本更换端口即可。

2. 接口调用失败：检查节点是否正常运行，合约地址和私钥是否填写正确，防火墙是否开放3000端口。

3. 验真不通过：检查档案文件是否被修改，或者哈希计算方式是否和存证时一致，必须统一使用SHA256算法。