Ubuntu22安装Hyperledger fabric网络（保姆级教程）

【注意】务必安装最新版本的Ubuntu（截止到2025年6月最新版本是Ubuntu22）。旧版本系统预装的部分软件包版本较低，当尝试安装新的软件时，可能会出现依赖冲突或版本不兼容的情况，进而导致安装过程中频繁报错。

1. 安装准备

提前安装git，curl，docker，docker-compose，go，jq

sudo apt-get install git curl docker-compose golang jq

验证安装是否成功

docker --version
docker-compose --version
go --version

将当前用户加入到docker组（确保拥有后续所需的操作权限）

sudo usermod -a -G docker <username>

（把<username>整体替换成你的用户名）

开启docker

sudo systemctl start docker
sudo systemctl enable docker

2. 安装样本案例

【为什么要安装样本案例】这些示例网络涵盖了从简单的交易流程到复杂的共识机制，帮助开发者快速搭建测试环境；并且可以通过运行示例网络来验证开发环境是否正确搭建，确保所有依赖项和配置都已正确安装

提前准备一个文件夹用来存放案例，例如~/home/myfabric

克隆fabric-samples到目标文件夹

mkdir -p ~/home/myfabric
cd ~/home/myfabric
curl -sSLO https://raw.githubusercontent.com/hyperledger/fabric/main/scripts/install-fabric.sh && chmod +x install-fabric.sh

这一步执行后在myfabric文件夹里会出现install-fabric.sh文件，后面需要的组件都需要通过这个文件去安装

./install-fabric.sh docker samples binary

（这一步容易出现两个错误，1. permission denied类型错误，权限不够，需要将当前用户添加到docker组 2. 版本过老类型错误，fabric网络运行要求glibc 2.34以上，只有Ubuntu22满足，所以最好使用Ubuntu22版本以上系统）

如果以上都成功执行，则可以成功运行fabric网络。

3. 运行测试网络

cd ~/home/myfabric/fabric-samples/test-network

在这个文件夹里找到network.sh文件，首先需要清除掉有可能已经运行的docker容器

./network.sh down

之后重新启动网络（在当前路径下运行下列命令）

./network.sh up

没有报错就表示安装成功并且测试案例运行成功，后续可以考虑定义通道以及部署链码。