elestio/pgadmin

PgAdmin（由Elestio验证和打包）

镜像概述和主要用途

PgAdmin 是一个社区驱动的开源项目，用于管理PostgreSQL数据库的Web界面工具，采用Python、React及Flask框架开发。该工具允许用户通过图形化界面执行数据库创建、查询执行、用户管理、备份恢复等操作，依赖全球开发者贡献进行功能迭代和问题修复。

Elestio提供的PgAdmin镜像经过验证和打包，适用于需要可靠PostgreSQL管理工具的场景。若需自动化备份、带SSL终止的反向代理、防火墙、系统与软件自动更新，以及专业团队支持（确保服务安全稳定运行），可选择在Elestio平台部署全托管版本。

核心功能和特性

PgAdmin核心功能

• 图形化Web界面，支持PostgreSQL数据库的全面管理（包括表、视图、索引、存储过程等）
• SQL查询编辑器，支持语法高亮、自动补全和执行计划分析
• 数据库备份与恢复工具，支持自定义备份策略
• 用户与权限管理，细粒度控制数据库访问权限
• 多服务器连接管理，可同时配置多个PostgreSQL实例

Elestio镜像优势

• 同步更新：与官方源码保持同步，通过自动化流程快速发布新版本
• 及时修复：提供最新的 bug 修复和功能更新，确保稳定性
• 质量控制：Elestio团队执行严格的质量检查，保障镜像符合高标准

使用场景和适用范围

• 开发环境：开发人员管理本地或测试环境的PostgreSQL数据库
• 生产环境：数据库管理员（DBA）监控和维护生产PostgreSQL实例
• 团队协作：多用户共享数据库管理权限，支持协作运维
• 自动化部署：结合Docker Compose或Kubernetes实现标准化部署

适用于需要直观管理PostgreSQL的个人开发者、开发团队及企业级数据库运维场景。

使用方法和配置说明

通过Git克隆部署

步骤1：克隆仓库

bash
git clone https://github.com/elestio-examples/pgadmin.git

步骤2：配置环境变量

复制测试环境的.env文件到项目根目录：

bash
cp ./tests/.env ./.env

编辑.env文件，替换为自定义值（如密码、版本标签等）。

步骤3：创建数据目录并设置权限

bash
mkdir -p ./data ./pgadmin
chown -R 1001:1001 ./data ./pgadmin

步骤4：启动服务

bash
docker-compose up -d

服务启动后，通过 http://your-domain:8080 访问Web界面。

Docker Compose配置示例

以下是docker-compose.yml配置示例，包含PgAdmin和PostgreSQL服务：

yaml
version: '3'
services:
  postgres:
    image: postgres:${SOFTWARE_VERSION_TAG}
    restart: always
    environment:
      POSTGRES_DB: postgres
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: ${SOFTWARE_PASSWORD}
      PGDATA: /var/lib/postgresql/data
    volumes:
      - ./data:/var/lib/postgresql/data
    ports:
      - '172.17.0.1:5432:5432'

  pgadmin4:
    image: elestio/pgadmin:${SOFTWARE_VERSION_TAG}
    restart: always
    environment:
      PGADMIN_DEFAULT_EMAIL: ${ADMIN_EMAIL}
      PGADMIN_DEFAULT_PASSWORD: ${ADMIN_PASSWORD}
      PGADMIN_LISTEN_PORT: 8080
    ports:
      - "172.17.0.1:8080:8080"
    volumes:
      - ./servers.json:/pgadmin4/servers.json

环境变量说明

维护

日志查看

通过以下命令查看容器日志：

bash
docker-compose logs -f

停止服务：

bash
docker-compose down

备份与恢复

基于Docker Compose的目录挂载特性，备份和恢复操作可通过文件系统实现：

创建备份

进入docker-compose.yml所在目录，执行以下命令创建压缩备份：

bash
zip -r pgadmin_backup.zip .

恢复备份

将备份文件解压到原始目录：

bash
unzip pgadmin_backup.zip -d /path/to/original/folder

重启服务

恢复后启动服务：

bash
docker-compose up -d

相关链接

• https://github.com/pgadmin-org/pgadmin4/
• PgAdmin官方文档
• https://github.com/elestio-examples/pgadmin