Hyperledger Fabric「构建首个网络」示例启动失败求助

我来帮你排查这个BYFN启动的问题，从报错信息来看有两个核心问题，咱们一步步解决：

首先看最关键的镜像拉取错误：

Pulling orderer.example.com (hyper-ledger/fabric-orderer:latest)...
ERROR: manifest for hyper-ledger/fabric-orderer:latest not found

这个错误是因为镜像名称写错了——正确的Hyperledger Fabric镜像前缀是hyperledger/fabric-，而不是hyper-ledger/fabric-（多了一个不必要的横杠）。出现这个问题通常是脚本或配置文件里的镜像引用有误。

解决步骤： #

1. 修正镜像名称配置

   • 打开byfn.sh脚本，全局搜索hyper-ledger这个字符串，把所有匹配到的内容替换成hyperledger。
   • 同时检查项目里的configtx.yaml、crypto-config.yaml等配置文件，确保所有镜像引用都是hyperledger/fabric-orderer、hyperledger/fabric-peer这类正确格式。

2. 清理残留的无效容器与镜像
   之前启动失败留下了无效的容器记录（比如报错里的No such container: cli），先彻底清理环境：

   sudo ./byfn.sh -m down
   # 清理可能残留的错误命名镜像
   docker rmi $(docker images | grep hyper-ledger | awk '{print $3}')
   

3. 拉取正确的Fabric镜像
   建议指定具体的Fabric版本（比如2.4.x，和你的BYFN脚本版本匹配），避免latest标签的兼容性问题。可以用官方脚本快速拉取：

   # 示例拉取2.4.9版本，替换为你需要的版本号
   curl -sSL https://raw.githubusercontent.com/hyperledger/fabric/main/scripts/install-fabric.sh | bash -s -- images 2.4.9
   

   或者手动拉取核心镜像：

   docker pull hyperledger/fabric-orderer:2.4.9
   docker pull hyperledger/fabric-peer:2.4.9
   docker pull hyperledger/fabric-cli:2.4.9
   docker pull hyperledger/fabric-ccenv:2.4.9
   

4. 重新启动BYFN网络
   完成上述操作后，重新执行启动命令：

   sudo ./byfn.sh -m up
   

额外检查项： #

如果是环境变量配置错误导致的镜像前缀异常，检查你的终端环境变量：

# 确保没有错误设置FABRIC_IMAGE_PREFIX
echo $FABRIC_IMAGE_PREFIX
# 正确值应该是hyperledger/fabric-，或者不设置这个变量（默认就是正确值）

内容的提问来源于stack exchange，提问作者Anil Nayak