知屿
ZSP · ZHIYU SYNC PROTOCOL
桌面版和你的服务器，
是怎么互相认出对方的。
知屿 1.17.3 起，桌面版可以和你自己 VPS 上的网页版同步。这里把配对、握手和同步的过程拆成 18 步：每一步发生了什么、为什么安全、旁观者能看到什么，以及有人捣乱时会怎样。
桌面版
你的电脑
网页版
你的 VPS
捣乱的人
中间人 / 路人
提示：也可以用键盘 ← → 切换步骤，空格 播放或暂停。系统设置了「减少动态效果」时不会自动播放。
一句话总结
- 配对码只在你眼前出现：它从不在网络上传输，用一次就作废，错 3 次也作废。
- 之后不再依赖它：双方记住对方的公钥，每次同步先互相认证，再用临时密钥加密。
- 即使没有 HTTPS 也行：协议自己负责认证、加密和防重放，HTTPS 是额外一层。
- 密钥库默认不同步：开启后只传密文，服务器看不到明文；系统保存的 Token 与 API Key 永远不同步。
完整设计、威胁模型和已知限制见 docs/SYNC.md ↗。这是自研的协议组合（构件均为标准算法和通用库）， 没有经过第三方审计，欢迎审阅。