P2P 与分布式存储 / 系统课时

局域网如何用 mDNS 自动发现节点

局域网如何用 mDNS 自动发现节点

本节用 Go 的 go-libp2p 在局域网启动两个节点,启用 mDNS 自动发现并打印发现与连接事件。随后把节点分到不同 VLAN,观察多播发现失效的现象,明确它与实际拨号、跨网连接的边界。

学习目标

  • 解释 mDNS 查询、地址公告与 libp2p 拨号之间的关系。
  • 运行两个 Host,确认发现回调和连接成功是两件事。
  • 通过跨 VLAN 实验定位局域网发现的范围限制。

mDNS 发现了什么

mDNS 使用链路本地多播,而不是向固定引导节点请求邻居。libp2p 节点在本地网络发布并查询 _p2p._udp.local 服务;IPv4 通常使用 224.0.0.251:5353,响应中的 TXT 记录包含 dnsaddr= 前缀的 Multiaddr。解析后得到 peer.AddrInfo,其中有 Peer ID 和可尝试拨号的地址。

发现回调仅表示收到了邻居公告。之后仍需使用地址建立 TCP 等传输连接,并由 libp2p 完成安全握手。UDP 5353 是发现端口,不是本例 TCP 监听端口。路由器通常不转发这种链路本地多播;两个 VLAN 即使允许 IP 单播互通,也不代表可以自动发现。

mDNS 局域网发现与跨 VLAN 边界

准备可重复的实验环境

准备两台接入同一 Wi-Fi 或有线 VLAN 的电脑;也可以先在一台电脑的两个终端运行。使用 Go 1.24.6 或更高版本,并固定 go-libp2p v0.46.0,以匹配下文的 mdns.NewMdnsService 和 mdns.ServiceName API。

在 macOS 或 Linux 终端执行:

bash
mkdir mdns-lan
cd mdns-lan
go mod init example.com/mdns-lan
go get github.com/libp2p/go-libp2p@v0.46.0
go list -m github.com/libp2p/go-libp2p

预期输出(最后一条命令):

text
github.com/libp2p/go-libp2p v0.46.0

go get 的下载日志因缓存而不同。确认电脑连接了真实局域网,系统防火墙允许 mDNS 的 UDP 5353,以及节点随后使用的 TCP 入站连接;无需手工把 TCP 端口设成 5353。

实现发现回调并主动连接

在项目目录创建 main.go。示例让每个进程监听自动分配的 TCP 端口;发现邻居后打印其 Peer ID,并用 5 秒超时尝试连接。这样可以分别辨认“已经发现”和“已经连通”。

go
package main

import (
    "context"
    "fmt"
    "log"
    "os"
    "os/signal"
    "time"

    libp2p "github.com/libp2p/go-libp2p"
    "github.com/libp2p/go-libp2p/core/host"
    "github.com/libp2p/go-libp2p/core/peer"
    "github.com/libp2p/go-libp2p/p2p/discovery/mdns"
)

type discoveryLog struct{ h host.Host }

func (d *discoveryLog) HandlePeerFound(info peer.AddrInfo) {
    if info.ID == d.h.ID() {
        return
    }
    fmt.Printf("发现: %s 地址数=%d\n", info.ID, len(info.Addrs))

    // mDNS 只提供地址线索;连接成功需要实际拨号。
    ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
    defer cancel()
    if err := d.h.Connect(ctx, info); err != nil {
        log.Printf("连接失败: %v", err)
        return
    }
    fmt.Printf("已连接: %s\n", info.ID)
}

func main() {
    // 端口 0 由系统分配,便于在一台机器上运行两个进程。
    h, err := libp2p.New(libp2p.ListenAddrStrings("/ip4/0.0.0.0/tcp/0"))
    if err != nil {
        log.Fatal(err)
    }
    defer h.Close()
    fmt.Printf("本地 Peer ID: %s\n", h.ID())

    service := mdns.NewMdnsService(h, mdns.ServiceName, &discoveryLog{h: h})
    if err := service.Start(); err != nil {
        log.Fatal(err)
    }
    defer service.Close()

    // Ctrl+C 时先关闭 mDNS,再关闭 Host。
    ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt)
    defer stop()
    <-ctx.Done()
}

预期结果:程序启动后打印本地 Peer ID 并持续运行;收到邻居公告时打印发现事件,拨号成功后打印已连接事件。具体输出将在下面通过 go run . 验证。

这里 HandlePeerFound 是 mDNS 通知接口的实现;Start 同时承担本地服务发布与搜索。示例不持久化邻居表,真正的应用可在发现时按 Peer ID 去重,并记录最近发现时间及连接状态。

观察上线事件与跨网限制

  1. 在同一局域网的 A、B 上分别执行 go run .;若共用一台电脑,在两个终端分别执行。先记录各自打印的本地 Peer ID。
  2. 等待 mDNS 查询和响应。在 A 上应看到 B 的“发现”与“已连接”,B 也可能看到 A;事件先后和发现次数不保证固定。
  3. 停止两端进程,把 B 接入另一个 VLAN,保持跨 VLAN 的单播路由可用,但不要启用 mDNS 中继。重新运行两端,观察是否还出现新发现事件。

运行命令:

bash
go run .

同一局域网中,A 端的预期输出形态:

text
本地 Peer ID: <ID_A>
发现: <ID_B> 地址数=<N>
已连接: <ID_B>

<ID_A>、<ID_B> 和 <N> 是每次运行可能不同的实际值。跨 VLAN 且未配置多播反射或代理时,通常只能看到本地 Peer ID,收不到对方的发现回调;这不证明 TCP 路由不通。若实验仍能发现,检查网络设备是否启用了 mDNS reflector/gateway。

发现不到时按哪一层排查

  • 本地没有启动:检查 Start 是否报错、Host 是否拥有非回环监听地址;仅监听 127.0.0.1 不适合真实局域网发现。
  • 同 VLAN 仍无发现:检查主机防火墙的 UDP 5353、无线 AP 的客户端隔离,以及交换网络对多播的过滤;抓包时可在 Wireshark 使用显示过滤器 udp.port == 5353。
  • 有“发现”却“连接失败”:查看回调中地址数是否大于 0,排查对端 TCP 监听端口、入站防火墙和地址是否指向可达接口;不要把 UDP 5353 误当作拨号端口。

mDNS 适合自动找到同一链路上的邻居;跨 VLAN、跨公网或需要稳定重连的场景,应另外使用引导节点、DHT、Rendezvous 或明确的拨号地址。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

局域网如何用 mDNS 自动发现节点

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通