跳到内容
光环标志
光环基地

实时

自协商 WebSocket、SSE 和 NATS。存在、重播、保证顺序、背压。通过 POP 实现 1M 连接,区域之间的扇出低于 15ms p99。

说明7分钟 读取级别 中间修改于 2026年4月15日

该页面已自动翻译。英文版具有权威性。

同步、存在、广播#

aura-realtime 服务广播三种类型的事件: CDC Postgres (按 RLS过滤插入/更新/删除)、 存在 (在线)和 广播 (独立于数据库的自定义事件)。所有这些都通过 .channel()使用相同的 SDK。

通道由任意名称(sensors:live、 doc:42、 room:abc)标识。消息按通道排序,通过 message_id进行重复数据删除,并保证在同一通道内恰好一次。

信息

订阅从数据库继承 RLS 策略。客户端只能订阅它可以读取的更改 - 过滤器在 WAL 上的服务器端进行评估,而不是在客户端。

1个连接,N个通道#

SDK 在客户端和最近的 POP 之间维护 单个 多路复用 TCP 连接。无需打开 100 个套接字即可打开 100 个通道。

schematext
                      ┌──────────────────┐
   Client (WS)  ────▶ │ aura-realtime    │
                      │  ─ CDC listener  │
                      │  ─ Presence CRDT │
                      │  ─ Broadcast hub │
                      └────────┬─────────┘
                               │ NATS JetStream
          ┌────────────────────┴────────────────────┐
          ▼                    ▼                    ▼
    aura-db WAL         Presence state        autres POPs
提示

事件通过一致性哈希进行分区。通道始终位于同一个 POP 上,但保证其复制到其他 POP 的时间少于 15 毫秒 p99。

六种原生能力#

  • 高通量传输。 由服务间 NATS提供支持的本机 WebSocket 连接。
  • Postgres CDC。 WAL 更改在服务器端过滤,RLS 应用于流。
  • 存在 API。 谁在线,任意状态,加入/离开事件。
  • 多路复用。 多个通道共享一个 WebSocket 连接。
  • 事件传递。 通过自动客户端重新连接进行尽力实时交付。
  • 协作光标。 本机原语、自适应油门 60 FPS、客户端插值。

四种基本模式#

components/LiveDevices.tsxtypescript
const channel = aura.channel('db:public.devices')
  .on('postgres_changes', {
    event: '*',
    schema: 'public',
    table: 'devices',
    filter: `tenant_id=eq.${tid}`,
  }, ({ new: row }) => render(row))
  .subscribe()
强制清洁

卸载时始终调用 channel.unsubscribe()。在 React 中,在 useEffect 清理中执行此操作 - 上面的 useChannel 挂钩会为您完成此操作。

我们承诺什么,我们不承诺什么#

✓ 有保证

  • 按渠道订购
  • 通道中每个 message_id 恰好一次
  • 跨区域扇出 p99 < 15ms
  • 自动重连,60秒重播
  • 显式背压(可配置丢弃策略)

✗ 不保证

  • 跨渠道订购
  • 恰好一次跨通道(至少一次)
  • 亚毫秒级延迟(< 15 毫秒 p99 是我们的下限)
  • 重播超过 60 秒(使用 Postgres 日志)

为了走得更远#