blakec/external-mdns

External-mDNS

概述

External-mDNS 基于 https://github.com/flix-tech/k8s-mdns/ 项目开发，受 https://github.com/kubernetes-sigs/external-dns 启发，通过多播 DNS（RFC 6762）在局域网中广播 Kubernetes Services 和 Ingresses 地址，使这些资源无需额外 DNS 服务器即可在本地网络中被发现。

核心功能与特性

• 资源发现：从 Kubernetes 集群获取 Services 和 Ingresses 资源列表，通过多播 DNS 向本地客户端提供记录，实现局域网内资源发现
• 命名空间控制：默认广播所有命名空间的暴露资源，可通过 -namespace 标志限制为单个命名空间
• DNS 记录格式：广播的 DNS 记录格式为 <hostname/service_name>.<namespace>.local；-default-namespace 指定的命名空间资源还会额外广播短格式 <hostname/service_name>.local
• 灵活配置：支持通过命令行参数或环境变量进行配置，如记录 TTL、命名空间等参数

使用场景

适用于需要在本地网络中无需部署独立 DNS 服务器即可访问 Kubernetes 服务和 Ingress 的场景，例如开发测试环境、小型局域网内的 K8s 集群部署等。

使用方法与配置说明

配置参数与环境变量

External-mDNS 支持通过命令行参数或环境变量进行配置，环境变量格式为 EXTERNAL_MDNS_<参数名大写>，例如：

• --namespace 对应环境变量 EXTERNAL_MDNS_NAMESPACE
• --record-ttl 对应环境变量 EXTERNAL_MDNS_RECORD_TTL

部署示例

不带 RBAC 的部署清单

yaml
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: external-mdns
spec:
  strategy:
    type: Recreate
  selector:
    matchLabels:
      app: external-mdns
  template:
    metadata:
      labels:
        app: external-mdns
    spec:
      hostNetwork: true
      containers:
      - name: external-mdns
        image: blakec/external-mdns:latest
        args:
        - -source=ingress
        - -source=service

带 RBAC 的部署清单

yaml
---
apiVersion: v1
kind: ServiceAccount
metadata:
  name: external-mdns
---
apiVersion: rbac.authorization.k8s.io/v1beta1
kind: ClusterRole
metadata:
 name: external-mdns
rules:
- apiGroups: [""]
  resources: ["services"]
  verbs: ["list", "watch"]
- apiGroups: ["extensions","networking.k8s.io"]
  resources: ["ingresses"]
  verbs: ["list", "watch"]
---
apiVersion: rbac.authorization.k8s.io/v1beta1
kind: ClusterRoleBinding
metadata:
 name: external-mdns-viewer
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: external-mdns
subjects:
- kind: ServiceAccount
  name: external-mdns
  namespace: default
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: external-mdns
spec:
  strategy:
    type: Recreate
  selector:
    matchLabels:
      app: external-mdns
  template:
    metadata:
      labels:
        app: external-mdns
    spec:
      hostNetwork: true
      serviceAccountName: external-mdns
      containers:
      - name: external-mdns
        image: blakec/external-mdns:latest
        args:
        - -source=ingress
        - -source=service

部署命令

使用以下命令部署 External-mDNS：

bash
kubectl apply --filename external-mdns.yaml

测试 DNS 记录解析

部署完成后，可通过以下命令在局域网内测试 DNS 记录是否解析正常：

BSD/macOS 系统

console
$ dns-sd -Q example.local a in
DATE: ---Sun 16 Aug 2020---
22:50:37.797  ...STARTING...
Timestamp     A/R    Flags if Name                          Type  Class   Rdata
22:50:37.959  Add        2  4 example.local.                Addr   IN     192.0.2.10

Linux 系统

console
$ avahi-resolve-address -4 --name example.local
example.local 192.0.2.10