Netcatty 云同步深度解析:CRDT 收敛同步如何让主机配置跨设备实时一致

原创2026-09-22 14:01:512,243 阅读

Netcatty 云同步深度解析:CRDT 收敛同步如何让主机配置跨设备实时一致

Netcatty 是一款集 SSH 工作区、SFTP 文件管理与终端于一体的开源客户端,其云同步功能通过 CRDT 收敛同步与零知识加密,让主机配置、密钥、脚本等数据在多台设备间实时保持一致,且云端只存密文。本文带你完整看懂这套同步机制的运作原理与冲突处理策略,帮助你在跨设备使用 Netcatty 时彻底告别"配置不同步"的烦恼。


🎯 什么是 Netcatty 云同步?

Netcatty 内置了一个零知识加密多云端同步系统,把你的主机库、SSH 密钥、身份凭据、端口转发规则、代理配置、脚本片段、笔记与终端设置整体打包成加密载荷,同步到你自己的云存储中。

支持的云端存储包括:

  • ✅ GitHub Gist
  • ✅ Google Drive
  • ✅ Microsoft OneDrive
  • ✅ WebDAV 服务器
  • ✅ S3 兼容存储
  • 🧩 插件贡献的自定义存储源

云端存储的识别逻辑定义在 domain/cloudProviderIds.ts 中,除内置 5 家提供商外,还允许插件以命名空间 ID 方式接入自己的同步后端。

Netcatty 云同步 CRDT 收敛同步应用图标,展示 SSH 主机配置跨设备实时一致的客户端


🔄 同步状态机:先解锁,再同步

Netcatty 用两层状态机保证同步安全可控:

  1. 安全状态机(domain/sync.ts):NO_KEY → LOCKED → UNLOCKED。只有主密钥在内存中时,同步操作才被放行——这是零知识设计的核心:主密钥永不离开你的设备。
  2. 同步操作状态机:IDLE(空闲)、SYNCING(同步中)、CONFLICT(需处理冲突)、BLOCKED(防误删拦截)、ERROR(出错)。

其中 BLOCKED 状态值得注意:当某次上传会删除云端"过多"数据时,系统会主动拦截并让你选择"恢复"还是"强制推送",避免空库覆盖好数据(见 domain/syncGuards.ts)。


🧮 CRDT 收敛同步:冲突免处理的关键

传统同步遇到"两台设备同时修改同一台主机"时只能弹冲突框。Netcatty 的收敛同步引擎(domain/convergentSync/)用 CRDT(无冲突复制数据类型)让大部分修改自动收敛一致。它的四个核心构件:

1️⃣ 设备点(Dot)与版本号

每次本地修改都会生成一个"点":{deviceId, counter},即"哪台设备的第几次修改"。每台设备维护自己的逻辑计数器,天然区分先后。

2️⃣ 版本向量(Version Vector)

用一张"每设备→计数"的表记录已知的全部修改历史。合并时取逐设备最大值(mergeVersionVectors),并通过"支配关系"(versionVectorDominates)判断两份状态是否互相包含——完整逻辑在 domain/convergentSync/clock.ts。

3️⃣ 混合逻辑时钟(HLC)

物理时间 + 逻辑计数双保险。当墙钟时间未前进时自动递增逻辑计数,确保即使系统时钟走时异常,修改顺序依然稳定(tickHybridLogicalClock)。

4️⃣ 多值寄存器(MultiValueRegister)

这是收敛的精髓:每个字段(如主机的端口、名称、排序位置)都存储为带候选列表的寄存器,而不是单一值。两台设备同时改同一字段时,双方值都保留为候选,按"设备点 + HLC"排序选出赢家;删除用**墓碑(tombstone)**标记而非物理移除,保证"删除"也能跨设备传播。

💡 项目用属性测试 convergentSync.property.test.ts 验证了"无论修改以什么顺序到达各设备,最终状态必然收敛一致"——这就是"收敛同步"名字的由来。


🔒 零知识加密:云端只有密文

  • 整个同步载荷使用 AES-256-GCM 加密后才上传,明文元数据仅暴露版本号(见 domain/convergentSync/types.ts 注释)。
  • 云端存储采用"物化胜者"编码:已确定赢家的值可省略,用相邻的 v1 快照在加载时重建,进一步压缩体积(ConvergentEnvelopeV2)。
  • 载荷的构建与应用统一收口在 application/syncPayload.ts,主窗口与设置窗口共用同一套助手函数,杜绝字段遗漏导致的数据丢失。

⚖️ 冲突处理:自动合并优先,人工兜底

三路合并策略

同步前保存的"基准快照"让 Netcatty 能做 Git 式三路合并(domain/syncMerge.ts):

场景 处理结果
仅本地新增 / 仅远端新增 双方都保留
仅一方修改 采用修改方版本
双方修改同一实体 默认保留本地版,冲突被记录

三种同步策略

在 domain/syncStrategy.ts 中定义了三种策略,默认是智能合并(smartMerge):

  • smartMerge:能自动合并就合并,冲突才找你
  • preferCloud:冲突时以云端为准
  • preferLocal:冲突时以本地为准

可视化冲突面板

对于 CRDT 无法自动裁决的字段级冲突(如排序位置、设置结构),components/cloud-sync/ConvergentSyncPanel.tsx 会列出每个冲突的全部候选值,由你点选保留哪一个;解决方案通过 resolveConvergentFieldConflict 写回并继续向其他设备传播(domain/convergentSync/conflicts.ts)。

🛡️ 一个细节值得点赞:涉及密码、私钥、token、API Key 的冲突字段会被识别为"机密"(isConvergentConflictSecret),界面绝不渲染其明文,也严禁写入日志。


📋 上手指南:开启跨设备同步

  1. 打开 设置 → 云同步(components/CloudSyncSettings.tsx),选择 GitHub Gist / Google Drive / OneDrive / WebDAV / S3 之一并授权。
  2. 设置或确认主密钥——所有数据都用它在本地加密,务必牢记。
  3. 保持默认"智能合并"策略即可;若习惯以某端为准,可切换 preferCloud / preferLocal。
  4. 从旧版本升级的用户会自动走 application/convergentSyncMigration.ts 迁移流程,把旧数据转入 v2 收敛格式,无需手动操作。
  5. 同步状态可通过界面右上角的状态按钮实时查看(components/SyncStatusButton.tsx)。

💬 常见问题

Q:两台设备同时改同一台主机,会丢数据吗? A:不会。多值寄存器保留双方候选,可自动收敛或进冲突面板供你选择;墓碑机制保证"删除"不会被旧数据复活。

Q:云端服务商能看到我的主机信息吗? A:不能。上传前已用 AES-256-GCM 加密,云端只有密文,且主密钥只存在你设备上(零知识)。

Q:新设备第一次同步会发生什么? A:直接下载云端加密载荷并解密加载,之后每次修改都以增量收敛方式双向传播。


✅ 总结

Netcatty 的云同步把"跨设备一致性"这件难事拆解为四层防线:CRDT 收敛引擎负责让绝大多数并发修改自动一致,三路合并处理实体级差异,可视化冲突面板兜底人工裁决,零知识 AES-256-GCM 加密保证数据只有你自己能读。配合防误删的 BLOCKED 拦截机制,你的 SSH 主机配置终于可以放心地在办公电脑、家里笔记本和随身设备间实时流转了。

想深入源码?推荐路径:

登录后查看全文
Netcatty