如何让Kind集群节点访问主机（localhost）上运行的服务？

问题场景 #

我们基于Kind集群开展本地开发，数据库、后端API、Web前端等服务通常运行在容器中，但为了开发便利，部分开发者会选择直接在主机上运行某个/某些服务。此时需要实现双向网络访问：

• 主机可以访问集群内的容器服务
• 集群内的容器服务可以访问主机上运行的服务

现有方案的局限性 #

我们曾在Mac的Docker Desktop环境下，通过定义ExternalName类型的Service实现集群访问主机服务：

apiVersion: v1
kind: Service
metadata:
  name: api
spec:
  type: ExternalName
  # 将Kubernetes的"api"服务指向主机上运行的API服务
  externalName: host.docker.internal
  ports:
    - protocol: TCP
      port: 80
      targetPort: 3030

但host.docker.internal是Docker Desktop专属的域名，无法在Kind的跨平台场景中通用；此前找到的相关方案仅提及环境变量，缺乏完整落地指导。

跨平台解决方案 #

1. 集群访问主机服务（通用方案） #

方法一：利用Kind节点网络特性映射主机IP

Kind集群的节点本身是Docker容器，默认连接到kind网桥。按以下步骤配置：

• 步骤1：获取主机在Kind网桥中的IP
  执行命令查看kind网桥的网关地址（即主机在该网桥的IP）：

  # Linux/macOS
  docker network inspect kind | grep -A5 -B5 "Gateway"
  # Windows（PowerShell）
  docker network inspect kind | Select-String -Pattern "Gateway"
  

  通常返回的网关地址类似172.18.0.1。

• 步骤2：定义ClusterIP类型Service指向主机IP
  创建Service将集群内流量转发到主机对应端口：

  apiVersion: v1
  kind: Service
  metadata:
    name: host-api
  spec:
    type: ClusterIP
    ports:
      - protocol: TCP
        port: 80          # 集群内访问的端口
        targetPort: 3030  # 主机上服务的端口
    externalIPs:
      - 172.18.0.1        # 替换为你获取到的主机在kind网桥的IP
  

  集群内Pod即可通过host-api:80访问主机上3030端口的服务。

方法二：自定义HostAlias实现统一域名访问

如果需要用固定域名访问主机服务，可在Pod配置中添加HostAliases：

apiVersion: v1
kind: Pod
metadata:
  name: demo-pod
spec:
  hostAliases:
  - ip: "172.18.0.1"  # 主机在kind网桥的IP
    hostnames:
    - "host.kind.internal"
  containers:
  - name: demo-container
    image: nginx

之后Pod内可通过host.kind.internal:3030访问主机服务。

2. 主机访问集群服务（通用方案） #

Kind默认提供两种便捷方式：

• 方式一：集群创建时配置端口映射
  通过集群配置文件暴露集群服务端口到主机：

  kind: Cluster
  apiVersion: kind.x-k8s.io/v1alpha4
  nodes:
  - role: control-plane
    extraPortMappings:
    - containerPort: 30000  # 集群内Service的NodePort
      hostPort: 30000       # 主机上的端口
      listenAddress: "0.0.0.0"
  

  主机通过localhost:30000即可访问对应集群服务。

• 方式二：kubectl临时端口转发
  临时访问集群服务时，直接执行端口转发命令：

  kubectl port-forward svc/your-service 8080:80
  

  主机通过localhost:8080访问集群内your-service的80端口。

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