Windows 11系统下Hyperledger Bevel与Fabric安装步骤咨询

一、前置环境准备（必做） #

Hyperledger Fabric和Bevel对Windows原生环境支持有限，优先使用WSL2（Windows Subsystem for Linux 2），操作步骤如下：

• 启用WSL2：打开管理员权限的PowerShell，执行命令

  wsl --install
  

  重启系统后选择Ubuntu发行版（推荐20.04/22.04），设置本地用户名和密码。
• 更新WSL2内核：在PowerShell中执行

  wsl --update
  

• 在WSL的Ubuntu终端中安装必备工具：

  sudo apt update && sudo apt install -y curl git wget docker.io docker-compose
  

• 将当前用户加入docker组，避免每次操作需加sudo：

  sudo usermod -aG docker $USER
  

  退出终端重新登录后生效。

二、安装Hyperledger Fabric #

1. 获取并安装Fabric二进制文件与Docker镜像 #

在WSL Ubuntu终端中执行：

# 创建并进入Fabric工作目录
mkdir -p ~/hyperledger/fabric && cd ~/hyperledger/fabric
# 下载官方安装脚本并执行，指定安装二进制文件和Docker镜像
curl -sSL https://raw.githubusercontent.com/hyperledger/fabric/main/scripts/install-fabric.sh | bash -s -- binary docker

2. 配置环境变量 #

打开~/.bashrc文件，添加以下内容：

export PATH=$PATH:~/hyperledger/fabric/bin

执行命令使配置立即生效：

source ~/.bashrc

3. 验证安装结果 #

执行以下命令，能正常输出版本信息则说明安装成功：

peer version
cryptogen version

三、安装Hyperledger Bevel #

Hyperledger Bevel是区块链网络自动化部署工具，依赖Kubernetes环境，需先部署K8s集群再安装Bevel。

1. 部署轻量Kubernetes集群（Minikube） #

• 安装Minikube：

  curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
  sudo install minikube-linux-amd64 /usr/local/bin/minikube
  

• 启动Minikube集群（使用Docker驱动）：

  minikube start --driver=docker
  

• 安装kubectl（Kubernetes命令行工具）：

  curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
  sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl
  

2. 安装Hyperledger Bevel核心组件 #

• 克隆Bevel官方仓库：

  git clone https://github.com/hyperledger/bevel.git ~/hyperledger/bevel
  cd ~/hyperledger/bevel
  

• 安装Helm（Bevel依赖的Kubernetes包管理工具）：

  curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash
  

• 部署Bevel基础操作组件：

  helm repo add bitnami https://charts.bitnami.com/bitnami
  helm repo update
  helm install bevel-operator bitnami/kubectl --namespace bevel-system --create-namespace
  

3. 验证Bevel安装状态 #

检查Kubernetes命名空间bevel-system下的Pod运行状态，所有Pod处于Running状态则安装成功：

kubectl get pods -n bevel-system

关键注意事项 #

• 确保WSL2分配足够内存（建议至少4GB），可在C:\Users\<你的用户名>\.wslconfig中配置：

  [wsl2]
  memory=4GB
  

• Fabric版本需与Bevel支持的版本匹配，可查看Bevel官方文档确认兼容列表。
• 若遇到Docker权限报错，执行wsl --shutdown重启WSL2后重新操作即可。

内容的提问来源于stack exchange，提问作者Udit Agarwal