如何搭建Farbic-samples环境

发布时间：2021-12-06 15:00:45 作者：小新
来源：亿速云阅读：163

# 如何搭建Fabric-samples环境

## 前言

Hyperledger Fabric是Linux基金会托管的开源区块链平台，广泛应用于企业级区块链解决方案。`fabric-samples`是官方提供的示例项目集合，包含链码（Chaincode）、网络配置和应用程序示例。本文将详细介绍如何从零开始搭建Fabric-samples开发环境。

---

## 环境准备

### 1. 系统要求
- **操作系统**：Ubuntu 20.04/22.04（推荐）或 macOS
- **内存**：至少8GB RAM
- **磁盘空间**：20GB可用空间
- **网络**：稳定的互联网连接（需下载Docker镜像）

### 2. 安装依赖工具

#### 安装Git
```bash
sudo apt update && sudo apt install -y git

安装cURL

sudo apt install -y curl

安装Docker和Docker Compose

# 安装Docker
sudo apt install -y docker.io
sudo systemctl enable --now docker

# 安装Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/download/v2.20.3/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

安装Go语言（可选，链码开发需要）

wget https://go.dev/dl/go1.20.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.20.linux-amd64.tar.gz
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
source ~/.bashrc

获取Fabric-samples

1. 下载官方脚本

curl -sSL https://bit.ly/2ysbOFE | bash -s

此脚本会自动： - 克隆fabric-samples仓库 - 下载指定版本的Hyperledger Fabric二进制文件和Docker镜像

2. 手动方式（备选）

git clone https://github.com/hyperledger/fabric-samples.git
cd fabric-samples
git checkout v2.4.9  # 使用稳定版本

配置环境变量

将Fabric二进制文件加入PATH：

echo 'export PATH=$PATH:$HOME/fabric-samples/bin' >> ~/.bashrc
source ~/.bashrc

验证安装：

fabric-ca-client version
peer version
orderer version

启动测试网络

1. 进入测试网络目录

cd fabric-samples/test-network

2. 启动网络

./network.sh up createChannel -c mychannel -s couchdb

参数说明： - -c mychannel：创建名为”mychannel”的通道 - -s couchdb：使用CouchDB作为状态数据库

3. 部署链码

./network.sh deployCC -ccn basic -ccp ../asset-transfer-basic/chaincode-go -ccl go

常见问题解决

1. Docker权限问题

sudo usermod -aG docker $USER
newgrp docker  # 立即生效

2. 端口冲突

错误示例：

Error: failed to create orderer: could not connect to Docker daemon

解决方案：

sudo systemctl restart docker

3. 镜像下载失败

手动拉取镜像：

docker pull hyperledger/fabric-peer:2.4
docker pull hyperledger/fabric-orderer:2.4

开发环境配置建议

1. IDE推荐

Visual Studio Code + Hyperledger Fabric扩展
GoLand（用于Go链码开发）

2. 调试配置

在launch.json中添加：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Debug Chaincode",
      "type": "go",
      "request": "launch",
      "mode": "debug",
      "program": "${workspaceFolder}/chaincode"
    }
  ]
}

进阶操作

1. 使用CA服务

./network.sh up -ca

2. 启用TLS加密

修改docker-compose-test-net.yaml：

environment:
  - ORDERER_GENERAL_TLS_ENABLED=true

3. 多机部署

修改core.yaml中的：

peer:
  gossip:
    bootstrap: peer1.org1.example.com:7051

总结

通过本文，您已完成： 1. 基础环境配置 2. Fabric-samples项目获取 3. 测试网络启动 4. 链码部署验证

建议下一步： - 阅读fabric-samples中的示例链码 - 尝试修改asset-transfer-basic示例 - 探索Fabric Gateway API的使用

官方文档参考：https://hyperledger-fabric.readthedocs.io “`

注：实际部署时请根据Fabric版本调整命令参数，本文以v2.4.x版本为例。如需其他版本，请替换脚本中的版本号。