pgweb PostgreSQL 网页管理工具教程：三步拉起数据库浏览器

pgweb PostgreSQL 网页管理工具教程三步拉起数据库浏览器【免费下载链接】pgwebCross-platform client for PostgreSQL databases项目地址: https://gitcode.com/gh_mirrors/pg/pgwebpgweb 是一个用 Go 编写的轻量 PostgreSQL 网页数据库管理工具单个二进制、零依赖启动后就能在浏览器里浏览表结构和执行 SQL 查询。本文带你完成本地安装、启动验证和核心界面操作。它解决什么问题连接 PostgreSQL 数据库过去要么开 psql 命令行要么装一个功能庞杂的桌面客户端想把库的状态给同事看一眼就更麻烦了。pgweb 替代的正是这些操作一个二进制文件Mac、Linux、Windows 通吃支持多数据库会话并行、SSH 隧道直连远程库、查询结果导出 CSV/JSON/XML兼容 PostgreSQL 9.6。适合经常和 PostgreSQL 打交道的开发者以及想给团队快速搭一个浏览器入口的运维人员。 三步跑起来1. 确认环境准备一个可连的 PostgreSQL 9.6 实例即可。若选择源码编译需要本机装有 Gogo.mod 声明要求 Go 1.25用 Docker 或官方预编译二进制则无额外要求。2. 安装下面这段命令拉取源码并编译出可执行文件产物放在当前目录git clone https://gitcode.com/gh_mirrors/pg/pgweb cd pgweb make build不想编译也行项目自带 Dockerfile跑一次make docker make docker-run就能得到等效的服务。3. 启动并验证成功下面这条命令以默认数据库连接信息启动服务主机、用户、库名都可以按需替换./pgweb --host localhost --user myuser --db mydb成功的标志浏览器打开http://localhost:8081启动时 pgweb 会自动弹出浏览器看到一个白底连接表单填好账号点 Connect 就能进入数据库。️ 核心界面与操作第一屏连接数据库连接表单依次是 Host、Username、Password、Database、Port默认 5432和 SSL 模式。如果启动时加了--sessions参数左上角会出现 Bookmark 下拉框可以在多个已保存的连接之间切换不用反复重启。表单同样支持 SSH 隧道方式适合连跳板机后面的库。浏览表和数据连接成功后左侧是按 schema 分组的表树。点进任意一张表顶部标签可在 Rows、Structure、Indexes、Constraints 之间切换数据区支持按列筛选、关键词搜索和翻页左下角还能看到表大小与预估行数。写查询、导结果切到 SQL Query 标签页就是带语法高亮的编辑器写完点 Run Query 执行或点 Explain Query 看执行计划。结果右上角可一键导出 CSV、JSON、XMLHistory 标签页保留完整查询历史回头翻旧 SQL 很方便。⚙️ 关键配置速查配置项作用默认值什么时候需要改--listenWeb 服务监听端口8081端口被占用或想换访问地址时--bind服务绑定主机localhost需要让其他机器访问时--host / --user / --db默认数据库连接信息localhost / 系统用户名 / 空希望启动即固定连某个库时--url一行式连接串含账号、SSL 模式空连接参数较多、想避免拼错时--auth-user / --auth-pass登录页 Basic 认证账号密码不启用把服务暴露到网络前必配--sessions允许多个数据库会话并行关同时管理多个库时--readonly连接锁为只读关分享给他人、防止误写时--prefixURL 路径前缀空挂在反向代理后面时以上参数都可用PGWEB_前缀的环境变量替代例如PGWEB_SESSIONS1。️ 常见坑与排查端口 8081 被占用启动日志会提示监听端口已被使用。加--listen 9000换个端口或找到占用 8081 的进程停掉。连接被拒绝或认证失败多半是主机、用户或 SSL 模式与数据库端不一致SSL 设为 require 却连未开加密的实例必挂本地调试可先改成 disable参数多时用--url一行式写法能减少逐项拼错。不指定用户启动连接反而失败不传--user时 pgweb 会拿当前系统用户名去连数据库里没有同名角色就直接失败显式传--user即可解决。注意默认页面没有任何登录校验能访问到端口的人就能操作数据库。把 pgweb 暴露到网络时务必配上--auth-user/--auth-pass并限制--bind的可见范围。写在最后三步之后你的 PostgreSQL 就住进了浏览器而且不用操心任何依赖。完整功能清单见 README.md全部界面截图见 SCREENS.md连接书签和系统服务脚本等参考素材在 config/ 目录。【免费下载链接】pgwebCross-platform client for PostgreSQL databases项目地址: https://gitcode.com/gh_mirrors/pg/pgweb创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考