基于mDNS的Valkey Docker镜像

!mDNS enabled valkey/valkey

![Continuous Integration]([] ![Source Code]([] ![Docker Image]([***]

该Docker镜像以valkey/valkey镜像为基础，并在其上集成了mDNS/ZeroConf栈。因此，您可以使用Valkey服务，且默认可通过valkey.local（端口6379）访问。

• 要求
• 快速开始
• docker-compose使用示例
• 主机配置
• 配置不同的mDNS主机名
• 其他顶级域名
• 延伸阅读

概述

本Docker镜像基于valkey/valkey官方镜像构建，额外集成了mDNS/ZeroConf协议栈。这使得Valkey服务默认可通过mDNS（多播DNS）以valkey.local主机名（端口6379）访问，无需手动配置网络或DNS，简化了本地开发和测试环境中的服务发现流程。

核心功能

• 基于官方Valkey镜像，保留原生Valkey功能和端口（6379）
• 集成mDNS/ZeroConf，默认通过valkey.local访问服务
• 支持自定义mDNS主机名和多别名（CNAME）配置
• 可通过环境变量传递Valkey服务参数

要求

• 主机已启用Avahi守护进程（Avahi daemon）
• 主机已启用mDNS NSS（名称服务开关）查找

快速开始

运行以下命令即可启动Valkey服务，端口6379保持默认开放：

$ docker run --rm hausgold/valkey

docker-compose使用示例

以下是docker-compose配置示例，包含环境变量设置：

services:
  valkey:
    image: hausgold/valkey
    environment:
      # 注意需包含.local后缀
      MDNS_HOSTNAME: valkey.test.local
      # 可通过以下变量传递valkey-server参数（默认配置）
      VALKEY_ARGS: --databases 1000

主机配置

安装依赖与启用服务

1. 安装nss-mdns包
2. 启用并启动avahi-daemon.service服务

配置NSS查找

编辑/etc/nsswitch.conf文件，修改hosts行如下：

hosts: ... mdns4_minimal [NOTFOUND=return] resolve [!UNAVAIL=return] dns ...

配置不同的mDNS主机名

自定义主机名

通过环境变量MDNS_HOSTNAME可配置自定义mDNS主机名。示例：

$ docker run --rm -e MDNS_HOSTNAME=something.else.local hausgold/valkey

上述命令将使Valkey服务通过something.else.local访问。

配置多别名（CNAME）

通过环境变量MDNS_CNAMES可配置多个别名，使用逗号分隔多个域名。示例：

$ docker run --rm \
  -e MDNS_HOSTNAME=primary.local \
  -e MDNS_CNAMES=alias1.local,alias2.local \
  hausgold/valkey

此时服务可通过primary.local、alias1.local和alias2.local访问。

其他顶级域名

默认情况下，mDNS使用.local作为顶级域名。若需使用其他顶级域名，需额外配置主机Avahi服务以支持自定义TLD。

延伸阅读

• Docker/mDNS演示：[***]
• Archlinux配置指南：[***]
• Ubuntu/Debian配置指南：[***]