toxuin/mdns-tunneller

mDNS Tunneller

!docker pulls

⚠️ 警告：此工具可能对运行环境中的网络造成严重损害。仅在万不得已、已尝试所有其他选项后使用。建议先尝试avahi-reflector和mdns-repeater。

镜像概述和主要用途

mDNS Tunneller通过简单的HTTP创建1:1管道隧道，双向传输所有mDNS请求和响应，本质上合并两个独立的多播DNS域。支持连接多个客户端到服务器（但不建议），形成一个大型多播DNS域。

核心功能和特性

• 连接丢失时自动重连
• DNS查询基本防火墙 - 仅包含白名单服务信息的数据包会通过隧道传输
• 内置多播风暴预防 - 不中继已中继的数据包

使用场景和适用范围

适用于依赖mDNS但多播受限制的场景。mDNS（多播DNS）存在诸多限制，通常情况下avahi的反射器模式可满足多播包跨网络传输需求，但在复杂网络环境（如通过***、防火墙隔离的VLAN、IP-over-Fiber-Channel或IP-over-Avian-Carriers等）中，专为mDNS建立隧道更为便捷。

⚠️ 注意：mDNS通常包含大量设备在线状态（谁在家）和活动信息，使用此工具可能将私人信息暴露到非预期位置。虽内置基础防火墙，但目前功能简单，无法提供充分的个人数据保护。

配置文件

默认配置值存储在config/default.yml，不建议直接编辑此文件（会导致git树出现未提交更改）。应在config目录创建local.yml文件，覆盖需要修改的配置值。

使用环境变量配置

可使用环境变量覆盖config/default.yml中的所有配置参数。查看custom-environment-variables.yml文件获取所有环境变量名称。

数组参数需以YAML格式提供：

SENDERS_BLACKLIST='[192.168.1.69, 192.168.10.11]'

使用方法和部署示例

Docker部署

基本运行命令

shell
docker run -v /path/to/your_config_file.yml:/app/config/local.yml -p 42069:42069 toxuin/mdns-tunneller

参数说明

• -v /path/to/your_config_file.yml:/app/config/local.yml：挂载本地配置文件到容器内，覆盖默认配置
• -p 42069:42069：映射容器端口42069到主机，用于隧道通信

服务器配置

1. 在local.yml中设置监听接口（默认监听所有接口0.0.0.0）：

yaml
interface: 192.168.1.69

2. 启动服务器：

shell
npm run start

客户端配置

1. 在local.yml中设置服务器连接地址（否则将作为服务器启动）：

yaml
remote: 192.168.1.69

2. 启动客户端：

shell
npm run start

升级

在克隆的项目目录中执行git pull即可升级。

⚠️ 注意：mDNS Tunneller为测试版软件，不建议用于关键系统（除非僵尸末日等极端情况）。由于是测试版，不保证跨版本API/配置结构兼容性（很可能不兼容），更新前请阅读变更日志。