4、CoreDNS 配置详解：Corefile 语法、常用插件配置

CoreDNS 是 Kubernetes 集群默认的 DNS 组件，其核心配置文件 Corefile 采用类似 Caddyfile 的 DSL 语法。理解 Corefile 的结构与常用插件（kubernetes、forward、errors、log、health、ready）的配置方式，是精准定位 DNS 故障、优化集群 DNS 性能的基础。

4.1 Corefile 语法基础

Corefile 由 Server Block 和 Plugin Chain 组成。每个 Server Block 定义一组监听端口和域名匹配规则，内部按顺序串联多个插件。

# 基本语法结构
<zone> [<zone>...] {
    <plugin> [<args>...]
    <plugin> [<args>...]
    ...
}

4.2 常用插件配置详解

4.2.1 kubernetes 插件

核心插件，负责将 Kubernetes Service 和 Pod 的 DNS 记录转换为 DNS 响应。支持 Service（A/AAAA/SRV）、Pod（A/AAAA）、Cluster IP、Headless Service 等记录类型。

kubernetes [ZONES...] {
    fallthrough [ZONES...]
    ttl TTL
    namespaces NAMESPACES...
    pods POD-MODE
    endpoint_pod_names
    upstream [ADDRESS...]
    transfer { ... }
}

4.2.2 forward 插件

将无法在集群内解析的 DNS 查询转发到上游 DNS 服务器（如集群外部 DNS、云厂商 DNS）。支持多个上游、健康检查、轮询策略。

forward [ZONES...] ADDRESS... {
    except DOMAIN...
    force_tcp
    prefer_udp
    expire DURATION
    max_fails INTEGER
    health_check DURATION
    policy [random|round_robin|sequential|first]
}

4.2.3 errors 插件

捕获 CoreDNS 内部错误并输出到标准错误（stderr），默认输出格式为 <timestamp> [ERROR] <plugin>: <message>。支持自定义日志格式和输出目标。

errors {
    stacktrace
    log_file PATH
    log_level [debug|info|warn|error|panic]
}

4.2.4 log 插件

记录所有 DNS 查询请求和响应日志，支持自定义日志格式（Common Log Format / Combined Log Format）。

log [ZONES...] {
    format [common|combined|json|<template>]
    class [success|denial|error|all]
}

4.2.5 health 插件

提供 HTTP 健康检查端点（默认 :8080/health），用于 Kubernetes livenessProbe 和 readinessProbe。当 CoreDNS 进程正常运行时返回 200 OK。

health [ADDRESS] {
    lameduck DURATION
}

4.2.6 ready 插件

提供就绪检查端点（默认 :8181/ready），用于 Kubernetes readinessProbe。当 CoreDNS 完成插件初始化并可以正常处理 DNS 查询时返回 200 OK。

ready [ADDRESS]

4.3 完整 Corefile 示例与插件链分析

以下为 Kubernetes 集群默认的 CoreDNS ConfigMap 配置，结合了上述所有插件：

.:53 {
    errors
    health {
        lameduck 10s
    }
    ready
    kubernetes cluster.local in-addr.arpa ip6.arpa {
        pods verified
        fallthrough in-addr.arpa ip6.arpa
        ttl 30
    }
    prometheus :9153
    forward . /etc/resolv.conf {
        max_concurrent 1000
    }
    cache 30
    loop
    reload
    loadbalance
}

4.4 Corefile 配置故障排查清单