如何从K8s集群连接本地Docker容器数据库？解决回环IP配置报错

为什么不能用127.0.0.1？ #

• K8s集群里的每个Pod都有独立的网络命名空间，Pod内的127.0.0.1指向的是Pod自身，根本不是运行Docker数据库的宿主机。你配置Endpoints用回环IP，本质是让API Pod访问自己内部，完全碰不到目标数据库。
• K8s本身有安全限制，禁止Endpoints使用回环地址（127.0.0.1/8或::1/128），因为这种配置没有实际业务价值，还容易引发网络混淆，所以直接抛出了报错。

正确的配置方式 #

1. 替换为宿主机的真实IP #

找到运行Docker数据库的宿主机在局域网/集群网络中的真实IP（比如192.168.1.100，绝对不能用127.0.0.1），修改Endpoints配置：

apiVersion: v1
kind: Endpoints
metadata:
  name: postgres
subsets:
  - addresses:
    - ip: 192.168.1.100  # 替换成你的宿主机真实IP
    ports:
      - port: 5432

Service配置可以保持不变，API Pod通过postgres:5432就能访问到宿主机上的数据库。

2. 确保网络可达 #

• 确认PostgreSQL容器已经把5432端口映射到宿主机（启动容器时加-p 5432:5432参数）。
• 检查宿主机的防火墙/安全组，允许K8s集群内的Pod访问5432端口。
• 如果是Docker Desktop这类本地单节点集群，宿主机IP可以用host.docker.internal（不同环境可能有差异，测试后再用）。

备选方案（仅本地测试用） #

如果只是本地开发测试，可以给API Pod开启hostNetwork: true，让Pod直接使用宿主机的网络命名空间，这时Pod内的127.0.0.1就能指向宿主机。但这种方式会破坏Pod的网络隔离性，绝对不能用于生产环境：

# 在API Deployment的spec.template.spec里添加
hostNetwork: true

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