当前位置：首页 > news >正文

Hyperledger Fabric：构建企业区块链网络的实践指南

news 2025/7/18 10:24:54

一、环境准备与工具安装

1. 必要工具安装

Docker与Docker Compose：用于容器化部署，确保环境一致性。
Go语言环境：链码开发所需，建议版本1.10+。
Node.js与npm：客户端应用开发依赖，建议版本6.x+。
Git：版本控制与代码管理。
cURL：命令行测试工具。

2. 获取Fabric资源

克隆官方仓库：
bash
git clone https://github.com/hyperledger/fabric-samples.git
cd fabric-samples
git checkout v1.1.0
下载二进制文件与镜像：
bash
curl -sSL https://bit.ly/2ysbOFE | bash -s

二、网络搭建与配置

1. 启动测试网络

进入测试网络目录：
bash
cd fabric-samples/test-network
启动网络（含两个组织Org1、Org2及排序节点）：
bash
./network.sh up

2. 创建通道并加入节点

创建名为mychannel的通道：
bash
./network.sh createChannel

3. 证书与密钥管理

使用cryptogen生成证书：
bash
../bin/cryptogen generate --config=./crypto-config.yaml
配置文件crypto-config.yaml示例：
yaml
OrdererOrgs:
- Name: Orderer
Domain: example.com
Specs:
- Hostname: orderer
PeerOrgs:
- Name: Org1
Domain: org1.example.com
Template:
Count: 2

三、链码开发与部署

1. 编写链码（以Go为例）

创建链码文件chaincode/basic/basic.go：

go

package main

import (

"fmt"

"github.com/hyperledger/fabric-contract-api-go/contractapi"

)

type SmartContract struct {

contractapi.Contract

}

func (s *SmartContract) InitLedger(ctx contractapi.TransactionContextInterface) error {

return nil

}

func (s *SmartContract) CreateAsset(ctx contractapi.TransactionContextInterface, id string, value string) error {

return ctx.GetStub().PutState(id, []byte(value))

}

func (s *SmartContract) ReadAsset(ctx contractapi.TransactionContextInterface, id string) (string, error) {

data, err := ctx.GetStub().GetState(id)

if err != nil {

return "", err

}

if data == nil {

return "", fmt.Errorf("asset %s not found", id)

}

return string(data), nil

}

func main() {

chaincode, err := contractapi.NewChaincode(new(SmartContract))

if err != nil {

panic(err.Error())

}

if err := chaincode.Start(); err != nil {

panic(err.Error())

}

2. 打包与安装链码

打包链码：
bash
peer lifecycle chaincode package basic.tar.gz --path ../chaincode/basic --lang golang --label basic_1
安装链码至Org1和Org2节点：
bash
peer lifecycle chaincode install basic.tar.gz

3. 批准与提交链码

获取链码包ID：
bash
peer lifecycle chaincode queryinstalled
批准链码定义（以Org1为例）：
bash
peer lifecycle chaincode approveformyorg --channelID mychannel --name basic --version 1.0 --package-id <PACKAGE_ID> --sequence 1 --init-required

提交链码至通道：

bash

peer lifecycle chaincode commit -o localhost:7050 --channelID mychannel --name basic --version 1.0 --sequence 1 --init-required --peerAddresses localhost:7051 --tlsRootCertFiles /path/to/org1/peer0/tls/ca.crt

4. 初始化链码

调用InitLedger方法初始化账本：
bash
peer chaincode invoke -o localhost:7050 --isInit -C mychannel -n basic -c '{"Args":["InitLedger"]}' --peerAddresses localhost:7051 --tlsRootCertFiles /path/to/org1/peer0/tls/ca.crt