如何从Kubernetes集群（minikube）连接本地PostgreSQL数据库？

要让minikube集群内的Pod访问本地主机上的PostgreSQL，核心是解决minikube与本地主机的网络连通性，以及PostgreSQL的外部访问权限配置，具体步骤如下：

1. 获取minikube可访问的本地主机地址 #

minikube默认会在集群内部的hosts文件中添加一条host.minikube.internal记录，直接指向你的本地主机。可通过以下命令验证：

minikube ssh "cat /etc/hosts | grep host.minikube.internal"

输出示例：

192.168.49.1    host.minikube.internal

后续Pod内的数据库连接直接使用host.minikube.internal作为主机地址即可。

2. 配置PostgreSQL允许外部连接 #

本地默认安装的PostgreSQL通常仅监听本地回环地址（127.0.0.1），需修改配置开放外部访问：

修改监听地址 #

编辑PostgreSQL主配置文件（通常路径为/etc/postgresql/<版本>/main/postgresql.conf），找到listen_addresses参数并修改：

listen_addresses = '*'

该配置会让PostgreSQL监听所有可用网络接口。

添加访问权限规则 #

编辑同目录下的pg_hba.conf文件，添加允许minikube集群访问的规则：

# 允许minikube子网IP访问所有数据库，使用scram-sha-256认证
host    all             all             192.168.49.0/24        scram-sha-256

注：若不确定minikube子网，可通过minikube ip获取集群节点IP，取前三位加.0/24即可；测试环境可临时用0.0.0.0/0允许所有外部访问，但生产环境禁止此操作。

重启PostgreSQL服务 #

保存配置后重启服务使更改生效：

sudo systemctl restart postgresql

3. 开放本地防火墙的5432端口 #

本地防火墙默认会阻止外部对5432端口的访问，需允许minikube集群网络访问该端口：

• Ubuntu/Debian（使用ufw）：

sudo ufw allow from 192.168.49.0/24 to any port 5432

• CentOS/RHEL（使用firewalld）：

sudo firewall-cmd --add-rich-rule='rule family="ipv4" source address="192.168.49.0/24" port port="5432" protocol="tcp" accept' --permanent
sudo firewall-cmd --reload

4. 在Pod中配置数据库连接 #

在应用配置里，将数据库连接地址设为host.minikube.internal，端口保持默认5432，搭配你的PostgreSQL用户名、密码和数据库名。示例连接字符串：

postgresql://db_user:db_password@host.minikube.internal:5432/your_database

部署应用到minikube后，Pod即可正常访问本地PostgreSQL。

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