ensody/avahi

Avahi Docker镜像

概述

该镜像是一个简单的Avahi Docker镜像，由https://github.com/ensody/avahi%E7%BB%B4%E6%8A%A4%E5%92%8C%E5%8F%91%E5%B8%83%E3%80%82CI%E7%B3%BB%E7%BB%9F%E6%AF%8F%E6%97%A5%E5%A4%9A%E6%AC%A1%E8%87%AA%E5%8A%A8%E6%A3%80%E6%9F%A5%E6%9B%B4%E6%96%B0%EF%BC%88%E5%A6%82%E5%AE%89%E5%85%A8%E4%BF%AE%E5%A4%8D%EF%BC%89%EF%BC%8C%E4%BB%85%E5%9C%A8%E5%BF%85%E8%A6%81%E6%97%B6%E5%8F%91%E5%B8%83%E6%96%B0%E9%95%9C%E5%83%8F%EF%BC%8C%E5%9B%A0%E6%AD%A4%E5%8F%AF%E4%B8%8Epodman-auto-update%E6%88%96Watchtower%E9%85%8D%E5%90%88%E4%BD%BF%E7%94%A8%E4%BB%A5%E5%AE%9E%E7%8E%B0%E8%87%AA%E5%8A%A8%E6%9B%B4%E6%96%B0%E3%80%82

核心功能与特性

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

使用场景

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

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

使用方法与配置说明

默认配置

镜像包含https://github.com/ensody/avahi/blob/main/avahi-daemon.conf%EF%BC%8C%E5%8F%AF%E7%9B%B4%E6%8E%A5%E4%BD%BF%E7%94%A8%E3%80%82

卷挂载

• 服务定义：通常只需将一个或多个服务定义文件挂载到/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备份服务。