utopiaplanitia/dnslb

DNSLB

镜像概述

DNSLB是一款轻量级DNS负载均衡工具，作为Ingress和API Server Pod的Sidecar运行，核心目标是在节点 draining 或故障时动态管理Cloudflare DNS条目，保障服务的高可用性与DNS记录的准确性。目前仅支持Cloudflare作为DNS服务商。

核心功能

1. 动态DNS更新：监控本地端口状态，节点正常时添加自身IP到子域名，故障时移除；
2. 进程终止处理：进程终止时自动移除本地IP条目，并等待120秒DNS TTL生效；
3. 异常节点清理：通过CronJob定期检查所有DNS端点，移除不健康IP；
4. 网络配置：支持启用/禁用IPv4、IPv6网络协议；
5. Cloudflare集成：通过API Token或Key+Email方式连接Cloudflare服务。

使用场景

1. Kubernetes集群中Ingress控制器的高可用部署场景；
2. API Server节点故障时的DNS记录自动调整；
3. 需要动态更新DNS记录以应对节点变化的服务场景。

配置说明

系统变量

命令参数

部署示例

Docker Run命令

bash
docker run -d \
  -e CF_API_TOKEN="your_cloudflare_token" \
  -e CF_ZONE="example.com" \
  -e CF_SUBDOMAIN="api" \
  utopiaplanitia/dnslb \
  --port 80 \
  --port 443 \
  --ipv4 true \
  --ipv6 false

Docker Compose示例

yaml
version: "3"
services:
  dnslb:
    image: utopiaplanitia/dnslb
    environment:
      - CF_API_TOKEN=your_cloudflare_token
      - CF_ZONE=example.com
      - CF_SUBDOMAIN=api
    command: ["--port", "80", "--port", "443", "--ipv4", "true"]