文档中心

AI 原生 BaaS 平台 Supabase 版

使用 Realtime

配置 Realtime

配置 Realtime

Realtime Settings 用于配置当前 Workspace 中 Realtime 服务的启用状态、频道访问策略、连接池大小和事件限额。调整配置后，系统会断开当前已连接的 Realtime 客户端，使 Realtime 服务按新配置重新初始化。

前提条件

已通过目标 Workspace 成功登录 Supabase 控制台。关于登录控制台的详细信息，请参见登录 Supabase 控制台。

当前账号具备管理 Realtime 配置的权限。

如果需要验证配置效果，请确保业务客户端已接入 Realtime。

已获取 SUPABASE_BASE_URL、SERVICE_ROLE_KEY 和 SUPABASE_ANON_KEY。关于获取变量的详细信息，请参见获取变量。

注意事项

保存 Realtime 配置后，当前已连接的 Realtime 客户端会被断开。客户端需要重新连接后，才能使用新的配置。

关闭 Realtime 服务后，新连接会被拒绝，已连接客户端会被断开。需要继续使用 Broadcast、Presence 或 Postgres Changes 时，请保持 Realtime 服务开启。

关闭公共频道访问后，客户端加入频道时需要通过 Realtime Authorization 校验。未设置私有频道配置或未配置对应访问策略时，客户端可能无法接收消息。

连接池和限额配置会影响 Realtime 的连接能力、消息吞吐和资源消耗。建议根据业务并发规模和压测结果调整。

操作步骤

在 Supabase 控制台选择 Realtime。

在 Realtime 页面左侧导航栏中，选择 Configuration > Settings。

按需配置 Realtime 参数。参数的详细信息请参见参数说明。

单击 Save changes。

参数说明

参数	默认值	说明
Realtime service	Enabled	控制是否启用 Realtime 服务。开启后，客户端可以正常建立 Realtime 连接；关闭后，已连接客户端会被断开，新连接会被拒绝。
Allow public access to channels	Enabled	控制是否允许客户端访问公共频道。开启后，持有项目 anon key 的客户端可以订阅和广播公共频道消息；关闭后，客户端加入频道时需要通过私有频道授权校验。
Database connection pool size	1 connections	Realtime Authorization 使用的数据库连接池大小。该连接池用于私有频道加入、访问令牌刷新和私有 Broadcast REST 请求中的 RLS 校验。值过低可能导致授权校验排队或超时；值过高会占用数据库连接数。
Postgres Changes connection pool size	4 connections	创建 Postgres Changes 订阅时使用的连接池大小。该连接池用于创建订阅，不等同于持续传输变更数据的连接。值过低时，突发订阅可能创建超时。
Max concurrent clients	200 clients	当前 Workspace 允许同时连接的 Realtime 客户端数量上限。一个 WebSocket 连接计为一个客户端，与该连接加入的频道数量无关。达到上限后，新连接会被拒绝。
Max events per second	100 events/s	当前 Workspace 每秒允许处理的事件数量上限。事件包括客户端发送的消息和服务端分发给客户端的消息；一条 Broadcast 消息发送给多个订阅者时，会按分发次数计入事件量。
Max presence events per second	1000 events/s	当前 Workspace 每秒允许处理的 Presence 事件数量上限。Presence track、untrack 和同步事件都会计入该上限。
Max payload size (KB)	3000 KB	单条 Realtime 消息允许携带的最大负载大小。超过上限的 Broadcast 或 Presence 消息可能被拒绝或导致频道关闭。

最近更新时间：2026.10.20 21:01:23

这个页面对您有帮助吗？

有用

有用

无用

无用