ensody/avahi Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Avahi Docker镜像

概述

该镜像是一个简单的Avahi Docker镜像，由ensody维护和发布。CI系统每日多次自动检查更新（如安全修复），仅在必要时发布新镜像，因此可与podman-auto-update或Watchtower配合使用以实现自动更新。

核心功能与特性

• 支持多播DNS（mDNS）和DNS服务发现（DNS-SD），实现局域网内服务自动发现
• 内置自动更新机制，CI每日检查并仅在有更新时发布新版本
• 提供默认配置文件，同时支持自定义配置以满足特定需求

使用场景

适用于需要在局域网环境中提供服务自动发现的场景，例如：

• Samba文件共享服务的自动发现
• Time Machine备份服务的网络发现
• 打印机、媒体服务器等设备的 Zeroconf 服务发布

使用方法与配置说明

默认配置

镜像包含默认的avahi-daemon.conf配置文件，可直接使用。

卷挂载

• 服务定义：通常只需将一个或多个服务定义文件挂载到/etc/avahi/services目录
• 自定义配置：如需高级定制，可挂载自定义的/etc/avahi/avahi-daemon.conf文件，或覆盖整个/etc/avahi目录

网络要求

由于mDNS需要在局域网内进行多播通信，运行容器时必须使用--net=host网络模式。

部署示例

以下示例创建一个支持Samba服务（含Time Machine）自动发现的Avahi容器：

sh
# 创建本地目录用于存储Avahi配置
AVAHI_ROOT=/var/data/samba-avahi
mkdir -p "$AVAHI_ROOT/services"

# 创建Samba服务定义文件
cat > "$AVAHI_ROOT/services/smb.service" <<EOF
<?xml version="1.0" standalone='no'?>
<!DOCTYPE service-group SYSTEM "avahi-service.dtd">
<service-group>
  <name replace-wildcards="yes">%h</name>
  <service>
    <type>_adisk._tcp</type>
    <txt-record>sys=waMa=0,adVF=0x100</txt-record>
    <txt-record>dk0=adVN=TimeMachine,adVF=0x82</txt-record>
  </service>
  <service>
    <type>_smb._tcp</type>
    <port>445</port>
  </service>
</service-group>
EOF

# 运行Avahi容器
docker run --restart always -d --name samba-avahi --net=host -v "$AVAHI_ROOT/services/:/etc/avahi/services/" ghcr.io/ensody/avahi:latest

此配置将使Linux和macOS设备能够自动发现Samba共享服务及Time Machine备份服务。