如何配置Kubernetes Pod将域名解析到宿主机回环地址？

问题根源 #

Kind集群的Pod运行在Docker容器内，Pod的127.0.0.1是容器自身的回环地址，和宿主机的回环地址不互通。你需要把localdev.companyName.com解析到宿主机在Docker网络中的IP（比如host.docker.internal，或者Docker默认网关172.17.0.1），而非Pod自身的回环。

可行解决方案 #

1. 给Pod配置hostAliases（单Pod生效） #

这是最直接的方式，在Pod的配置里直接添加域名与宿主机IP的映射，不需要修改集群DNS。用Terraform配置示例：

resource "kubernetes_pod" "your-app-pod" {
  metadata {
    name      = "your-app"
    namespace = "your-namespace"
  }

  spec {
    # 添加hostAliases映射
    host_aliases {
      ip = "host.docker.internal" # 或者直接写宿主机在Docker网络的IP，比如172.17.0.1
      hostnames = ["localdev.companyName.com"]
    }

    # 其他Pod配置（镜像、端口等）
    container {
      image = "your-app-image:latest"
      name  = "your-app-container"
      port {
        container_port = 8080
      }
    }
  }
}

配置后，该Pod内访问localdev.companyName.com会直接解析到指定的宿主机IP。

2. 修改CoreDNS配置（全集群生效） #

如果需要让集群内所有Pod都能正确解析这个域名，修改CoreDNS的ConfigMap，添加自定义解析规则：

1. 编辑CoreDNS的ConfigMap：

kubectl edit configmap coredns -n kube-system

2. 在配置的Corefile部分添加规则，二选一即可：

• 方式一：直接添加hosts映射

Corefile: |
  .:53 {
      # 原有配置保留
      errors
      health
      kubernetes cluster.local in-addr.arpa ip6.arpa {
        pods insecure
        fallthrough in-addr.arpa ip6.arpa
      }
      prometheus :9153
      forward . /etc/resolv.conf
      cache 30
      loop
      reload
      loadbalance
  }
  # 新增自定义域名解析
  localdev.companyName.com:53 {
      hosts {
          host.docker.internal localdev.companyName.com
          fallthrough
      }
  }

• 方式二：用rewrite规则将域名指向host.docker.internal

Corefile: |
  .:53 {
      # 新增rewrite规则放在最前面
      rewrite name localdev.companyName.com host.docker.internal
      # 原有配置保留
      errors
      health
      kubernetes cluster.local in-addr.arpa ip6.arpa {
        pods insecure
        fallthrough in-addr.arpa ip6.arpa
      }
      prometheus :9153
      forward . /etc/resolv.conf
      cache 30
      loop
      reload
      loadbalance
  }

3. 重启CoreDNS Pod让配置生效：

kubectl rollout restart deployment coredns -n kube-system

3. 修正ExternalName Service配置（配合DNS rewrite） #

你之前的ExternalName Service没生效，是因为Kubernetes的Service DNS默认是<service-name>.<namespace>.svc.cluster.local，Pod不会自动把localdev.companyName.com关联到你的Service。需要配合CoreDNS的rewrite规则：

1. 先修正Terraform的Service配置（名字更合理，避免重复）：

resource "kubernetes_service" "localdev-external" {
  metadata {
    name      = "localdev-service"
    namespace = "your-namespace"
  }

  spec {
    type          = "ExternalName"
    external_name = "host.docker.internal"
  }
}

2. 按照方案2的方式修改CoreDNS，添加rewrite规则，把localdev.companyName.com指向Service的DNS名：

rewrite name localdev.companyName.com localdev-service.your-namespace.svc.cluster.local

这样Pod访问localdev.companyName.com时，会先被CoreDNS重写为Service的域名，再解析到host.docker.internal。

内容的提问来源于stack exchange，提问作者Pouya Ataei