Syncthing

设备 ID 与文件夹 ID：两套独立标识

Syncthing 的标识体系是理解它的关键，也是新手最搞混的地方：

• 设备 ID：每台机器一个，形如 ABCD-EFGH-IJKL-MNPQ-1234-5678-9ABC-DEFG-HIJK-MNOP，由证书派生、永久不变，等价于设备指纹。
• 文件夹 ID：每个同步目录一个名字，默认取目录名，全网唯一。它是同步的命名空间。

配对的完整流程是：两台机器交换设备 ID（扫码或复制粘贴），然后双方各自添加对方并选择「共享」该文件夹。注意「添加设备」和「共享文件夹」是两个独立动作——只添加设备不同步任何东西，勾上文件夹的共享复选框才真正开始同步。

坑：只在一端勾了共享，另一端没勾，文件夹会显示为「未共享 / Remote Unshared」，一直不开始传输。检查两端都要有该文件夹且状态为 Active。

中继机制：断网时它真的能传吗

当两台设备不在同一局域网且互相无法直连时，Syncthing 会借助中继服务器（Relay） 交换连接信息，传输本身仍是端到端的。

关键点：中继不存储你的文件，只转发握手包。中继服务器由社区运营，也可能不可用。所以只要你的服务器有公网 IP 并做了端口转发，就应该优先走直连。

在 Web 界面的远程设备上点「Connection Type」可以看到当前走的哪条路。打开 设置 - 调试 面板还能看到 NAT 探测结果和候选地址列表。

版本控制与冲突副本

Syncthing 在同步时自带一套简化的版本控制，配置在文件夹的 File Versioning：

• Trash Can：删除的文件放进回收站，默认 30 天后清理
• Simple：只保留历史修改版本，数量可设
• Staggered：只在特定时间点保留版本，省空间
• No File Versioning：关闭（不推荐）

收到「Local Additions/Deletions」类型的冲突时，同步会在文件名后加 ~sync-conflict-... 后缀生成副本而不是覆盖。要减少冲突，规则是两边都不要同时改同一个文件。

大文件与忽略规则

先把忽略规则配好，不然 node_modules 或视频目录会直接把同步拖死。忽略规则走 .stignore 文件，语法接近 gitignore：

# 临时文件与系统垃圾
*.tmp
~$*
.DS_Store
Thumbs.db
# 大目录与二进制产物
node_modules/
.git/
*.iso

放在文件夹的「忽略模式」设置里，忽略 标签页可以看哪些规则命中了哪些文件，调试很方便。配置生效需要重启该文件夹的同步。

命令行与无界面部署

服务端二进制 syncthing 自带 CLI，容器化与服务器部署时用它最省事。设备 ID 必须在启动前生成并保存，因为 ID 由证书决定，重新生成就变了：

bash# 1. 首次生成配置（含设备 ID 与 TLS 证书）
syncthing generate --home=/var/syncthing/config
# ----
# 2. 之后一律用 serve 启动，不会覆盖已生成的 ID
syncthing serve --home=/var/syncthing/config --no-browser
# ----
# 3. 查本机设备 ID
syncthing --home=/var/syncthing/config cli show system
# ----
# 4. 列出已连接的设备
syncthing --home=/var/syncthing/config cli show connections

generate 和 serve 的区别是易错点：generate 会重新生成配置与证书，误用会导致设备 ID 变更、所有设备都需要重新配对。正确做法是首次部署用 generate，之后重启一律用 serve。

验证与修复（--repair）只在文件真的损坏时才用，它会用本地副本覆盖其他节点的数据，代价是以本地为准、丢弃远端较新的版本，用之前先确认本地数据是完整的。

配置目录由 --home 参数决定，systemd 部署时建议显式指定，避免 root 与普通用户配置混淆。