PGWeb：网页客户端

使用 Docker 拉起 PGWEB，以便从浏览器进行小批量在线数据查询

PGWeb 客户端

PGWeb 是一款基于浏览器的 PostgreSQL 客户端。Pigsty 在 app/pgweb 中提供了一个小型 Docker Compose 模板，把容器的 8081 端口发布到主机的 8886 端口。

BASH 
cd ~/pigsty/app/pgweb
make up                    # docker compose up -d

当 cli.pigsty 门户项解析到 Infra 节点时，可打开 http://cli.pigsty，也可以直接访问 http://10.10.10.10:8886。公开演示地址为 http://cli.pigsty.cc。

PGWeb 会要求输入 PostgreSQL 连接 URL，例如：

TEXT 
postgres://dbuser_meta:DBUser.Meta@10.10.10.10:5432/meta?sslmode=disable
postgres://test:test@10.10.10.11:5432/test?sslmode=disable

这些字符串包含公开的演示默认密码并关闭 TLS。实际部署应使用最小权限账户、非默认密码和合适的 sslmode， 不要把未加额外访问控制的 PGWeb 容器或数据库凭据暴露给不可信网络。

PGWeb

快捷方式

模板附带的 Makefile 提供：

BASH 
make up         # 使用 docker compose 启动
make run        # 使用 docker run 启动
make view       # 打印本地访问入口与示例 URL
make log        # 跟踪容器日志
make info       # 使用 jq 检查容器
make stop       # 停止容器
make clean      # 停止并删除容器
make pull       # 拉取当前未固定版本的 sosedoff/pgweb 镜像
make rmi        # 删除本地镜像
make save       # 将镜像保存到 /tmp/docker/pgweb.tgz
make load       # 从 /tmp/docker/pgweb.tgz 加载镜像

当前模板使用未固定版本的 sosedoff/pgweb 镜像；若正式环境要求部署可复现，应在 app/pgweb/docker-compose.yml 中固定镜像版本或摘要。


最后修改 2026-08-14 · v4.5.0 prerelease (e5d3b4fa)