本文档旨在指导用户在云平台中完成 CoreDNS 的配置(域名解析规则添加/修改),提供两种配置方式:云平台可视化界面配置(推荐新手)、管理节点命令行配置(适合熟悉 Kubernetes 操作的用户)。
前置条件:
- 已获取云平台访问权限(界面配置需平台操作权限,命令行配置需管理节点登录权限及 Kubernetes 操作权限);
- 明确需配置的域名及对应解析 IP(如示例中的testing-environment-60.com 对应 10.6.122.60);
- 命令行配置需提前安装 kubectl 工具并配置好集群凭证。
配置方式总览
- 方式一:云平台可视化界面配置(操作简单、无需命令行,推荐优先使用);
- 方式二:管理节点命令行配置(适合批量配置或自动化场景)。
方式一:云平台可视化界面配置
步骤 1:登录云平台并进入 CoreDNS 配置页面

使用账号密码登录云平台后,通过左侧导航菜单找到「CoreDNS 配置」模块,点击进入配置列表页面,页面展示如下:
步骤 2:选择目标配置名称进入详情页

步骤 3:添加或修改域名解析规则

修改规则:找到需要修改的域名条目,点击「编辑」按钮,更新域名或对应 IP。
完成域名解析规则的添加/修改后,点击页面底部的「保存」按钮,系统会提示「保存成功」,随后点击「提交生效」按钮,使配置立即生效。提交界面展示如下:

注意:提交后配置会实时同步到 CoreDNS 服务,解析规则通常在 1-3 秒内生效。
方式二:管理节点命令行配置
步骤 1:登录云平台管理节点
通过 SSH 工具登录到云平台的 Kubernetes 管理节点(控制平面节点),登录成功后界面如下:

步骤 2:编辑 CoreDNS ConfigMap 配置
在管理节点终端中,执行以下命令编辑 Kubernetes 集群中 CoreDNS 的 ConfigMap 配置(CoreDNS 默认部署在 kube-system 命名空间):kubectl edit configmap coredns -n kube-system
执行命令后,系统会自动打开默认编辑器(通常为 vi/vim),展示 CoreDNS 的配置内容,编辑界面如下:

步骤 3:添加/修改 hosts 解析规则
在编辑器的配置内容中,找到 errors 配置段,在该段内查找 hosts 配置块:
- 若存在 hosts 配置块:在块内添加新的解析规则(格式:IP 域名);
- 若不存在 hosts 配置块:直接在 errors 段内新增 hosts 配置块。
示例配置(添加 10.6.122.60 testing-environment-60.com 解析):
errors
hosts {
10.6.122.60 testing-environment-60.com # 新增的解析规则
fallthrough # 必要参数,未匹配到当前规则时向下转发解析请求
}
kubernetes cluster.local in-addr.arpa ip6.arpa {
pods insecure
fallthrough in-addr.arpa ip6.arpa
}
prometheus :9153
forward . /etc/resolv.conf {
max_concurrent 1000
}步骤 4:保存配置并验证生效
- 保存配置:在
vi/vim编辑器中,按 Esc 键后输入:wq并回车,保存配置并退出编辑器;若放弃修改,输入:q!回车即可。 - 查看 CoreDNS ConfigMap 最新配置,确认规则已添加:
kubectl get configmap coredns -n kube-system -o yaml- 重启 CoreDNS Pod 使配置生效(部分 Kubernetes 版本支持热重载,可省略此步骤;若配置未生效,执行以下命令重启):
kubectl rollout restart deployment coredns -n kube-system- 测试解析:在集群内任意节点或 Pod 中,使用 nslookup 或 ping 测试域名解析是否正常:
nslookup testing-environment-60.com # 预期输出对应 IP 10.6.122.60作者:吴升斌 创建时间:2026-01-14 17:10
最后编辑:吴升斌 更新时间:2026-01-30 18:08
最后编辑:吴升斌 更新时间:2026-01-30 18:08