hausgold/valkey

基于mDNS的Valkey Docker镜像

!https://raw.githubusercontent.com/hausgold/docker-valkey/master/docs/assets/project.svg

https://github.com/hausgold/docker-valkey/actions/workflows/package.yml/badge.svg?branch=master](https://github.com/hausgold/docker-valkey/actions/workflows/package.yml)

该Docker镜像以https://hub.docker.com/r/valkey/valkey/%E9%95%9C%E5%83%8F%E4%B8%BA%E5%9F%BA%E7%A1%80%EF%BC%8C%E5%B9%B6%E5%9C%A8%E5%85%B6%E4%B8%8A%E9%9B%86%E6%88%90%E4%BA%86mDNS/ZeroConf%E6%A0%88%E3%80%82%E5%9B%A0%E6%AD%A4%EF%BC%8C%E6%82%A8%E5%8F%AF%E4%BB%A5%E4%BD%BF%E7%94%A8Valkey%E6%9C%8D%E5%8A%A1%EF%BC%8C%E4%B8%94%E9%BB%98%E8%AE%A4%E5%8F%AF%E9%80%9A%E8%BF%87*valkey.local*%EF%BC%88%E7%AB%AF%E5%8F%A36379%EF%BC%89%E8%AE%BF%E9%97%AE%E3%80%82

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

概述

本Docker镜像基于https://hub.docker.com/r/valkey/valkey/%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%EF%BC%8C%E9%A2%9D%E5%A4%96%E9%9B%86%E6%88%90%E4%BA%86mDNS/ZeroConf%E5%8D%8F%E8%AE%AE%E6%A0%88%E3%80%82%E8%BF%99%E4%BD%BF%E5%BE%97Valkey%E6%9C%8D%E5%8A%A1%E9%BB%98%E8%AE%A4%E5%8F%AF%E9%80%9A%E8%BF%87*mDNS*%EF%BC%88%E5%A4%9A%E6%92%ADDNS%EF%BC%89%E4%BB%A5%60valkey.local%60%E4%B8%BB%E6%9C%BA%E5%90%8D%EF%BC%88%E7%AB%AF%E5%8F%A36379%EF%BC%89%E8%AE%BF%E9%97%AE%EF%BC%8C%E6%97%A0%E9%9C%80%E6%89%8B%E5%8A%A8%E9%85%8D%E7%BD%AE%E7%BD%91%E7%BB%9C%E6%88%96DNS%EF%BC%8C%E7%AE%80%E5%8C%96%E4%BA%86%E6%9C%AC%E5%9C%B0%E5%BC%80%E5%8F%91%E5%92%8C%E6%B5%8B%E8%AF%95%E7%8E%AF%E5%A2%83%E4%B8%AD%E7%9A%84%E6%9C%8D%E5%8A%A1%E5%8F%91%E7%8E%B0%E6%B5%81%E7%A8%8B%E3%80%82

核心功能

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

要求

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

快速开始

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

bash
$ docker run --rm hausgold/valkey

docker-compose使用示例

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

yaml
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行如下：

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

配置不同的mDNS主机名

自定义主机名

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

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

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

配置多别名（CNAME）

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

bash
$ 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演示：https://github.com/Jack***/docker-mdns
• Archlinux配置指南：[***]
• Ubuntu/Debian配置指南：[***]