ZeBridge 推出基于 NATS 同步的设备端 PostgreSQL 副本
来源标题:Show HN: ZeBridge – PostgreSQL replicas on devices, synchronized over NATS
ZeBridge 允许每台设备保留本地 PostgreSQL 副本,离线时写入排队,重连后通过 NATS 同步,PostgreSQL 仍作为权威方裁决冲突。它面向 B2B 运营场景,如现场团队、车队和站点的设备共享同一工作数据集。项目提供演示,展示 5 辆卡车在法国 16173 个充电点地图上的同步运行。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
为应用和服务提供本地 PostgreSQL 副本,通过 NATS 同步。
ZeBridge 在每台设备上保留一个本地数据库,离线时将写入排队,重新连接后通过 NATS 进行同步。PostgreSQL 始终是权威方:它执行规则、解决冲突写入,并向应用返回裁决结果。
客户端库提供统一接口,用于读取本地副本、提交变更,以及查询远程响应服务(如路由或分析服务)。可选的区域 NATS 叶节点在设备附近提供快照缓存,并托管这些服务。
最适用的场景:B2B 运营类应用,每个客户组织是一个租户(schema 中的一列),其设备共享一份工作数据集:外勤团队、车队、仓库、站点。它们在网络不佳或团队断联时仍能继续工作,而每一次写入最终仍由 PostgreSQL 给出权威裁决。它并非为每个用户一个租户的消费者(B2C)应用而设计。
查看运行效果:https://bridge.zebridge.eu/demo。五辆卡车行驶在法国 16,173 个充电桩的地图上。选择一辆卡车和一个目的地,它会在所有打开的屏幕上沿道路行驶;从任意屏幕更改其目的地,它会从当前位置转向。充电桩数据来自浏览器自身副本上的查询,路线来自同一 NATS 连接上的路由服务,PostgreSQL 只保存决策。在两个标签页中打开,或在手机和笔记本电脑上打开:每次访问都会在共享演示租户中获得自己的身份,来自一小时的邀请。构建方式:仓库示例。
试用 构建应用 与 PowerSync 对比 部署 文档
你需要 Docker Compose。无需克隆仓库或本地构建。
curl -O https://raw.githubusercontent.com/ndrean/ZeBridge/main/docker-compose.quickstart.yml docker compose -f docker-compose.quickstart.yml up
这会使用已发布的镜像启动 PostgreSQL、NATS、bridge、其 tombstone 清理进程(sweeper),以及两个浏览器演示。此评估用 Compose 文件没有单独的 mutation admission 服务;下文描述的生产布局包含该服务。Compose 文件选择镜像版本;它不会构建当前仓库检出。
当 init 服务打印出邀请链接时,在单独的标签页中打开这些链接:
每个邀请都是一次性的。标签页会创建自己的设备密钥,向 bridge 注册,并获得限定范围的 NATS 凭证。等待四个阶段徽章变为绿色;首次快照可能需要长达一分钟。
查看租户隔离。在 Alice 的一个标签页中修改 counter_tenant:另一个 Alice 标签页会跟随变化,而 Bob 的不会。修改 counter_public:三个标签页都会跟随。该页面还演示了外键、被拒绝的写入和协作编辑。
尝试离线写入。保持标签页打开,然后停止服务:
docker compose -f docker-compose.quickstart.yml down
在断开连接时点击计数器。每个标签页读取自己的本地副本,并将待处理的写入保存在 outbox 中。再次启动服务:
docker compose -f docker-compose.quickstart.yml up
标签页重新连接,提交排队的写入并追赶进度。计数器使用最后写入者胜出:最终值是获胜的写入,而不是离线点击的总和。
初始化日志还会打印指向端口 5174 上共享记录演示的链接。它展示了多个编辑者修改同一条记录的不同字段。
要清除此评估栈并重新开始,请运行 docker compose -f docker-compose.quickstart.yml down -v。这会删除其数据库和 NATS 卷,包括那些邀请所依赖的身份。快速启动使用本地评估设置,不带 NATS TLS;服务器请使用部署指南。
三个部分:hub,由你安装;你的后端,负责用户登录并签发邀请;以及应用,在你选择的本地数据库上使用客户端库。你的应用可以请求的服务(如路由或分析)是可选的,作为独立进程在同一库上运行。
hub 是在一台服务器上的 NATS、bridge、mutation admission 和 sweeper。PostgreSQL 可以运行在同一台服务器上,也可以在别处托管(需要逻辑复制)。有两条现成的路径:
Docker Compose:服务器上的两个文件。包含 HAProxy 和 Let's Encrypt,PostgreSQL 可选:
V=0.2.11 mkdir zebridge && cd zebridge curl -fsSLO https://raw.githubusercontent.com/ndrean/ZeBridge/v$V/deploy/compose/compose.yml curl -fsSL -o .env https://raw.githubusercontent.com/ndrean/ZeBridge/v$V/deploy/compose/.env.example chmod 600 .env
In .env: three domain names, the Let's Encrypt e-mail and the passwords (see the guide).
docker compose up -d
首次启动会签发证书、生成 NATS 身份并安装 ZeBridge 的 SQL 对象,包括 zb_inviter,即你的后端在下面使用的登录。参见 Compose 指南。
Ansible,用于带 systemd 服务的 Debian VPS:填写 inventory 和 vault,然后运行 ansible-playbook site.yml --ask-vault-pass。它可以随时再次运行,只更改有差异的部分。参见 Ansible 指南。
然后启用你的表(Prepare your tables),并用 bridge --diagnose 检查 hub。其他路径(如手动安装或 Supabase)列在 Deploy 中。
你的后端只有一个职责:让用户登录,然后签发邀请。ZeBridge 不认证用户,也不关心你如何认证:OAuth、密码、魔法链接,任何语言或框架均可。在你的后端让用户登录后,它决定用户的主体和租户,并向 PostgreSQL 请求一次性邀请码,使用的登录只能创建邀请,不能做其他事情。这是你唯一需要编写的服务器代码:没有写入 API 或同步端点需要构建,因为写入通过库进行,并由 PostgreSQL 自身的规则来裁决。
// 你的后端,在用户登录后。其数据库登录仅持有 zebridge_inviter。 const { rows } = await db.query( "SELECT zebridge_invite($1, $2, interval '1 hour') AS code", [user.id, user.tenant], ); return { invite: rows[0].code }; // 在登录响应中
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。