5 分钟搭好 PostgreSQL 网页管理界面：pgweb 上手指南

5 分钟搭好 PostgreSQL 网页管理界面：pgweb 上手指南

【免费下载链接】pgwebCross-platform client for PostgreSQL databases项目地址: https://gitcode.com/gh_mirrors/pg/pgweb

如果你平时只靠命令行或图形客户端连数据库，换个环境就得重新装一遍工具，pgweb 正好解决这个麻烦。它是一个跑在浏览器里的 PostgreSQL Web 管理工具，用 Go 写成、单文件分发，没有额外依赖。把服务拉起来后，连接、看表、跑 SQL、导出结果这些日常操作都能直接在网上页面上完成，适合数据库新手快速熟悉操作，也适合开发者临时接一个库来排查问题。

🧭 从痛点说起：为什么需要一套网页版数据库管理工具

本地客户端有几个绕不开的问题：机器之间配置不通用，SSH 远程环境里装 GUI 工具更麻烦，团队里不同操作系统的人还要各自找安装方式。pgweb 的思路是把管理界面放在浏览器里——服务端只跑一个进程，谁有权限谁用浏览器打开，Windows、macOS、Linux 都一样。功能上它覆盖数据库管理的核心链路：连接配置、库内对象浏览、SQL 执行、结果导出，并且内置了查询历史和书签，不需要再配一套周边工具。

🚀 两条路径把服务跑起来

源码方式：先把仓库克隆下来，再执行编译，产物就是一个可执行文件：

git clone https://gitcode.com/gh_mirrors/pg/pgweb cd pgweb make

编译完直接运行即可，默认监听 8081 端口：

./pgweb

如果机器上已经有 Docker，一条命令就能拉起，不需要动本地 Go 环境：

docker run -p 8081:8081 sosedoff/pgweb

两种方式的差别只是部署形式，页面功能完全一致。运行后浏览器打开对应地址，就会看到连接配置页面。

🔌 第一次连接：填好主机信息或直接用书签

首次打开是一个表单：主机、端口、用户名、数据库名、SSL 模式，填完提交就建立连接。如果不想每次手输，可以把常用连接写进书签文件 data/bookmark.toml，格式很直白：

host = "localhost" port = 5432 user = "postgres" database = "mydatabase" ssl = "disable"

仓库里 data/ 目录下还有带 URL、SSH 隧道等变体的书签示例，照着改即可。需要连内网库时，pgweb 原生支持 SSH 隧道，不用自己先开端口转发。

📋 浏览库里的表和视图

连接成功后，左侧列出当前库的表、视图等对象，点选任意一张表，右侧就显示它的数据，可以直接翻页、按列排序，也能查看表结构和索引等元信息。对新人来说，这一屏基本回答了三件事：库里有哪些表、每张表有哪些字段、数据长什么样，比手写psql逐条\dt、\d快得多。

▶️ 执行 SQL 与导出查询结果

编辑器支持语法高亮，写完按Ctrl+Enter执行，结果表格展示在下方。需要把结果带出去时，可以选择导出为 CSV、JSON 或 XML 三种格式，直接下载，不用复制粘贴再处理。

几个日常好用的小设置：

• 多会话：启动时加--sessions参数（或设置PGWEB_SESSIONS=1），同一台服务器可以挂多个数据库连接，互不干扰。
• 查询历史：执行过的语句会自动留存，回头找那条 SQL 不用翻终端记录。
• 快捷键：Ctrl+Enter执行查询，Ctrl+F在结果中搜索，熟练后几乎不用碰鼠标。

📚 延伸阅读：示例代码与配置

除了工具本身，仓库里还放了一些可以直接参考的材料：

• config/examples/：用 Go 和 Ruby 写的连接后端示例，演示如何把 pgweb 接进自己的服务里。
• config/：systemd 服务、init.d、Upstart 等系统级配置模板，适合把 pgweb 部署成常驻服务。
• data/：书签示例与测试用 SQL 文件，看实际写法比看文档更快。

有功能建议或遇到问题，可以在项目的 Issue 区提交反馈。总结一下：pgweb 做的事情不多但都到位——一个可移植的 PostgreSQL 网页管理平台，五分钟跑起来，连接、浏览、查询、导出一条龙，对新手和开发者都是低门槛的选择。

【免费下载链接】pgwebCross-platform client for PostgreSQL databases项目地址: https://gitcode.com/gh_mirrors/pg/pgweb