在MacOS上运行节点时无法通过DHT连接对等节点求助

问题背景 #

我正在做一个基于libp2p的DHT学习项目，节点启动后可通过peer id被其他机器连接。现有三台设备：

• #Mach1：M1 MacBook Air（家庭网络）
• #Mach2、#Mach3：GCP虚拟机（公网环境）

现象 #

• 在#Mach2上启动程序并指定公网IP和端口，#Mach1和#Mach3能成功连接，所有节点通过DHT互通
• 在#Mach1上启动程序，#Mach2和#Mach3无法连接，报错：

failed to dial 12D3KooWLQaT8UhctNM9LJiSpL11ZcV5YgrZPwW8uj1SrZ2Lbuqt:
- [/ip4/<#Mach1_publicIP>/tcp/3000] dial tcp4 0.0.0.0:3000->171.76.86.245:3000: i/o timeout

已尝试：开启路由器端口转发、使用VPN，均无效。

排查与解决步骤 #

1. 验证端口转发与基础网络连通性 #

• 确认路由器端口转发规则：将外部TCP端口3000映射到Mac的内网IP:3000（可通过ifconfig或系统设置查看Mac内网IP）
• 用工具测试端口可达性：
  • 在Mac上执行nc -l 3000监听端口
  • 在GCP虚拟机上执行nc -zv <Mach1公网IP> 3000，如果返回连接失败，说明端口转发或防火墙存在问题
• 检查Mac系统防火墙：进入「系统设置」→「网络」→「防火墙」，确保允许你的项目程序接收传入连接，或临时关闭防火墙测试

2. 修正libp2p节点的地址宣告配置 #

• 确认启动程序时，是否显式指定了Mac的公网IP作为节点的宣告地址。如果仅绑定0.0.0.0，libp2p可能只会宣告内网IP，导致公网节点无法获取正确的连接地址
• 检查项目代码，确保节点初始化时配置了公网宣告地址，示例：

  node, err := libp2p.New(
    libp2p.ListenAddrStrings("/ip4/0.0.0.0/tcp/3000"),
    libp2p.AddrsFactory(func(addrs []ma.Multiaddr) []ma.Multiaddr {
      // 添加公网地址到宣告列表
      pubAddr, _ := ma.NewMultiaddr("/ip4/<你的公网IP>/tcp/3000")
      return append(addrs, pubAddr)
    }),
  )
  

3. 排查CGNAT限制 #

• 很多家庭网络处于运营商级NAT（CGNAT）下，此时路由器的WAN口IP是共享IP，端口转发无法生效。可通过公网IP查询工具确认：如果查询到的公网IP与路由器WAN口IP不一致，说明存在CGNAT
• 解决CGNAT的方案：
  • 使用端口穿透工具（如frp、ngrok）将Mac的3000端口映射到公网可访问的地址
  • 启用libp2p的自动NAT穿越功能（见下文）

4. 启用libp2p的NAT穿越与中继服务 #

• libp2p内置了AutoNAT、HolePunching（打洞）和Relay（中继）功能，可帮助NAT后的节点被公网节点发现：

  import (
    "github.com/libp2p/go-libp2p"
    autonat "github.com/libp2p/go-libp2p-autonat"
    "github.com/libp2p/go-libp2p/p2p/protocol/relay"
  )
  
  node, err := libp2p.New(
    libp2p.ListenAddrStrings("/ip4/0.0.0.0/tcp/3000"),
    libp2p.EnableAutoNAT(),       // 自动检测NAT类型
    libp2p.EnableHolePunching(),  // 启用UDP/TCP打洞
    libp2p.EnableRelay(),         // 启用中继，当打洞失败时通过中继节点连接
  )
  

5. 检查VPN的网络限制 #

• 如果使用VPN，确认VPN分配的IP是公网可访问的，且VPN客户端允许入站连接。部分VPN会默认阻止外部端口访问，需要在VPN设置中开启3000端口的入站权限

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