yuxzhu/mdns-reflector

mDNS Reflector 镜像文档

镜像概述和主要用途

mDNS Reflector（mdns-reflector）是一款轻量级且高性能的多播DNS（mDNS）反射器，采用现代设计。其核心功能是在多个局域网（LAN）之间反射mDNS查询和响应，使用户能够将不受信任的IoT设备部署在独立的LAN中，同时确保这些设备仍可在其他LAN中被发现和访问。

核心功能和特性

• 轻量级设计：资源占用低，适合在嵌入式设备或资源受限环境中运行
• 高性能处理：高效转发mDNS流量，确保查询和响应的低延迟反射
• 现代架构：采用模块化设计，易于维护和功能扩展
• 跨LAN反射：支持在多个物理或逻辑局域网之间建立mDNS通信桥梁

使用场景和适用范围

• IoT设备隔离：将智能设备、传感器等IoT设备部署在独立LAN，同时允许主网络中的设备发现和控制这些IoT设备
• 多网段家庭网络：在包含主网络、访客网络、IoT专用网络的家庭环境中，实现跨网段的设备发现（如智能音箱、打印机等）
• 企业网络分区：在企业网络中隔离不同安全级别的设备网段，同时保持必要的跨网段服务发现能力

使用方法和配置说明

基本部署（Docker Run）

由于mDNS使用多播UDP协议，容器需使用主机网络模式以访问物理网络接口：

bash
docker run -d \
  --name docker.xuanyuan.run/mdns-reflector \
  --net=host \
  --restart unless-stopped \
  docker.xuanyuan.run/mdns-reflector \
  --interfaces eth0,eth1

参数说明：

• --net=host：必须使用主机网络模式以接收和发送多播流量
• --interfaces：指定需要反射mDNS流量的网络接口，多个接口用逗号分隔（如eth0,wlan0）

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  mdns-reflector:
    image: docker.xuanyuan.run/mdns-reflector
    network_mode: host
    command: --interfaces eth0,eth1  # 替换为实际需要的网络接口
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

高级配置选项

通过命令行参数可进行高级配置：

• --help：查看所有可用参数
• --debug：启用调试日志
• --ttl：设置反射数据包的TTL值（默认255）
• --filter：设置域名过滤规则，仅反射特定域名的mDNS流量

示例（带过滤功能）：

bash
docker run -d --name mdns-reflector --net=host docker.xuanyuan.run/mdns-reflector --interfaces eth0,eth1 --filter *.local