我做了一个免费的 PostgreSQL 管理工具:Tuplor 正式发布
Tuplor 是一个免费、开源、界面好看又够强的 PostgreSQL GUI,macOS(Apple Silicon)可以直接下载。这篇介绍我为什么做它、它能做什么,还有怎么开始用。
已自动转为简体 · 查看原文
今天想分享一个我自己做的东西:Tuplor,一个免费、开源的 PostgreSQL 管理工具。第一版 v0.1.0 已经发布,macOS(Apple Silicon)可以直接下载来用。

- 官网:https://c2w570063013.github.io/tuplor/
- 下载:最新版(macOS Apple Silicon)
- 源代码:https://github.com/c2w570063013/tuplor
为什么要自己做一个#
平常用 PostgreSQL,最常碰到的状况是:好用的工具要付费、还常常是订阅制;免费的工具功能够,但界面老旧、操作卡卡的,打开来就不太想用。
我想要的其实很简单:
- 免费,而且不是试用版、不锁功能
- 界面好看,深色、浅色主题都舒服
- 功能完整,不只是能下 SQL,看运行计划、管权限、备份还原都要能做
- 数据不出我的电脑,不需要注册帐号、不上传任何东西
找了一圈没有完全符合的,干脆自己做一个。
它能做什么#
写 SQL:会看你的数据库结构帮你补全#
SQL 编辑器用的是 VS Code 同款的 Monaco。自动补全会依照你的 schema 给建议,连表的别名(o.)、CTE 都认得,还能依外键直接帮你产生 JOIN。
- 运行光标所在的那一句、选取的范围,或整份脚本
- 出错时直接在错误位置标红,不用自己数第几行
- 多个结果分页显示、有交易状态和 Commit / Rollback 按钮
DROP、没有WHERE的DELETE这种危险语句会先跟你确认
看数据、改数据:像试算表一样#

表格用虚拟卷动,10 万列、200 栏一样流畅。可以直接在格子里改数据,改完会先预览产生的 SQL,确认后一次在交易里提交(⌘S),改错了也不怕。
还有筛选、多栏排序、JSON / 图片查看器,导出 CSV、JSON、SQL、Markdown 都可以。CSV 导入会自动侦测分隔符号和编码,Big5、GBK、Shift_JIS 都认得,出错会精准告诉你是第几列。
查找为什么慢:运行计划可视化#

EXPLAIN ANALYZE 的结果画成树状图,用热度条直接标出最慢的节点,列数估计差太多也会提醒你。对会修改数据的语句跑 ANALYZE 时,会自动回滚,不会真的动到数据。
服务器状况一眼看完#

实时的 TPS、连接数、缓存命中率图表;目前有哪些连接在跑什么、谁锁住了谁(还有阻塞树),可以直接取消或终止。也会帮你找出膨胀的表、没在用和重复的索引,有装 pg_stat_statements 的话还能看慢查找排行。
ER 图自动画好#

依外键自动排版,连接直接接到对应的字段,滑过去会高亮相关的表,可以导出 PNG / SVG。
其他功能#
| 模块 | 内容 |
|---|---|
| 连接管理 | 粘贴 postgres:// 网址自动解析、SSL、颜色标签、群组、唯读模式 |
| 对象浏览器 | 表、view、function、sequence、type 都能浏览,右键就能产生 SQL、重命名、VACUUM |
| 表结构 / 建表 | 字段、索引、约束、外键、触发器、完整 DDL;改完先预览 SQL 再套用 |
| 角色与权限 | 创建角色、GRANT / REVOKE;密码在本机转成 SCRAM 哈希,明文不会送出去 |
| 备份 / 还原 | 自动找 pg_dump / pg_restore,支持多种格式、实时日志、可以取消 |
另外有 ⌘K 指令面板,表名、指令、连接都能直接搜索跳过去。支持 PostgreSQL 12 到 18。
隐私:数据都在你自己的电脑上#
这点我很在意,所以特别说明一下:
- 不用注册、不用登录,没有任何追踪或统计
- 连接密码用 AES-256-GCM 加密,存在你自己电脑的
~/.tuplor文件夹 - 唯一会连网的地方,是每天最多一次去 GitHub 查有没有新版本
- 代码完全开源(MIT 授权),想确认它做了什么,都可以直接看
怎么开始用#
- 到官网或 GitHub Releases 下载
.dmg - 打开后把 Tuplor 拖到「应用程序」文件夹
- 添加连接,或直接粘贴
postgres://网址
第一版还没有经过 Apple 公证,第一次打开时 macOS 会挡下来。到「系统设置 → 隐私权与安全性」,往下卷到 Tuplor 那一行,按「强制打开」就可以了,之后不会再问。签章版本已经在处理,下一版就不用这一步。
目前只有 Apple Silicon(M 系列芯片)的 Mac 版本。
最后#
如果你也常用 PostgreSQL,欢迎下载来试试看。用起来有问题、有想要的功能,或发现 bug,都可以到 GitHub 开 issue 告诉我。
觉得好用的话,帮我在 GitHub 按个 ⭐,或分享给身边写 SQL 的朋友,这对一个刚起步的开源项目帮助很大,谢谢!
