hardillb/nginx-proxy-avahi-helper

nginx-proxy-avahi-helper

镜像概述

nginx-proxy-avahi-helper是一个Docker容器，用于为https://github.com/nginx-proxy/nginx-proxy%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86%E5%B7%A5%E5%85%B7%E6%89%80%E7%AE%A1%E7%90%86%E7%9A%84%E8%99%9A%E6%8B%9F%E4%B8%BB%E6%9C%BA%E7%94%9F%E6%88%90mDNS CNAME记录。它通过监控Docker容器的VIRTUAL_HOST环境变量，自动配置本地网络中的多播DNS（mDNS）条目，实现通过主机名在本地网络中访问被代理的服务。

核心功能与特性

• 自动mDNS记录生成：监控Docker容器的VIRTUAL_HOST环境变量，为每个虚拟主机创建对应的mDNS CNAME记录
• 跨架构支持：提供AMD64和ARM64两种架构的镜像构建
• Docker集成：通过挂载Docker socket实现对容器状态的实时监控
• Avahi集成：与主机的Avahi守护进程通信，通过d-bus协议管理mDNS记录

使用场景

适用于使用jwilder/nginx-proxy作为反向代理的本地网络环境，例如：

• 家庭服务器或NAS系统中运行多服务时的本地网络访问
• 开发环境中需要通过域名访问多个容器化服务
• 局域网内无需手动配置DNS即可通过主机名访问服务的场景

安装方法

拉取镜像：

bash
docker pull hardillb/nginx-proxy-avahi-helper

使用方法

必要卷挂载

运行容器时需要挂载以下两个卷：

1. Docker Socket卷：

   -v /var/run/docker.sock:/tmp/docker.sock
   

   用于监控Docker容器事件和获取VIRTUAL_HOST环境变量

2. DBus Socket卷：

   -v /run/dbus/system_bus_socket:/run/dbus/system_bus_socket
   

   用于与主机的Avahi守护进程通信

基本运行命令

bash
docker run -d \
  -v /var/run/docker.sock:/tmp/docker.sock \
  -v /run/dbus/system_bus_socket:/run/dbus/system_bus_socket \
  hardillb/nginx-proxy-avahi-helper

AppArmor配置

如果系统安装了AppArmor，可能会出现无法发送d-bus消息的错误。临时解决方法是添加--privileged参数：

bash
docker run -d --privileged \
  -v /var/run/docker.sock:/tmp/docker.sock \
  -v /run/dbus/system_bus_socket:/run/dbus/system_bus_socket \
  hardillb/nginx-proxy-avahi-helper

注：这是临时解决方案，后续将提供专用的AppArmor策略配置。

问题反馈

如遇到使用问题，请通过GitHub Issues反馈：
https://github.com/hardillb/nginx-proxy-avahi-helper/issues