flungo/avahi

Avahi Docker镜像

镜像概述和主要用途

Avahi是实现mDNS/DNS-SD（多播DNS/服务发现）协议的守护进程，用于局域网内无配置的服务发现。本Docker镜像基于Alpine Linux构建，体积小巧且高度可配置，适用于在Docker环境中部署mDNS/DNS-SD服务的各类场景。

核心功能和特性

• 轻量级设计：基于Alpine Linux，显著减小镜像体积
• 全面配置支持：通过环境变量映射avahi-daemon.conf的所有配置选项
• 网络灵活性：支持连接多个Docker网络或物理网络，实现mDNS广播反射
• 协议兼容性：同时支持IPv4和IPv6，可按需启用或禁用相关功能

使用场景和适用范围

• 在多个Docker网络间反射mDNS广播，实现跨网络服务发现
• 连接物理网络（如WiFi VLAN），扩展mDNS服务覆盖范围
• 为Docker容器提供mDNS服务发现能力
• 在资源受限环境中部署轻量级Avahi服务

使用方法和配置说明

基本使用

启动基础Avahi容器的命令：

shell
docker run flungo/avahi

环境变量配置

所有avahi-daemon.conf配置选项均通过环境变量设置，命名格式为<SECTION>_<OPTION>（配置段名称大写，选项名称大写且将-替换为_）。可用配置选项如下表：

若需使用的配置选项缺失，请反馈或提交PR添加该功能。

使用示例

在网络间反射mDNS广播

要在两个Docker网络（示例中为net1和net2）间反射mDNS广播，需启用反射器（设置REFLECTOR_ENABLE_REFLECTOR=yes）：

shell
# 创建名为mdns-reflector的容器并连接到net1网络
docker run -d --name=mdns-reflector \
  --network net1 \
  -e REFLECTOR_ENABLE_REFLECTOR=yes \
  flungo/avahi
# 将容器连接到net2网络
docker network connect net2 mdns-reflector

连接到物理网络

如需连接物理网络（如WiFi VLAN），可使用macvlan驱动创建网络。以下示例创建名为physical的macvlan网络，连接到eno1接口（子网10.0.0.0/24，网关10.0.0.1）：

bash
docker network create --driver macvlan --subnet 10.0.0.0/24 --gateway 10.0.0.1 --opt parent=eno1 physical

连接VLAN时，在父接口后添加.VLAN ID（如--opt parent=eno1.123表示VLAN 123）。

为避免IP冲突，连接时指定可用IP（假设容器名为avahi，IP 10.0.0.10可用）：

bash
docker network connect physical avahi --ip 10.0.0.10