Python zeroconf 的 Python 实现

zeroconf库是python中实现zeroconf/mdns的事实标准，纯python、跨平台、持续维护；安装用pip install zeroconf，注意名称区分；windows报错多因绑定问题，macos/linux可能ipv6多播被禁；servicebrowser需保持主线程存活；serviceinfo注册须满足类型、名称、端口三重约束；服务发现慢可关coalesce或调低ttl；跨子网需网络设备支持mdns中继。

zeroconf 在 Python 里用 zeroconf 库最靠谱

Python 官方标准库不带 zeroconf 实现，zeroconf（原 python-zeroconf）是事实标准。它纯 Python 实现、跨平台、支持 IPv4/IPv6 双栈，且持续维护——别碰那些年久失修的 fork 或自制轮子。

安装直接：

pip install zeroconf

注意不是 pyzeroconf 或 zeroconf-py，后者要么已废弃，要么是镜像名混淆项。

• Windows 上若报 OSError: [WinError 10049]，大概率是没显式绑定到 0.0.0.0 或未启用多播接口，不是库本身问题
• macOS 12+ 和某些 Linux 发行版默认禁用 IPv6 多播，zeroconf 会自动降级到 IPv4，但服务发现延迟可能变高
• 不要用 asyncio 版本（aiodns 那类）混搭——zeroconf 当前主线仍是同步 + 线程模型，强行异步封装反而容易丢包

ServiceBrowser 启动后没回调？检查事件循环和线程生命周期

ServiceBrowser 是阻塞式监听器，靠后台线程跑，不是“注册即触发”。常见现象：脚本秒退、add_service 从不被调用、日志里没看到任何服务扫描记录。

根本原因通常是主线程结束太快，后台线程被强制终止。正确做法是保持主线程存活：

立即学习“Python免费学习笔记（深入）”；

• 加 input() 或 time.sleep(30) 临时调试（别用 while True: pass，CPU 白占）
• 生产环境建议用 threading.Event().wait() 或集成进你自己的主循环
• 如果用在 flask/fastapi 等 Web 框架里，务必确认 ServiceBrowser 实例是在应用启动时初始化，且生命周期长于请求周期
• 别在 jupyter Notebook 里反复 run 同一段代码——旧线程没清理干净会导致端口占用或重复回调

ServiceInfo 注册失败：名字、类型、端口三者必须同时合法

ServiceInfo 构造失败常静默吞错，但实际注册时抛 BadTypeInNameException 或根本不出现在其他设备的服务列表里。核心约束就三条：

• 服务类型必须以 ._tcp.local. 或 ._udp.local. 结尾，比如 '_myapp._tcp.local.' —— 少点、多点、写成 _tcp 都不行
• 服务名不能含下划线（_），但可以有短横线（-）和数字，例如 'my-printer-01' 合法，'my_printer' 会报错
• 端口必须是整数（int），传字符串 '8080' 会静默失败；若设为 0，系统自动分配，但后续需从 info.port 读回真实值
• IP 地址建议显式传 ['127.0.0.1'] 或 socket.gethostaddresses() 结果，别依赖 None 自动推导——尤其在 docker 或多网卡机器上极易出错

服务发现慢或漏服务？关掉 coalesce 和检查 TTL

默认情况下，zeroconf 会对同一服务的多次广播做合并（coalesce），提升效率但可能掩盖更新节奏。如果你改了服务元数据（比如版本号、TXT 记录）却迟迟不被客户端感知，大概率是这个机制在“帮忙”。

解决方法很简单，在创建 Zeroconf 实例时关掉：

zconf = Zeroconf(coalesce=False)

另外，TTL（生存时间）默认是 120 秒，意味着客户端缓存该记录最多两分钟。若你希望变更立刻生效，可在 ServiceInfo 初始化时显式压低：

info = ServiceInfo(..., properties={'version': '2.1'}, ttl=30)

• TTL 最小支持 10 秒，再低会被库自动拉回 10
• 降低 TTL 会增加网络广播流量，局域网设备多时慎用
• android/ios 原生 mDNS 客户端对 TTL 敏感度不一，iOS 通常更守规矩，Android 常缓存更久——别全指望 TTL 精确控制

真正麻烦的是跨子网场景：mDNS 默认不路由，交换机不开 IGMP Snooping 或不配 mDNS Repeater，设备再怎么调参数也互相看不见。这时候不是代码问题，是网络基建没跟上。