scyto/multicast-relay

multicast-relay Docker镜像（适用于Unifi Dream Machine）

镜像概述和主要用途

本Docker容器实现了https://github.com/alsmith/multicast-relay%E5%B7%A5%E5%85%B7%EF%BC%8C%E7%94%A8%E4%BA%8E%E5%9C%A8Unifi Dream Machine上提供mDNS（多播DNS）和SSDP（简单服务发现协议）中继功能。该镜像适用于任何多宿主主机，当前运行multicast-relay的v1.3版本。其核心用途是解决跨网络（如LAN和VLAN）环境下设备无法相互发现的问题，例如IoT设备、Sonos音箱、Chromecast等。

核心功能和特性

• 支持mDNS协议中继，实现跨网络设备名称解析
• 支持SSDP协议中继，实现设备服务发现
• 支持Sonos设备发现（UDP/6969端口广播中继）
• 可自定义需要中继的网络接口（适用于多VLAN环境）
• 提供丰富的命令行选项，可按需禁用特定协议（如mDNS、SSDP）
• 支持详细日志输出，便于调试和问题排查

使用场景和适用范围

• Unifi Dream Machine用户需要跨VLAN发现设备（如LAN与IoT VLAN间的设备通信）
• 多宿主主机需要在不同网络接口间中继多播流量
• 解决智能家居设备（如Sonos、Chromecast、智能灯泡）跨网络无法发现的问题
• 需要灵活控制多播协议中继的网络环境

详细使用方法和配置说明

环境变量配置

运行容器需定义以下环境变量：

注意：上述标记为"yes"的OPTS选项（如--verbose）默认未在容器中设置，需通过-e OPTS="选项"显式指定，或使用-e OPTS=""清空默认选项。

部署示例

基本运行（适用于LAN和VLAN50）

假设LAN使用br0（无VLAN/ VLAN1），IoT网络使用VLAN50：

bash
docker run --network=host --restart=always --name ssdp-relay scyto/multicast-relay

测试运行（查看控制台输出）

bash
docker run --rm -it --network=host -e OPTS="--verbose" -e INTERFACES="br0 br50" scyto/multicast-relay

多VLAN配置（仅中继SSDP）

在LAN、VLAN50和VLAN60之间中继SSDP但禁用mDNS（使用Unifi自带mDNS时）：

bash
docker run --network=host --name ssdp-relay --restart=always -e INTERFACES="br0 br50 br60" -e OPTS="--verbose --noMDNS" scyto/multicast-relay

管理VLAN配置（LAN为VLAN1）

当LAN作为管理VLAN（即VLAN1）时，指定多个VLAN接口：

bash
docker run --network=host --name ssdp-relay --restart=always -e INTERFACES="br10 br75 br90 [其他VLAN接口]" scyto/multicast-relay

防火墙注意事项

即使设备成功发现，部分设备（如Sonos）会从扬声器向控制客户端（如Sonos应用）建立单播连接。需确保防火墙允许此类连接：

• 允许从设备所在VLAN到客户端所在VLAN的连接
• 例如，在Photon 4虚拟机上允许多播流量：

  bash
  sudo iptables -I INPUT -m pkttype --pkt-type multicast -j ACCEPT
  

配置完成后需保存iptables规则。

注意：在Unifi OS系统中，需使用podman命令替代docker命令。