能否在Hyperledger Fabric存储真实数据？求入门指引（已搭测试网）

当然可以用Hyperledger Fabric存储真实世界数据，包括医疗健康PDF这类文件。不过要注意，Fabric本身更适合存数据哈希+元数据，大文件直接存链上会占用过多资源、拖慢交易速度，通常的做法是把文件存在链下存储系统，链上只存文件的哈希值和关键元数据，用来做不可篡改的完整性验证。

入门思路 #

1. 确定存储架构 #

选择链下存储介质：测试阶段可用本地文件系统，生产环境推荐IPFS、MinIO这类分布式存储。核心逻辑：

• 将PDF文件上传到链下存储，获取可访问的文件地址
• 计算文件的SHA-256哈希值（确保文件唯一且可验证）
• 把哈希值、文件名、上传时间、所有者、文件访问地址这些元数据打包，写入Fabric链上

2. 编写链码（智能合约） #

写一个简单的链码，包含核心操作：

• 存储文件元数据与哈希的函数
• 查询元数据的函数
• 验证文件完整性的函数（对比传入的哈希和链上存储的哈希）

示例Go语言链码片段：

type FileMetadata struct {
    FileID      string `json:"fileID"`
    FileName    string `json:"fileName"`
    FileHash    string `json:"fileHash"`
    StorageURL  string `json:"storageURL"`
    Owner       string `json:"owner"`
    UploadTime  string `json:"uploadTime"`
}

func (s *SmartContract) StoreFileMetadata(ctx contractapi.TransactionContextInterface, fileID string, fileName string, fileHash string, storageURL string, owner string) error {
    metadata := FileMetadata{
        FileID:      fileID,
        FileName:    fileName,
        FileHash:    fileHash,
        StorageURL:  storageURL,
        Owner:       owner,
        UploadTime:  time.Now().Format(time.RFC3339),
    }
    metadataBytes, err := json.Marshal(metadata)
    if err != nil {
        return err
    }
    return ctx.GetStub().PutState(fileID, metadataBytes)
}

func (s *SmartContract) VerifyFileIntegrity(ctx contractapi.TransactionContextInterface, fileID string, inputHash string) (bool, error) {
    metadataBytes, err := ctx.GetStub().GetState(fileID)
    if err != nil {
        return false, err
    }
    if metadataBytes == nil {
        return false, fmt.Errorf("file metadata not found")
    }
    var metadata FileMetadata
    err = json.Unmarshal(metadataBytes, &metadata)
    if err != nil {
        return false, err
    }
    return metadata.FileHash == inputHash, nil
}

3. 部署链码到测试网络 #

用Fabric CLI完成链码的打包、安装与实例化：

# 打包链码
peer lifecycle chaincode package filecc.tar.gz --path ./chaincode/filecc --lang golang --label filecc_1.0

# 安装到peer节点
peer lifecycle chaincode install filecc.tar.gz

# 批准链码定义（需指定组织）
peer lifecycle chaincode approveformyorg -o localhost:7050 --ordererTLSHostnameOverride orderer.example.com --channelID mychannel --name filecc --version 1.0 --package-id filecc_1.0:<PACKAGE_ID> --sequence 1

# 提交链码到通道
peer lifecycle chaincode commit -o localhost:7050 --ordererTLSHostnameOverride orderer.example.com --channelID mychannel --name filecc --version 1.0 --sequence 1 --peerAddresses localhost:7051 --tlsRootCertFiles $PEER0_ORG1_CA

4. 测试数据存储与验证 #

1. 计算本地PDF文件的哈希：

   sha256sum your-medical-document.pdf
   

2. 将PDF上传到链下存储，拿到访问URL
3. 调用链码的StoreFileMetadata函数，写入元数据：

   peer chaincode invoke -o localhost:7050 --ordererTLSHostnameOverride orderer.example.com --tls --cafile $ORDERER_CA -C mychannel -n filecc --peerAddresses localhost:7051 --tlsRootCertFiles $PEER0_ORG1_CA -c '{"function":"StoreFileMetadata","Args":["file001","patient-report.pdf","<计算出的哈希值>","http://your-storage/file001.pdf","patient001"]}'
   

4. 验证文件完整性：重新计算文件哈希，调用VerifyFileIntegrity函数对比链上数据

5. 针对医疗数据的优化 #

• 加入访问控制：在链码中判断调用者身份，只有授权用户（如患者、主治医生）才能查询或修改元数据
• 使用私有数据集合：把敏感元数据（如患者ID）存入私有集合，仅指定节点可见
• 链下文件加密：对存储的医疗PDF进行加密，只有授权用户能解密访问

内容的提问来源于stack exchange，提问作者Dipansu Sahu