Doory如何拦截恶意包:CRDT协议安全加固全解析

原创2026-10-15 09:42:591,761 阅读

Doory如何拦截恶意包:CRDT协议安全加固全解析

Doory 是一个开源的 Canva 替代品(open source canva alternative),内置实时协同编辑能力。多人同时编辑一份设计稿时,Doory 用 CRDT(无冲突复制数据类型,基于 Yjs/pycrdt)在客户端与服务端之间同步文档变更。而每一个来自浏览器的 update 包都是"认证过但不可信"的数据——一个精心构造的恶意包,可能让原生引擎进程崩溃或内存暴涨。本文将完整解析 Doory 在 collab 应用中搭建的多层防线,看它如何一步步拦截恶意包。

Doory 开源 Canva 替代品的编辑界面

一、为什么协同编辑是攻击靶点

服务端把客户端发来的 Yjs update 交给原生 CRDT 引擎(pycrdt)应用。官方代码注释一针见血:

引擎是原生代码,一个精心构造的 update(深层嵌套的值、引用不存在的历史)可能让进程崩溃,或让内存无界增长。

——见 protocol.py 的模块说明。Doory 的对策是:任何客户端字节在靠近引擎之前,必须通过五道检查。

二、第一道:连接准入,先验身份再谈数据

在 consumers.py 的 connect 流程中,连接要闯过四关:

关卡 实现 目的
Origin 校验 RealtimeOriginValidator 拒绝跨站 WebSocket 劫持(CSWSH)
登录鉴权 必须已认证,否则关闭码 4401 匿名者无法进入房间
连接频率 每账号每分钟最多 REALTIME_CONNECTS_PER_MINUTE(默认 60)次新连接 防重连洪水
登录超时 10 秒内未完成密码认证即断开(4408) 防"占坑式"连接

分享链接带密码时,同一连接最多试错 5 次(MAX_PASSWORD_ATTEMPTS),超限直接拒绝;配合 IP 维度的锁定机制(access.py),暴力破解成本被拉高。

三、第二道:帧大小与双桶限流

每个数据帧进入房间前,receive 做两件事:

  1. 单帧上限:超过 REALTIME_MAX_FRAME_BYTES(默认 1 MiB)直接以 4413 关闭连接,杜绝超大包;
  2. 令牌桶限速:TokenBucket 同时维护"消息数"和"字节数"两个桶(默认 100 条/秒、1 MiB/秒),任一桶不足即拒收——攻击者既不能刷小包,也不能灌大流量。

所有阈值都在 settings/base.py 集中配置,运维可按负载调整。

四、第三道(核心):有界扫描器 scan_update

真正拦住恶意包的是 scan_update。它在不应用 update 的前提下完整解析一遍字节流,违反任何一条规则就抛出 ProtocolError,连接以 4400 关闭:

  • 深层嵌套:lib0 any 值嵌套深度超过 MAX_ANY_DEPTH = 32 即拒绝,用显式栈而非递归,解析器本身不会被拖死;
  • 悬空引用:update 若引用文档不具备的历史(scan 对照当前状态向量校验),会被拒——这类包否则会永久滞留在引擎的 pending 缓冲区;
  • 白名单根类型:只能写入 meta、pageOrder、pages 三个根,ALLOWED_TYPE_REFS 只放行 Array/Map/Text,XML 类型和子文档一律拒绝;
  • 畸形字节:varuint 超过 10 字节、UTF-8 解码失败、状态向量条目超过 10 万,统统视为恶意。

Doory 实时协同编辑演示录屏

五、第四道:房间级预算 UpdateBudget

单包合法不代表批量无害。UpdateBudget 对整个房间的累计行为记账,针对的是引擎中"复杂度随文档规模平方增长"的陷阱写法(真实编辑器永远不会产生它们):

MAX_NEW_CLIENTS          = 4     # 单连接最多引入的 client id
MAX_RIGHT_ONLY_PER_UPDATE = 64   # 单次 update 在数组头部插入的上限
MAX_INSIDE_REFS_PER_UPDATE = 256 # 指向同批长结构内部的引用数
MAX_ORIGINLESS_PER_ENTRY = 32    # 单个 map 条目的"无前任"首写次数

见 engine.py 的预算常量。任一超限,update 被标记 rejected,文档原封不动(apply_client_updates 保证被拒包不落盘、不扩散)。

六、第五道:慢操作隔离与"中毒"状态

即使前面全过了,应用耗时超过 REALTIME_SLOW_APPLY_SECONDS(默认 2 秒)的 update 仍会被判为 update_too_costly:该房间立即进入 poisoned(中毒)状态,丢弃这份内存状态,绝不落盘持久化——否则这个"慢包"会在每次重载时反复消耗服务器。

此外文档体积有硬上限:接近 MAX_DESIGN_DOCUMENT_BYTES 时,引擎会先在草稿副本上精确测量(_would_exceed),超限的包以 4413 document_too_large 拒收,而其他协作者完全不受影响(test_robustness.py 专门验证了这一点)。

七、纵深防御:防御式读回 + 系统级资源隔离

  • 保存前回读:状态落库前还要过 schema.py 的防御式转换——错误类型、重复 id、悬空 id "永不抛异常、永不做无界递归",嵌套深度限制 64 层;
  • 服务级护栏:systemd 单元文件为实时服务单独设置了 MemoryMax=2G、NoNewPrivileges=true、PrivateTmp=true,注释直言:"敌对 update 可能让协同引擎分配大量内存,在这里拦住,而不是拖垮宿主机"。

Doory 设计编辑器界面与协同工具

八、如何验证?看对抗测试与模糊重放

Doory 把这些防线写成了可回归的测试:

  • test_hardening.py:发送嵌套 1500 层的 awareness 状态、500 层嵌套的登录帧,断言"只关闭发送方,其他协作者毫发无损";
  • hostile.py 与 test_robustness.py:模拟超大文档、存储故障、卡死的慢消费者等敌对场景;
  • 模糊重放:前端 fuzz 引擎(frontend/src/editor/collab/fuzz/)让多个编辑器在"敌意网络"下做随机编辑,录制下来的 update 序列被 test_fuzz_replay.py 按原顺序喂给真实服务端管线——每条合法 update 必须被接受,且最终文档与编辑器一致。

九、总结:五层防线一张表

层级 拦截目标 关键实现
连接准入 匿名/跨站/刷连接 Origin 校验 + 频率限制
帧与流量 超大包、洪泛 1 MiB 帧上限 + 双桶令牌桶
更新扫描 深嵌套、悬空引用、未知根 scan_update 有界解析
房间预算 平方级复杂度攻击 UpdateBudget 累计记账
系统兜底 慢包、内存耗尽 poisoned 隔离 + MemoryMax

对自部署用户而言,这套架构意味着:即使你的 Doory 实例暴露在公网、任何人拿到分享链接,恶意客户端最多只能让自己的连接被 4400 关闭,而无法打崩服务、毒化文档或窥探他人数据。这就是 Doory 在"自由协作"与"安全边界"之间给出的答案。

登录后查看全文
doory