### 麒麟虚拟机 Docker 容器 PostgreSQL 数据库连接错误解决方案 在麒麟虚拟机环境中尝试通过 `curl` 或其他方式访问 Docker 容器内的 PostgreSQL 数据库时，如果遇到类似于 `could not connect to server: Connection refused` 的错误，通常可能是由于以下几个方面的原因： #### 1. **网络配置问题** 如果目标 IP 地址不可达，则可能是因为 Docker 网络未正确设置或主机与容器之间的路由存在问题。可以通过重新配置 Docker 网络来解决问题[^1]。 ```bash # 停止并清理现有的 Docker 网络环境 systemctl stop docker ip link set dev docker0 down brctl delbr docker0 # 创建新的 Docker 网桥 brctl addbr docker0 ip addr add 172.16.10.0/24 dev docker0 ip link set dev docker0 up # 启动 Docker 服务 systemctl restart docker ``` #### 2. **PostgreSQL 容器未正常运行** 若 PostgreSQL 容器未启动或者监听端口不匹配，也会导致连接失败。需确认容器状态以及其绑定的端口号是否正确[^2]。 ```bash # 查看当前正在运行的所有容器及其映射端口 docker ps -a --format "{{.Names}}\t{{.Ports}}" # 如果 PostgreSQL 容器未运行则启动它 docker start postgres_container_name_or_id ``` 此外还需要验证容器内部的服务进程是否已开启，并且允许外部访问。 ```bash # 登录到指定的 PostgreSQL 容器中执行命令检查服务状况 docker exec -it postgres_container bash pg_isready && echo "Service is ready!" || echo "Service isn't running." ``` #### 3. **防火墙规则阻止了通信** 主机上的防火墙可能会拦截来自客户端的数据包请求。因此要确保开放必要的 TCP/IP 协议端口以便于两者之间建立有效的会话通道。 ```bash sudo iptables -A INPUT -p tcp --dport 5432 -j ACCEPT sudo service ufw reload # 对某些发行版适用 ``` #### 4. **pg_hba.conf 文件权限不足** 默认情况下，PostgreSQL 使用基于角色的身份认证机制控制谁能够登录数据库实例。所以应该调整 `/etc/postgresql/[version]/main/pg_hba.conf` 中的相关条目使得远程机器也能被接纳成为合法用户之一[^3]。 ```plaintext host all all 0.0.0.0/0 md5 ``` 随后记得重启整个数据库引擎使更改生效: ```bash docker restart postgres_container_name_or_id ``` 以上方法综合起来可以帮助排除大多数常见的连接障碍现象。当然具体情况还需具体分析，在实际操作过程中建议逐一排查直至找到根本原因为止。 ```python # 测试脚本用于验证能否成功连通服务器 import psycopg2 try: conn = psycopg2.connect( dbname="your_db", user="username", password="password", host="192.168.x.x", port=5432 ) except Exception as e: print(f"Error connecting to database:{e}") else: cursor = conn.cursor() cursor.execute('SELECT version();') record = cursor.fetchone() print("You are connected to - ", record,"\n") finally: if(conn): cursor.close() conn.close() ```