Docker默认网桥网络中PostgreSQL无法被pgAdmin连接问题排查

你犯了一个典型的场景混淆错误：你是在浏览器里操作pgAdmin发起的连接请求，这个请求的发起方是你的本地主机，而不是pgAdmin容器本身。

为什么你以为的「容器间连接」不生效 #

Docker默认bridge网络里的容器间可以用服务名/主机名通信，是指容器和容器内部的进程之间直接通信，不需要暴露端口。但你现在是通过浏览器访问pgAdmin（靠主机的端口映射5050:5050），此时连接数据库的请求是从你的本地浏览器（主机环境）发出去的，主机不在Docker的bridge网络里，自然无法解析mediacms-db这个Docker内部的主机名，所以会超时。

验证容器间确实能正常通信的方法 #

进入pgAdmin容器内部，用命令行测试连接：

docker exec -it mediacms-pgadmin-1 bash
# 若容器无psql，先安装（alpine系统）
apk add postgresql-client
# 用容器主机名连接数据库
psql -h mediacms-db -U mediacms -d mediacms

执行后肯定能成功连接，因为这是容器内部发起的请求，Docker的内置DNS会把mediacms-db解析成对应容器IP，且无需暴露端口。

解决你当前的需求（通过浏览器的pgAdmin连接数据库） #

有两种可行方案：

• 方案一：暴露PostgreSQL端口到主机
  在db服务的配置中添加端口映射：

  services:
    db:
      # 保留原有所有配置
      ports:
        - "5432:5432"
  

  修改后重启容器，在pgAdmin的连接配置里，将主机名改为你的主机IP或localhost，端口填5432，即可正常连接。
• 方案二：让pgAdmin的连接请求从容器内部发起
  若不想暴露PostgreSQL端口到主机，可预先在pgAdmin容器内配置连接（而非通过浏览器手动输入），但这种方式操作繁琐，日常使用推荐方案一。

关键概念澄清 #

Docker文档中「容器间无需暴露端口即可通信」的描述，特指容器与容器之间的内部通信场景，和「通过主机客户端访问容器服务」是完全不同的两类场景，后者必须通过端口映射将容器端口暴露给主机。

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