pgadmin4 镜像文档

1. 镜像概述

本镜像基于dpage/pgadmin4构建，是PostgreSQL数据库的官方图形化管理工具pgAdmin 4的Docker化版本。在保留原镜像全部功能的基础上，新增了容器健康检查机制，提升了容器部署场景下的服务可用性监控能力。

2. 核心功能与特性

2.1 基础功能

• 完整继承dpage/pgadmin4的全部功能，包括：
  • PostgreSQL数据库的图形化管理界面
  • 数据库查询编辑器与执行环境
  • 数据库对象（表、视图、索引等）的创建与管理
  • 用户权限管理与角色配置
  • 数据导入/导出与备份恢复工具

2.2 新增特性

• 容器健康检查：集成容器级健康检查功能，可实时监控pgadmin4服务运行状态，支持Docker原生的健康状态检测机制。

3. 使用场景与适用范围

• 适用于需要通过Docker容器快速部署pgadmin4的开发、测试或生产环境
• 适合对容器化服务健康状态有监控需求的场景，如自动化运维、服务自愈等
• 推荐用于个人开发者、小型团队或企业内部的PostgreSQL数据库管理工作流

4. 使用方法与配置说明

4.1 基本部署（docker run）

docker run -d \
  --name pgadmin4 \
  -p 80:80 \
  -e PGADMIN_DEFAULT_EMAIL="***" \
  -e PGADMIN_DEFAULT_PASSWORD="securepassword" \
  --health-cmd "curl -f http://localhost:80/login || exit 1" \
  --health-interval 30s \
  --health-timeout 10s \
  --health-retries 3 \
  privacy1st/pgadmin4

注：上述健康检查命令为示例，实际实现以镜像内置健康检查配置为准。

4.2 健康检查说明

• 健康检查作用：通过定期执行检查命令，判断pgadmin4服务是否正常响应，Docker会根据检查结果标记容器健康状态（healthy/unhealthy）
• 查看健康状态：

  docker inspect --format '{{.State.Health.Status}}' pgadmin4
  

• 健康状态应用：可结合Docker Compose的depends_on健康检查条件、容器编排平台的自愈策略等实现服务可用性保障

4.3 构建与源码

Dockerfile及构建脚本详见：[***]

5. 环境变量配置

继承自dpage/pgadmin4的核心环境变量（详细配置参见dpage/pgadmin4官方文档）：

• PGADMIN_DEFAULT_EMAIL：默认管理员邮箱（首次登录使用）
• PGADMIN_DEFAULT_PASSWORD：默认管理员密码
• PGADMIN_LISTEN_PORT：服务监听端口（默认80）
• PGADMIN_CONFIG_*：用于自定义pgadmin4配置的环境变量前缀