云环境下Ubuntu实例搭建私有链节点无法连接如何解决

核心排查步骤（按优先级排序） #

• 优先排查云环境网络拦截（本地环境无该层限制，是90%以上同类问题的根因）
  两台机器内网能ping通仅代表ICMP协议放行，Geth P2P通信依赖30303端口的TCP/UDP协议，需要两层检查：

  1. 云平台控制台安全组配置：检查两台实例的入方向规则，必须同时放通TCP、UDP 30303端口，源地址填写对端节点的内网IP，不要仅放行公网IP或127.0.0.1网段。
  2. 实例本机防火墙检查：执行sudo ufw status查看ufw规则，若防火墙为启用状态，执行以下命令放通对端访问权限：

     sudo ufw allow from <对端节点内网IP> to any port 30303 proto tcp
     sudo ufw allow from <对端节点内网IP> to any port 30303 proto udp
     

  端口放通后用nc工具验证真实连通性（不要用ping判断）：

  nc -zv <对端节点内网IP> 30303
  

  返回succeeded才代表端口真正可达，出现timeout/connection refused均为网络拦截问题，和Geth本身配置无关。

• 修正Geth启动参数错误
  你当前使用的启动命令中–http.corsdomain参数的前缀是长破折号，不是Geth要求的标准双短横--，会导致该参数不生效，先修正为--http.corsdomain "*"避免衍生异常。其余参数基础配置无问题，注意两台节点的--networkid参数值必须完全一致，可在节点启动后分别在控制台执行admin.nodeInfo.networkId核对返回值，避免参数拼写错误导致网络ID不匹配。

• 修正对等节点添加逻辑
  因为你配置了--nodiscover禁用自动节点发现，手动添加节点时需注意：

  1. 不要手动拼接enode串，直接在对端节点控制台执行admin.nodeInfo.enode复制完整的enode信息，避免公钥部分漏写、错写。
  2. enode串里的IP地址必须填写两台机器互通的内网IP，不要填127.0.0.1、公网IP或容器虚拟网卡IP，端口保持30303即可。
  3. 执行admin.addPeer()后不要重复调用，Geth有重连退避机制，重复添加会触发临时黑名单，等待10-30秒后执行admin.peers查看连接状态即可。

• 日志定向排查剩余问题
  你当前启动时加了--verbosity 10开了全量调试日志，若端口通、enode配置正确还是连不上，直接看启动日志的报错关键词对应处理：

  • 报invalid node id：enode串的公钥部分错误，重新复制对端的enode信息
  • 报network id mismatch：两台节点的networkid不一致，核对启动参数
  • 报connection reset：检查数据目录权限，执行ls -l ethdata确认运行用户对ethdata目录有完整读写权限，权限异常会导致握手阶段被重置

特殊场景排查 #

• 若两台云实例属于不同VPC/不同可用区，需要确认VPC之间已经配置对等连接，路由表已添加对端网段的转发规则，否则内网IP无法跨VPC通信。
• 测试阶段可临时去掉--nodiscover参数，加上--v5disc启用V5版本节点发现，观察节点是否能自动识别对端，排除手动添加enode的人为错误。

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