Docker容器化Node.js应用无法连接Hyperledger Fabric问题

故障和Node.js服务本身的端口配置、Hyperledger Fabric网络运行状态无关，核心是Docker容器的网络隔离机制导致域名解析指向错误。
你connection.json中配置的Peer、CA节点地址使用了127-0-0-1.nip.io后缀的域名，这类域名会被公共DNS服务解析到127.0.0.1回环地址：

• 本地裸机运行Node.js服务时，127.0.0.1直接指向当前宿主机，IBM区块链扩展部署在宿主机8080端口的各类Fabric节点可以被正常访问，因此所有接口请求正常
• Node.js服务运行在Docker容器内时，容器内部的127.0.0.1指向容器自身的网络栈，和宿主机网络隔离，根本访问不到宿主机上跑的Fabric节点，最终触发gRPC连接超时错误。

任选一种方案调整即可修复：

方案1：容器启动时直接配置host映射（无需修改原有项目配置，成本最低） #

启动Node.js容器时追加--add-host参数，强制将Fabric相关域名指向宿主机地址，避免域名解析到容器内部回环地址。

• Windows/Mac环境使用Docker Desktop时，直接用Docker内置的host-gateway别名指向宿主机：

docker run -d -p 8089:8089 \
  --add-host=org1peer-api.127-0-0-1.nip.io:host-gateway \
  --add-host=org1ca-api.127-0-0-1.nip.io:host-gateway \
  你构建的Node.js镜像名

• Linux环境部署Docker时，先执行ip a show docker0查看docker网桥的IP（默认为172.17.0.1），将上述命令中的host-gateway替换为查询到的网桥IP即可。
  启动后可以进入容器执行ping org1peer-api.127-0-0-1.nip.io，确认返回IP为宿主机地址后再测试接口连通性。

方案2：修改connection.json中的节点地址 #

如果不想每次启动容器都追加参数，可以直接修改连接配置文件：

1. 先查询宿主机的物理网卡局域网IP（比如192.168.1.20）
2. 将配置文件中所有127-0-0-1.nip.io的域名替换为{你的宿主机IP用横杠分隔}.nip.io格式，比如宿主机IP是192.168.1.20，就替换成192-168-1-20.nip.io
3. 要同步修改certificateAuthorities下的url、peers下的url、peers配置块中grpcOptions下的两个域名参数，否则会触发gRPC SSL域名不匹配错误。
   这类nip.io域名会自动解析到对应IP，不需要额外配置hosts。

• Dockerfile中的EXPOSE 8089仅做端口声明，没有实际的端口映射作用，启动容器时必须加-p 8089:8089参数，才能在宿主机上访问到容器内的Node.js服务
• 可以在宿主机执行netstat -tulpn | grep 8080检查Fabric节点的监听地址，如果显示绑定在127.0.0.1:8080，需要在IBM区块链扩展的设置中将节点监听地址改为0.0.0.0，否则容器即使解析到宿主机IP也无法连通节点
• 容器内Node.js服务监听的地址不要绑定127.0.0.1，要绑定0.0.0.0，否则容器内部的端口映射不生效，外部请求进不来。

内容的提问来源于stack exchange，提问作者Carlos Daniel Ospina Salazar