跳至正文
概念演示

由 Get Ranked On Top 设计和制作的虚构品牌,并非真实公司。

跳到正文
SHUNT(1)Shuntline 手册 · rev. 3.12.0 · 2026-10-14SHUNT(1)
[00] 名称 — shunt · 面向 Postgres 的写时复制分支

像管理代码一样,给数据库开分支。

每个 pull request 都拿到一份属于自己、可写的生产库副本——已脱敏、相互隔离,不到一秒就绪。可以 diff,可以按计划合并,也可以直接丢掉。您的种子数据脚本,可以体面地退休了。

curl -fsSL https://get.shuntline.example | sh
概要
0.8s为 1.84 TB 开一个分支。这是中位数,不是最好成绩。
0 B在您写入之前,一个字节都不复制。
190万上个月创建的分支数,其中 170 万已按计划删除。
PG支持 Postgres 14–17。MySQL 8.4 处于 beta,警告该有的都有。
图 1 shunt tree —— prod-eu-1 此刻的所有分支
$ shunt tree --db prod-eu-1

main                      ● 4f2a91c  1.84 TB   受保护
├─ feature/payments       ● 9be04d7  +412 MB   +3 表 ~1 列 -1 列
│  ├─ preview/pr-482      ● 2d71aa0  +6.1 MB   +1,204 -18 行
│  └─ ci/run-88213        ○ 9be04d7  0 B       已挂起
├─ fix/invoice-round      ● a0c3f19  +88 KB    ~312 行
└─ scratch/kenji          ○ 4f2a91c  0 B       ttl 3h 51m

6 个分支 · 4 个活跃 · 已写入 506 MB · 11.04 TB 未复制
图 2 时刻表,10 月 16 日星期五Git 风格示意图:feature/payments 从 main 分出,preview/pr-482 从 feature/payments 分出,最后 feature/payments 合并回 main。09:0010:0011:0012:0013:0014:00mainfeature/paymentspreview/pr-4824f2a91c7c03e1d合并+3~1-1结构+1,204-18行
已在 4,100 个工程团队的生产环境中运行,包括我们没有付钱请任何一家来站台
  • Paraday
  • Quillon Health
  • Marrow & Finch
  • Obel Ledger
  • Tessary
  • Kallio Freight
[01] 终端无需注册,不走网络,不留后果

三条命令,就是整个产品。

点击一条命令,在一份“假装的”生产库副本上运行。说它真,是因为输出和您实际看到的一模一样;说它假,是因为我们并没有真的删掉您的列。

branch create
指向父分支的页面,全新计算资源,已脱敏。
diff
结构与数据行,可对比任意祖先。
merge
先出计划,再查漂移,设好锁超时,然后才干活。
acme-api — zsh — shunt 3.12.0空闲
Last login: Fri Oct 16 09:12:44 on ttys004
~/acme-api (main) $ shunt branch create feature/payments --from main
→ 解析 main @ 4f2a91c  (prod-eu-1 · postgres 16.4)
→ 为 212 张表打快照,逻辑大小 1.84 TB
  copy-on-write:写入 0 字节。我们核对了两遍。
→ 分配计算资源  shu-c-2x  (2 vCPU · 8 GB)
✓ 分支 feature/payments 已就绪,用时 0.81s

  postgres://app@feature-payments.eu-1.shuntline.example/app
  ttl 72h · 空闲 5 分钟后挂起 · 脱敏规则:pii-default
~/acme-api (main) $ 

[02] 工作原理3 步 · 0 个 YAML 文件 · 1 行 CI

把 Git 的语义,带给技术栈里从来没有它的那一层。

第 01 步:接上 Postgres

Shuntline 以只读副本的方式接入。它从不写入您的主库,也不需要 superuser——只要 REPLICATION 权限,外加首次同步时一杯咖啡的耐心。

步骤 01
$ shunt init \
    --from $PROD_URL
→ 副本已接入(延迟 120ms)
✓ 已跟踪 212 张表

第 02 步:每个 PR 一个分支

在 CI 里加一行,每个 PR 都有自己的可写数据库:PII 按规则脱敏,再配一个 TTL,没人需要为上个季度的实验买单。

步骤 02
$ shunt branch create \
    preview/pr-$PR --ttl 72h
→ 正在脱敏 14 列
✓ 就绪,用时 0.79s

第 03 步:Diff、合并、忘掉

对照父分支查看结构和行级变更,生成一份真正读得懂的迁移计划,然后合并——或者删掉分支,当它从没存在过。

步骤 03
$ shunt merge --plan
+ table payment_intents
- column legacy_ref
1 处破坏性变更。加 --yes 继续
[03] 基准测试30 次运行中位数 · postgres 16 · eu-1 · 2026 年 9 月
创建分支0.8s

1.84 TB 数据库上的 p50。p99 为 1.6s,大部分花在 DNS 上。

创建时写入0 B

页级写时复制。您改了多少,就存多少。

读取开销+0.4ms

热页相对父分支增加的 p99 延迟。

节省存储38×

对比每晚全量克隆,各客户的中位数。

得到一份 500 GB 数据库的可写副本,需要多久

pg_dump → pg_restore3h 41m
逻辑副本 + 提升1h 12m
卷快照恢复27m
shunt branch create0.8s

我们的条形画成 1px,因为 0.0006% 的宽度根本显示不出来。测试方法和原始数据见 docs/benchmarks。

图 3 写时复制,如实画出mainfeature/payments000102030405060708098 个指针,2 个页面

分支就是一串指向父分支页面的指针。往某一页写入,分支才会得到那一页的独立副本。这里是十页中的两页。您只为橙色的那几页付费。

[04] 更新日志shunt changelog --follow

每周二、周四发版。

今年已发布 41 个版本。语义化版本号,由真人撰写,破坏性变更标红,方便您快速找到要紧的那几条。

完整历史,一直到 v0.1 →
  1. v3.12.0性能

    shunt diff --data 对超过 1 亿行的表改为抽样,不再全表扫描。快了 41 倍,而且会明确告诉您它抽了样,因为我们不是坏人。

  2. v3.11.2修复

    以斜杠结尾的分支名,不再会创建一个实际上叫“空”的分支。感谢发现这个问题的四位。

  3. v3.11.0新增

    TTL 现在继承自父分支。preview/* 分支默认 72h,除非您在 shunt.toml 里另有设置。

  4. v3.10.0新增

    Postgres 17 已在所有套餐中正式可用,包括 pgvector 0.8 和 PostGIS 3.5 扩展。

  5. v3.0.0破坏性

    在非交互式 shell 中,shunt merge 执行破坏性迁移现在必须加 --yes。您的 CI 会察觉到。这正是目的所在。

[05] 键盘shunt ui · 可通过 ssh 使用 · 至少 80 列

鼠标可有可无。

shunt ui 是一个全屏 TUI,用来浏览、对比和合并分支。它尊重 $EDITOR、$PAGER 和您的肌肉记忆。我们也有 Web 控制台,主要拿来截图。

shunt ui 键盘快捷键
按键操作说明
b从选中项新建分支提示输入名称;可从 git Tab 补全
d与父分支对比先看结构,回车看数据
m合并到父分支总是先展示计划
r重置为父分支丢弃写入;只问一次
s挂起 / 恢复计算存储保留,计费停止
/筛选分支支持正则,那还用说
g g跳到 main献给 vim 用户
ctrl z撤销上次合并15 分钟内有效,趁还没人发现
?显示这张表以防您忘了它的存在
[05½] 一线反馈除了脏话,一字未改

工程师们怎么说

切换过来的那一周,我们删掉了 1,900 行种子数据脚本。至今没人要求恢复,包括写它们的那个人。
Ingrid Valtonen
Paraday 资深工程师
每个 PR 都有一份真实的生产库副本,邮箱全部脱敏。QA 再也不提那种只在周二复现的 bug 了。
Tomás Arriaga
Quillon Health 平台负责人
周五下午 4:55,合并计划在一张 4 亿行的表上拦下了一个 NOT NULL。我想亲自谢谢它。
Priya Raman
Obel Ledger 数据库负责人
[06] 价格美元 · 按月计费 · 一条命令即可取消

一张表,而不是销售漏斗。

每个套餐都包含 CLI、TUI、写时复制存储,以及不到一秒的分支创建。区别全在下面,没有隐藏的行。

套餐对比
功能Solo$0Team$24 / 人 / 月大多数团队从这里开始Scale$480 / 月 + 用量Enterprise详谈
活跃分支10不限不限不限
包含存储10 GB250 GB2 TB定制
额外存储—$0.12 / GB·月$0.09 / GB·月承诺用量
每分支计算资源共享2 vCPU最高 16 vCPU独享
PII 脱敏规则✓ 已包含✓ 已包含✓ 已包含✓ 已包含
数据 diff— 不包含✓ 已包含✓ 已包含✓ 已包含
合并计划 + 撤销— 不包含✓ 已包含✓ 已包含✓ 已包含
SSO / SCIM— 不包含— 不包含✓ 已包含✓ 已包含
审计日志保留—30 天1 年7 年
自带云账号— 不包含— 不包含— 不包含✓ 已包含
支持论坛邮件,1 个工作日Slack,4 小时专属工程师,1 小时
 安装 CLI开始 14 天试用开始 14 天试用预约通话
[07] 常见问题man shunt-faq

问题,直白作答。

没找到答案?engineers@shuntline.example 直达写代码的人,而不是工单队列。

分支是真正的 Postgres 数据库吗?

是的。它是一个完整的 Postgres 实例,有自己的连接串、角色和扩展。您的 ORM、迁移工具和 psql 都分辨不出区别——这正是重点。

你们会连同 PII 一起复制生产数据吗?

分支在创建时就按您在 shunt.toml 中定义的规则脱敏——每列可选哈希、遮盖、伪造或保留。默认规则会拦下邮箱、电话号码,以及任何名字像密钥的字段。未脱敏的分支需要显式加参数,并会记入日志。

能合并数据,还是只能合并结构?

都可以。结构合并会生成迁移计划。数据合并按表选择开启,以主键解决,冲突会列出来,而不是靠猜。

我开分支期间 main 变了怎么办?

shunt merge 会对照您分支起点的那次提交检查漂移。如果底下有任何变化,它会 rebase 计划,并在动手之前把差异展示给您。

写时复制存储怎么计费?

您为分支写入过的页面付费,而不是为父库的大小付费。一个 2 TB 数据库的新分支,在您改动任何东西之前,存储费用为零。

它运行在哪里?

托管区域包括 eu-1、eu-2、us-1 和 ap-1;Enterprise 套餐也可以运行在您自己的云账号里。数据留在您选定的区域,这一点我们也写进合同。

[08] 文档214 页 · 用 shunt docs 可离线搜索
[09] 另见

读读手册。

快速入门需要十一分钟,其中四分钟在等第一个副本同步。也可以跳过它,直接开始试用,等哪里让您意外了再去翻文档。大多数人都是这么做的。

无需绑卡。除非您输入 `shunt sales --please`,否则不会有销售电话。

名称
    shunt-branch — 创建、列出或删除分支

概要
    shunt branch create <name> [--from ref]
        [--ttl dur] [--mask rules]

描述
    为下列引用创建写时复制分支:
    ref(默认:main)。不复制任何数据。
    页面在首次写入时才被复制。

缺陷
    已知:无。怀疑:若干。