thajeztah/pgadmin4

pgAdmin4

这是一个用于在容器中运行pgAdmin4的简单Docker镜像。默认配置不适合生产环境（以“桌面模式”运行，因此禁用了认证）。

该镜像使用非特权用户，并使用5050端口而非80端口。若要通过80端口访问Web界面，可使用-p 80:5050映射端口。

核心功能

• 容器化运行pgAdmin4，快速部署数据库管理工具
• 支持自定义网络连接PostgreSQL容器
• 持久化存储配置数据，升级容器不丢失配置
• 可在只读文件系统中运行，提升安全性
• 通过环境变量灵活配置运行参数

使用场景

• 开发环境中快速部署pgAdmin4，管理本地或容器内的PostgreSQL数据库
• 本地测试PostgreSQL连接与数据操作
• 学习pgAdmin4工具的基本使用

配置说明

持久化数据

持久化数据存储在/pgadmin/卷中，包含：

• /pgadmin/config/pgadmin4.db：SQLite配置数据库
• /pgadmin/storage/：其他存储文件 可通过PG_ADMIN_DATA_DIR环境变量覆盖存储路径。

非特权用户

pgAdmin以非特权用户pgadmin（uid:gid为1000:50）运行，支持绑定本地目录作为持久化存储。

运行时环境变量

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

部署示例

快速开始

bash
$ docker run --rm -p 5050:5050 thajeztah/pgadmin4

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

实用示例（连接PostgreSQL）

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

# 启动PostgreSQL容器
$ docker run -d -e POSTGRES_PASSWORD=password --network=pg --name postgres postgres:9-alpine

# 启动pgAdmin容器
$ docker run -d -p 5050:5050 --name pgadmin --network=pg thajeztah/pgadmin4

访问http://[你的Docker主机]:5050，添加数据库（主机名postgres，密码password）测试连接。

持久化存储

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

只读文件系统运行

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

更多信息

• pgAdmin4开发文档：[***]
• 官方网站：[***]
• 问题反馈：https://github.com/thaJeztah/pgadmin4-docker