Docker启动时自动配置pgAdmin4连接PostgreSQL容器的方案问询

一、纠正错误配置理解 #

PGADMIN_LISTEN_ADDRESS 是PGAdmin自身服务的监听地址（默认值为0.0.0.0，允许所有IP访问），不是用来指定PostgreSQL连接地址的，你之前的配置用错了参数，这才导致连接报错。

二、确保容器间能正常通信 #

方式1：使用Docker自定义网络（推荐） #

创建一个自定义网络，让PostgreSQL和PGAdmin容器都加入该网络，容器间可直接通过容器名通信：

docker network create pg-network

启动PostgreSQL容器时加入该网络：

docker run --name postgres-db --network pg-network -d your-postgres-image

启动PGAdmin容器时也加入该网络：

docker run --name pgadmin --network pg-network -p 5050:80 -d your-pgadmin-image

此时PGAdmin连接PostgreSQL的主机地址可直接填写postgres-db（容器名）。

方式2：使用host.docker.internal（仅本地开发） #

本地开发环境下，host.docker.internal可直接映射到宿主机IP，只要PostgreSQL容器的5432端口已映射到宿主机，就能用这个地址连接，但生产环境不建议使用。

三、实现PGAdmin自动添加服务器 #

PGAdmin支持通过环境变量或预置配置文件自动添加服务器，以下是两种实现方式：

方式1：通过环境变量配置（适合简单场景） #

修改PGAdmin的Dockerfile，添加预置服务器的环境变量：

# syntax=docker/dockerfile:1
FROM dpage/pgadmin4:latest

ENV PGADMIN_DEFAULT_EMAIL=user@domain.com
ENV PGADMIN_DEFAULT_PASSWORD=somepassword
# 预置服务器配置，格式对应：服务器名、主机地址、端口、维护数据库、用户名、密码
ENV PGADMIN_SERVER_JSON='[{"Name": "container-postgres", "Group": "Servers", "Port": 5432, "Username": "postgres", "Password": "somepassword", "Host": "postgres-db", "SSLMode": "prefer", "MaintenanceDB": "postgres"}]'

EXPOSE 80

CMD ["dpage/pgadmin4"]

若使用host.docker.internal，将Host的值替换为host.docker.internal即可。

方式2：通过挂载配置文件（适合复杂场景） #

创建servers.json配置文件，内容如下：

{
  "Servers": {
    "1": {
      "Name": "container-postgres",
      "Group": "Servers",
      "Host": "postgres-db",
      "Port": 5432,
      "MaintenanceDB": "postgres",
      "Username": "postgres",
      "Password": "somepassword",
      "SSLMode": "prefer",
      "Comment": "Auto-configured PostgreSQL server"
    }
  }
}

修改PGAdmin的Dockerfile，添加COPY指令将配置文件复制到容器指定路径：

# syntax=docker/dockerfile:1
FROM dpage/pgadmin4:latest

ENV PGADMIN_DEFAULT_EMAIL=user@domain.com
ENV PGADMIN_DEFAULT_PASSWORD=somepassword

# 复制预置服务器配置文件到容器默认读取路径
COPY ./servers.json /pgadmin4/servers.json

EXPOSE 80

CMD ["dpage/pgadmin4"]

容器内/pgadmin4/servers.json是PGAdmin默认读取预置服务器配置的路径，启动时会自动加载该文件的内容。

四、验证效果 #

启动两个容器后，访问localhost:5050，用设置的邮箱和密码登录PGAdmin，就能直接看到已添加好的container-postgres服务器，点击即可连接到somedb数据库。

补充说明 #

• 你之前尝试的PGADMIN_CONFIG_CONFIG_DATABASE_URI是用来指定PGAdmin自身的配置数据库（默认是SQLite），不是用来连接外部PostgreSQL的，配置该参数不符合需求，且Dockerfile中ENV的值不需要额外加单引号，这也是你出现语法错误的原因。
• 确保PostgreSQL容器的密码、数据库名与PGAdmin配置中的信息完全一致。

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