Syncthing 介绍与选型指南

目标：说清 Syncthing 是什么、凭什么架构做到「设备间无中心持续文件同步」，并以量化对比表给出它与 Nextcloud、Resilio Sync、Unison、rsync 的选型结论。本篇为认知篇，全部数据联网溯源自官方渠道（查询日期：2026-10-22），不含本地实测自述。

一、环境信息

• 调研对象：Syncthing 开源持续文件同步工具（官网 https://syncthing.net/）
• 版本基线：v2.1.7（代号 "Hafnium Hornet"，GitHub Releases releases/latest 重定向实查，2026-10-22）
• 溯源渠道：syncthing.net 官网与下载页、docs.syncthing.net 官方文档（Security/Relay 等页）、GitHub syncthing/syncthing 仓库页（星数经 shields.io 徽章取证，2026-10-22）
• 本篇性质：A1 认知篇，只做联网溯源与选型分析；安装、配置、命令的实测细节见本专栏《Ubuntu 22.04 安装 Syncthing 指南》、《Syncthing 2.1.7 配置参数详解》、《Syncthing 2.1.7 常用 CLI 命令与工具详解》

二、软件概述

2.1 一句话定位

Syncthing 是一个开源、去中心化（P2P）、持续运行的文件同步工具：在每台设备上运行一个 Syncthing 实例，彼此直接建立加密连接交换文件变更，没有中心服务器存储数据（来源：syncthing.net 官网首页 "open, trustworthy and decentralized file synchronization"，2026-10-22）。

它的四个关键词（来源：syncthing.net，2026-10-22）：

2.2 身份信息（实查官方渠道，2026-10-22）

💡 技术拓展：v1 与 v2 的关系——Syncthing v2 是 2025 年开始发布的第二代主线（配置/数据目录布局、REST/CLI 命令结构有变化），官方 apt 源中 stable 组件继续提供 v1 系列（当前 1.30.0），stable-v2 组件提供 v2 系列（当前 2.1.7）。两代并存是过渡期官方策略（来源：apt.syncthing.net 仓库元数据，2026-10-22）。本专栏文档均以 v2.1.7 为准。

三、核心架构

3.1 架构总览

Syncthing 的架构可以概括为「每设备一个守护进程 + 全互联直连 + 三层连接建立机制」：

[设备A] ←— TLS 加密直连（TCP/QUIC 22000）—→ [设备B]
   |                                          ↑
   | ① 本地发现：局域网广播/组播                | ③ 中继转发（无直连时兜底）
   |   IPv4 广播 / IPv6 组播 21027             relay://...:22067
   ↓                                          |
   ② 全局发现：向 discovery-*.syncthing.net    |
      周期公告 deviceID ↔ 公网地址映射 —————————┘

三个要点（来源：docs.syncthing.net/users/security.html 与本仓库 serve 命令的 STTRACE 包清单对照，2026-10-22）：

1. 设备身份 = Device ID：每台设备首次启动时生成本地证书，Device ID 是证书指纹（如 BITUNOQ-VKBHIFH-2UWCK4D-... 形式的分组大写串）。设备互信以「双方各自添加对方 Device ID」为准，类似 SSH 的指纹信任模型（来源：docs.syncthing.net Security 页 "Introduction: When two devices each have the other's device ID..."，2026-10-22）。
2. 传输全程 TLS 加密：设备间连接与到发现服务器的连接均为 TLS，且校验对端证书（来源：docs.syncthing.net/users/security.html "All connections are protected using TLS... The connection to the discovery server is encrypted using TLS and the discovery server certificate is verified"，2026-10-22）。
3. 协议层独立成包：官方将协议命名为 BEP（Block Exchange Protocol），按块（block）交换文件内容并校验哈希，支持增量与断点续传（来源：docs.syncthing.net "BEP: the Block Exchange Protocol"、官方规范页，2026-10-22）。

💡 技术拓展：文件同步架构的两种主流形态——

形态	代表	数据路径	特点
C/S 集中式	Nextcloud	客户端 ↔ 中心服务器 ↔ 客户端	集中管控、可建共享链接；服务器是容量与带宽瓶颈、单点故障
P2P 去中心化	Syncthing、Resilio Sync	设备 ↔ 设备直连	无中心瓶颈、内网直连快；设备需在线才能互相同步

Syncthing 采用 P2P 形态：数据永不经过第三方服务器，适合「自己的多台设备互相同步」；若需要「对团队/公众提供文件分享门户」，集中式形态更合适（选型见第七章）。

3.2 发现机制（找到对方设备）

连接建立的前提是「找到对方地址」。Syncthing 有三层发现机制，逐层兜底（来源：docs.syncthing.net Security 页 Global/Local Discovery 段落 + Global Discovery 规范页，2026-10-22）：

官方文档同时明确了信息泄露边界：开启全局发现后，互联网上的窃听者可推断「哪些机器在跑 Syncthing 及其设备 ID」；发现服务器运营者可将设备地址与 IP 关联（来源：docs.syncthing.net/users/security.html "Information Leakage" 一节，2026-10-22）。对隐私敏感的内网场景可关闭全局发现仅留本地发现。

3.3 连接与中继（连不上怎么办）

找到地址后，Syncthing 按优先级选择连接方式（来源：docs.syncthing.net/users/relay.html + config 默认值，2026-10-22）：

官方说明：中继用于「身后有严格防火墙/NAT 导致无法直连」的兜底场景，数据本身仍是端到端 TLS 加密、中继无法读取内容（来源：docs.syncthing.net/users/relay.html "Relaying... the traffic is encrypted end to end"，2026-10-22）。如对官方中继不放心，可用 syncthing-relaysrv（v2 独立 deb 包）自建中继服务器（来源：GitHub syncthing/docs relay 自建说明，2026-10-22）。

3.4 进程与端口清单

来源：docs.syncthing.net/users/firewall.html（FAQ "Ports" 页），2026-10-22。

3.5 进程内部模块（源自 serve 的 STTRACE 包清单）

syncthing serve 暴露的调试包清单本身就是架构模块图（来源：syncthing 官方 serve --help 的 Logging Facilities 一节，2026-10-22）：

四、核心功能特性

（来源：syncthing.net 官网 Features 与 docs.syncthing.net/users/，2026-10-22）

五、快速开始（最小可用示例）

以下最小流程摘自官方文档（来源：docs.syncthing.net/users/ 与 syncthing.net/downloads/，2026-10-22；命令在本专栏部署篇中已逐条实测并给出真实回显）：

1. 安装（Debian/Ubuntu 官方 apt 源）：

# 导入官方签名密钥（来源：syncthing.net/downloads/，2026-10-22）
curl -o /usr/share/keyrings/syncthing-archive-keyring.gpg https://syncthing.net/release-key.gpg
# 写入 apt 源（v2 系列用 stable-v2 组件，详见部署篇）
echo "deb [signed-by=/usr/share/keyrings/syncthing-archive-keyring.gpg] https://apt.syncthing.net/ syncthing stable-v2" > /etc/apt/sources.list.d/syncthing.list
apt-get update && apt-get install syncthing

2. systemd 托管启动（模板服务 syncthing@用户名）：

systemctl enable --now syncthing@yourname

3. 浏览器打开 http://127.0.0.1:8384 进入 Web GUI，添加另一台设备的 Device ID 互信后即可建立同步。

完整的逐条命令、真实回显、排障实录见 《Ubuntu 22.04 安装 Syncthing 指南》。

六、适用场景与限制

6.1 适用场景

6.2 限制与不适用

（来源：docs.syncthing.net/users/FAQ 与 config 文档夹类型/版本器章节，2026-10-22）

七、同类选型对比

7.1 候选对象与量化数据

量化列均实查于 2026-10-22：星数与最新 release 取自 shields.io GitHub 徽章（GitHub 仓库页同一数据源）；许可证与语言取自各项目官方仓库/官网；Resilio Sync 为商业闭源软件，无公开代码仓库，星数列以「闭源」标注。

7.2 关键差异解读与选型建议

• 同步模型：只有 Syncthing、Resilio 是「持续运行、双向、多设备全互联」；Unison 是「手动/定时触发、双向、两两同步」（冲突需人工处理）；rsync 是「单向命令行传输」，多设备同步要自己编排脚本。
• 控制面：Syncthing 每设备自带 Web GUI + REST API，适合无头服务器；Nextcloud 有完整 Web 门户（分享链接、在线预览、日历/通讯录生态），但所有流量与存储压在服务器上。
• 信任模型：Syncthing/Unison/rsync 开源可审计；Resilio 闭源，官方免费版有功能限制（如 SyncHome 高级特性付费）。
• 「如果……则……」选型：
  • 如果要在自己的多台设备间持续同步且数据不落第三方 → Syncthing；
  • 如果要对团队/公众提供文件门户、分享链接、在线办公 → Nextcloud；
  • 如果设备可安装闭源软件、追求 BT 级大文件分发性能且接受商业许可 → Resilio Sync；
  • 如果只有两台机器偶发双向同步、可接受手动触发与冲突处理 → Unison；
  • 如果只是脚本化单向备份/传输（不做持续同步）→ rsync。
• 版本节奏提示：本表版本号为查询日（2026-10-22）的最新稳定版，选型时建议复查各官方发布页。

八、参考链接

1. Syncthing 官网：https://syncthing.net/
2. 官方下载与 apt 源说明：https://syncthing.net/downloads/
3. 官方文档（安全模型/发现/中继）：https://docs.syncthing.net/users/security.html 、https://docs.syncthing.net/users/relay.html
4. GitHub 仓库：https://github.com/syncthing/syncthing
5. 本专栏部署篇：《Ubuntu 22.04 安装 Syncthing 指南》
6. 本专栏配置篇：《Syncthing 2.1.7 配置参数详解》
7. 本专栏命令篇：《Syncthing 2.1.7 常用 CLI 命令与工具详解》