sierratecnologia/pgadmin4

pgAdmin 4 Docker镜像

镜像概述

这是一个用于运行pgAdmin4的简易Docker镜像，适用于非生产环境（以“桌面模式”运行，禁用身份认证）。从1.0版本起，镜像使用非特权用户运行，默认监听端口为5050（可通过端口映射访问80端口）。

核心功能

• 快速部署pgAdmin4，实现PostgreSQL数据库可视化管理
• 支持自定义网络连接PostgreSQL容器
• 提供持久化存储方案，避免升级容器丢失配置
• 允许在只读文件系统中运行
• 通过环境变量灵活配置运行参数

使用场景

• 非生产环境下的PostgreSQL数据库测试与日常管理
• 快速搭建临时数据库管理界面
• 学习或演示pgAdmin4的功能特性

配置说明

环境变量

• PG_ADMIN_DATA_DIR：数据存储目录（默认：/pgadmin/）
• PG_ADMIN_PORT：监听端口（默认：5050）
• DEBUG：启用调试模式（默认：False）

部署示例

快速启动

bash
docker run --rm -p 5050:5050 docker.xuanyuan.run/thajeztah/pgadmin4

启动后访问http://[你的Docker主机IP]:5050即可使用，按CTRL+C退出并移除容器。

连接PostgreSQL容器

bash
# 创建自定义网络
docker network create pg

# 启动PostgreSQL容器
docker run -d -e POSTGRES_PASSWORD=password --net pg --name docker.xuanyuan.run/postgres postgres

# 启动pgAdmin容器
docker run -d -p 5050:5050 --name pgadmin --net pg docker.xuanyuan.run/thajeztah/pgadmin4

访问界面后，添加数据库（主机名：postgres，密码：password）即可测试连接。

持久化存储

bash
docker run -d -p 5050:5050 -v /Users/me/pgadmin:/pgadmin docker.xuanyuan.run/thajeztah/pgadmin4

绑定本地目录/Users/me/pgadmin作为存储目录，保留配置数据。

只读文件系统运行

bash
docker run -d -p 5050:5050 --name pgadmin --read-only docker.xuanyuan.run/thajeztah/pgadmin4

更多pgAdmin4信息可参考：

• https://git.postgresql.org/gitweb/?p=pgadmin4.git;a=summary
• https://www.pgadmin.org