Hyperledger Fabric测试网络执行sudo ./network.sh up命令失败求助

错误原因 #

执行sudo ./network.sh up时尝试拉取hyperledger/fabric-peer:latest镜像失败，Hyperledger Fabric官方已废弃latest标签的镜像，必须指定具体版本号才能拉取。

修复步骤 #

• 确认版本匹配
  进入test-network目录，查看.env文件中的版本配置：

  cat .env
  

  找到FABRIC_VERSION（如2.5.5）和FABRIC_CA_VERSION（如1.5.7）这两个字段的具体值。

• 拉取对应版本的镜像
  执行以下命令拉取匹配版本的必要镜像，把命令中的版本号替换成你从.env里查到的内容：

  sudo docker pull hyperledger/fabric-peer:2.5.5
  sudo docker pull hyperledger/fabric-orderer:2.5.5
  sudo docker pull hyperledger/fabric-tools:2.5.5
  sudo docker pull hyperledger/fabric-ca:1.5.7
  

  也可以使用Hyperledger官方提供的install-fabric.sh脚本一键拉取对应版本的镜像，执行时指定版本参数即可。

• 清理残留环境后重启
  先清理之前的错误容器和冗余配置：

  sudo ./network.sh down
  sudo docker system prune -f
  

  然后重新启动测试网络，建议不要用sudo，如果遇到权限问题，把当前用户加入docker组：

  sudo usermod -aG docker $USER
  

  注销后重新登录，再执行：

  ./network.sh up
  

• 国内环境优化
  如果是国内机器，镜像拉取慢或失败，可配置Docker镜像加速：

  1. 编辑/etc/docker/daemon.json文件，添加镜像源（比如阿里云镜像加速地址）：

     {
       "registry-mirrors": ["https://你的镜像加速地址.mirror.aliyuncs.com"]
     }
     

  2. 重启Docker服务：

     sudo systemctl daemon-reload
     sudo systemctl restart docker
     

内容的提问来源于stack exchange，提问作者salil-cmd