从零开始搭建一条私有链 区块链源码保姆级教程

我们选择的核心主题是“从零开始搭建一条私有链 区块链源码保姆级教程”，选定的写作视角为“故障排查与解决”。以下是基于此主题和视角撰写的文章内容。

环境准备与依赖安装

在开始搭建私有链之前，需要确保本地环境满足以下要求：

sudo apt update && sudo apt install golang-go

sudo apt install git

sudo apt install docker.io
sudo systemctl start docker
sudo systemctl enable docker

确保以上依赖项安装完成，并且Docker服务正常运行。可以通过以下命令检查Docker是否安装成功：

docker --version

克隆区块链源码

使用Git克隆官方区块链源码仓库：

git clone https://github.com/hyperledger/fabric.git -b v2.4.6
cd fabric/samples/test-network

上述命令克隆了Hyperledger Fabric的官方源码，并切换到v2.4.6版本。如果需要其他版本，可以修改`git clone`命令中的分支名称。

构建网络环境

使用Docker Compose构建私有链网络环境：

cd test-network
docker-compose up -d

上述命令会在后台启动整个区块链网络，包括Orderer节点、Peer节点和CA节点。启动完成后，可以通过以下命令检查Docker容器是否正常运行：

docker ps

配置创世块

在创建私有链之前，需要配置创世块。创世块包含了区块链的初始配置信息：

---
orderer.org: {
  orderer: {
    address: orderer.example.com:7050
  }
}
peer0.org1.example.com: {
  domain: org1.example.com
  port: 7051
  organization: Org1
}
peer1.org1.example.com: {
  domain: org1.example.com
  port: 8051
  organization: Org1
}
ca.org1.example.com: {
  url: http://ca.org1.example.com:7054
  organization: Org1
}
consensus.type: Raft
consensus.timeout_commit: 1s
consensus.timeout_propose: 15s
 Organizations: [
    {
      name: "Org1",
      mspId: "Org1MSP",
      domain: "org1.example.com",
     允许的公钥: [
        "30B4D4C9C9F1F9C5B6D2F3E0A1B2C3D4E5F6A7B8C9D0E1F2A3B4C5D6E7F8A9B0C1D2"
      ],
      anchorPeers: [
        {
          host: "peer0.org1.example.com",
          port: 7051
        }
      ]
    }
  ]
  Capabilities: {
    "V2_3": {
      Orderer: true,
      Peer: true
    }
  }
}

上述配置文件定义了Orderer节点、Peer节点和CA节点的地址、端口和组织信息。可以根据实际需求修改配置文件。

创建通道

创建通道是创建私有链的重要步骤。使用以下命令创建通道：

cd test-network
cryptogen generate --config=genesis.yaml
configtxgen -profile TwoOrgsOrderer -outputBlock ./genesis.block
docker-compose up -d

上述命令会生成创世块并启动网络环境。创建通道后，可以通过以下命令查看通道信息：

peer channel list

故障排查

如果在创建通道过程中遇到以下错误：

• “Error: Unable to create channel. Error: peer org1.example.com:7051 does not exist”
• “Error: Unable to create channel. Error: orderer.example.com:7050 does not exist”

请检查以下配置项：

• 确保Docker容器已经正常运行
• 检查`docker-compose.yml`文件中的服务配置是否正确
• 确保`cryptogen`命令生成的密钥文件是否正确

加入通道

创建通道后，需要将Peer节点加入通道：

cd test-network
peer channel join -b ./channel-artifacts/mychannel.block

上述命令会将Peer节点加入名为`mychannel`的通道。加入通道后，可以通过以下命令查看通道成员信息：

peer channel list

故障排查

如果在加入通道过程中遇到以下错误：

• “Error: Unable to join channel. Error: peer org1.example.com:7051 does not exist”
• “Error: Unable to join channel. Error: chaincode package is invalid”

请检查以下配置项：

• 确保Docker容器已经正常运行
• 检查`channel-artifacts`目录下的配置文件是否正确
• 确保链码包是否正确打包

部署链码

部署链码是私有链的核心步骤。使用以下命令部署链码：

cd test-network
peer chaincode deploy -o orderer.example.com:7050 -c '{"function":"init","args":[]}' -n mychaincode -v 1.0 -l node.js:0.4.0 -p /opt/gopath/src/github.com/your-org/your-chaincode

上述命令会部署名为`mychaincode`的链码。部署链码后，可以通过以下命令查看链码状态：

peer chaincode query -C mychannel -n mychaincode -c '{"function":"query","args":[]}'

故障排查

如果在部署链码过程中遇到以下错误：

• “Error: Unable to deploy chaincode. Error: chaincode package is invalid”
• “Error: Unable to deploy chaincode. Error: chaincode already exists”

请检查以下配置项：

• 确保链码包是否正确打包
• 确保链码版本是否唯一
• 确保链码路径是否正确

查询链码

部署链码后，可以查询链码状态：

cd test-network
peer chaincode query -C mychannel -n mychaincode -c '{"function":"query","args":[]}'

上述命令会查询链码的当前状态。如果一切正常，会返回链码的初始值。

故障排查

如果在查询链码过程中遇到以下错误：

• “Error: Unable to query chaincode. Error: chaincode not found”
• “Error: Unable to query chaincode. Error: chaincode package is invalid”

请检查以下配置项：

• 确保链码已经部署成功
• 确保查询的函数名和参数是否正确
• 确保链码路径是否正确

提交交易

提交交易是私有链的核心功能之一。使用以下命令提交交易：

cd test-network
peer chaincode invoke -o orderer.example.com:7050 -C mychannel -n mychaincode -c '{"function":"init","args":["A","100","B","200"]}'

上述命令会提交一条交易，将A账户的余额设置为100，B账户的余额设置为200。提交交易后，可以通过以下命令查询链码状态：

peer chaincode query -C mychannel -n mychaincode -c '{"function":"query","args":[]}'

故障排查

如果在提交交易过程中遇到以下错误：

• “Error: Unable to invoke chaincode. Error: chaincode package is invalid”
• “Error: Unable to invoke chaincode. Error: chaincode not found”

请检查以下配置项：

• 确保链码已经部署成功
• 确保交易的函数名和参数是否正确
• 确保链码路径是否正确

监控与维护

搭建私有链后，需要定期监控和维护网络环境：</