向Hyperledger Fabric通道安装链码时遇Docker连接错误求助

你遇到的错误核心是peer节点无法访问宿主机的Docker套接字——虽然你配置了cli容器的挂载和环境变量，但链码安装的实际执行主体是peer节点容器，而非cli。以下是针对性的排查和解决步骤：

1. 检查peer节点容器的Docker套接字配置 #

链码安装时，peer节点需要调用宿主机Docker来构建链码镜像，因此必须确保每个peer节点的docker-compose配置都包含：

• 环境变量：CORE_VM_ENDPOINT=unix:///host/var/run/docker.sock
• 卷挂载：/var/run/:/host/var/run/

修改peer节点的docker-compose.yml后，重启peer容器：

docker-compose down -v
docker-compose up -d peer0.org1.thesis-network.com peer0.org2.thesis-network.com ... # 替换为你的所有peer节点名称

2. 验证宿主机Docker套接字的权限 #

宿主机上/var/run/docker.sock默认属于root:docker组，容器内的进程需要有读取权限：

• 宿主机执行：

  ls -l /var/run/docker.sock
  # 正常输出类似：srw-rw---- 1 root docker 0 ... /var/run/docker.sock
  

• 如果容器内的用户不是root，需将宿主机docker组的GID映射到容器：
  在peer和cli的docker-compose配置中添加用户组映射：

  environment:
    - DOCKER_GID=$(getent group docker | cut -d: -f3)
  user: "0:${DOCKER_GID}"
  

  或者临时调整宿主机套接字权限（仅限测试环境）：

  sudo chmod 666 /var/run/docker.sock
  

3. 确认容器内的套接字挂载是否生效 #

进入任意peer容器，检查是否能访问挂载的套接字：

docker exec -it peer0.org1.thesis-network.com bash
ls /host/var/run/docker.sock
# 若输出docker.sock则挂载正常，否则检查docker-compose的卷配置是否有误

4. 检查宿主机Docker服务状态 #

确保宿主机的Docker Daemon正在运行：

• Linux：

  systemctl status docker
  

• Windows/Mac：打开Docker Desktop，确认状态栏显示"Running"

5. 备选方案：使用TCP端点替代Unix套接字 #

如果Unix套接字问题仍无法解决，可在测试环境中使用TCP连接：

1. 宿主机修改Docker配置（/etc/docker/daemon.json）：

   {
     "hosts": ["unix:///var/run/docker.sock", "tcp://0.0.0.0:2375"]
   }
   

2. 重启Docker服务：

   sudo systemctl restart docker
   

3. 修改peer节点的环境变量：

   environment:
     - CORE_VM_ENDPOINT=tcp://<宿主机IP>:2375
   

4. 重启peer容器后重新尝试链码安装

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