Syncthing 系列目录
- Syncthing 怎么用?从设备配对到文件同步的实用笔记
- 用 Docker 部署 Syncthing:Compose、端口和目录映射避坑
- Syncthing 多设备怎么配?对等网络、星型拓扑和引入者
- Android 上怎么用 Syncthing?Syncthing-Fork 配置与照片备份
- Syncthing 多设备多文件夹怎么管理?拓扑、命名和版本控制
- Syncthing 如何同步 iPhone 照片到电脑或 NAS
Syncthing 采用的是去中心化 P2P 架构。它没有传统意义上的 Server 和 Client,每台设备在协议层面都是对等节点。
但在实际使用时,你可以把它配置成两种形态:
- 纯对等网络:每台设备都和其他设备直接配对。
- 星型网络:指定一台 NAS、服务器或常开电脑作为中心节点,其他设备只和它配对。
两种方式都符合 Syncthing 的设计,只是管理成本和使用习惯不同。
先理解“对等”和“伪服务器”
Syncthing 里的每台设备都有自己的 device ID。只要两台设备互相添加对方 ID,并且共享同一个文件夹,它们就能同步。
所以,Syncthing 本身没有“服务器端必须保存所有数据”这个概念。你看到的“服务器”,往往只是人为指定的一台常开设备。
比如:
- NAS 长期开机、空间大,适合作为中心节点。
- 手机和笔记本经常离线,适合作为边缘设备。
- 台式机性能强,但不一定 24 小时开机,可以作为普通同步节点。
这个“中心节点”不是协议上的服务器,而是你在拓扑设计中让它承担管理和中转角色。
模式一:纯对等 Mesh 网络
纯对等模式下,每台设备都和其他所有设备配对。
例如你有四台设备:
- NAS
- 台式机
- 笔记本
- 手机
那么每台设备都要和另外三台设备建立连接。这样任何两台在线设备之间都可以直接同步。
优点:
- 传输路径更直接。
- 某台设备离线时,其他在线设备仍然可以互相同步。
- 不依赖某一个中心节点。
缺点:
- 设备越多,配对关系越复杂。
- 新增设备时,需要在多台旧设备上确认和配置。
- 文件夹共享关系容易散。
设备数量少时,纯对等模式很舒服。比如只有一台电脑和一台手机,或者两台电脑互相同步笔记,就不需要想太复杂。
但当设备数量变成五六台以上,手动维护全连接关系会越来越麻烦。
模式二:以 NAS 为中心的星型拓扑
星型模式更适合家庭和个人生产力场景。
做法是:选一台长期开机、空间足够、网络稳定的设备作为中心节点,例如:
- NAS
- 群晖
- 软路由
- 迷你主机
- 家用 Linux 服务器
然后其他设备只和它配对:
|
|
手机不需要直接配对笔记本,笔记本也不需要直接配对台式机。它们都通过 NAS 间接同步数据。
优点:
- 管理简单。
- 新增设备只需要和 NAS 配对。
- NAS 可以承担版本保留和备份缓冲。
- 适合 24 小时在线同步。
缺点:
- NAS 离线时,其他设备之间不一定能继续同步。
- 如果所有流量都经过 NAS,NAS 的网络和磁盘性能会影响体验。
- 中心节点权限要管理好。
如果你已经有 NAS 或常开小主机,优先推荐星型拓扑。它保留了 Syncthing 的 P2P 能力,又让日常管理更接近“中心化同步”。
多设备配置的基本顺序
不管用哪种拓扑,Syncthing 的配置顺序都是:
- 先配对设备。
- 再共享文件夹。
- 最后在接收端确认路径。
不要反过来一开始就到处建文件夹。先把设备关系理清楚,后面才不容易乱。
第一步:设备互联
假设要连接设备 A 和设备 B。
设备 A 可以是手机,设备 B 可以是 NAS 或电脑。
在设备 A 上:
- 打开 Syncthing Web UI。
- 点击右上角
操作。 - 选择
显示 ID。 - 复制设备 ID,或者显示二维码。
在设备 B 上:
- 打开 Syncthing Web UI。
- 点击
添加远程设备。 - 填入设备 A 的 ID。
- 给设备起一个容易识别的名称,例如
My-Phone。 - 保存。
然后回到设备 A。它通常会弹出提示:设备 B 想要连接。点击接受。
到这一步,两台设备已经建立了对等关系,但还没有开始同步任何文件夹。
第二步:创建并共享文件夹
在设备 A 上点击 添加文件夹。
常用字段:
- 文件夹标签:给自己看的名字,例如
Notes。 - 文件夹 ID:跨设备识别用,建议用稳定英文,例如
notes。 - 文件夹路径:这台设备上的真实路径。
然后切换到 共享 标签页,勾选刚刚配对成功的设备 B。
保存后,设备 A 会把这个文件夹共享邀请发给设备 B。
第三步:接收共享
打开设备 B 的 Web UI,等待几秒钟,通常会看到提示:
|
|
点击添加,然后在设备 B 上指定本地存储路径。
例如:
|
|
或者 Docker 部署场景下的容器内路径:
|
|
保存后,同步正式开始。
这里要注意:不同设备上的路径可以不一样。Syncthing 通过文件夹 ID 识别同步关系,不要求每台设备使用相同的本地路径。
星型拓扑怎么配置
如果你采用 NAS 中心模式,建议这样做:
- 先在 NAS 上部署 Syncthing。
- 所有手机、电脑、服务器都只和 NAS 配对。
- 在 NAS 上创建或接收主要同步文件夹。
- 每台新设备只添加 NAS 的 device ID。
- 需要同步哪个文件夹,就在 NAS 和对应设备之间共享。
例如:
|
|
这样结构非常清楚。你可以把 NAS 当作同步关系的控制面。
引入者是什么
Syncthing 有一个很实用的功能:Introducer,中文界面里通常叫“引入者”。
它适合多设备场景。
假设你把 NAS 设置为引入者。之后新设备只要和 NAS 配对,NAS 就可以把它知道的其他设备介绍给新设备,也可以帮助同步已有的共享关系。
这样做可以减少重复点击和重复配对。
适合:
- 家里有多台电脑和手机。
- NAS 作为长期中心节点。
- 经常新增设备。
- 希望减少手工维护设备关系。
但也要注意,引入者会扩大自动建立关系的范围。不要把不完全信任的设备设为引入者,也不要在不清楚拓扑的情况下随手勾选。
更稳妥的做法是:
- 只把 NAS 或主服务器设为引入者。
- 普通手机、笔记本不要设为引入者。
- 新设备加入后,检查它被自动添加了哪些设备和文件夹。
文件夹类型决定数据方向
Syncthing 的权限控制主要体现在文件夹类型上。
进入文件夹设置,在选项里可以调整 Folder Type。
常见三种:
Send & Receive
默认模式。双方都可以发送和接收变更。
适合:
- 多设备共同编辑笔记。
- 多台电脑同步文档。
- 普通双向同步目录。
这是最接近“真正对等”的模式。
Send Only
本机只发送,不接收其他设备的变更。
适合:
- 数据源头。
- 主目录向其他设备分发。
- 不希望远端修改影响本机。
例如你把 NAS 上的某个软件安装包目录设置为 Send Only,让其他电脑只接收。
Receive Only
本机只接收,不把本地改动发送出去。
适合:
- 备份机。
- 只读镜像。
- 防止本地误删反向影响主目录。
例如 NAS 用来接收手机照片,手机端删除照片时,你不希望 NAS 也跟着删,就要认真设计文件夹类型和删除策略。
不同目录可以用不同拓扑
Syncthing 的拓扑不一定全站统一。你可以按文件夹设计。
例如:
notes:电脑、笔记本、手机、NAS 都使用 Send & Receive。photos:手机发送,NAS 接收并保留版本。downloads:NAS 和台式机同步,手机不参与。backup:主电脑 Send Only,NAS Receive Only。
不要把所有目录都套进一种规则。多设备同步真正重要的是数据方向,而不是设备数量。
冲突和误删要提前想
多设备同步最常见的问题不是配置失败,而是同步成功之后发生误删或冲突。
容易出问题的场景:
- 两台设备同时编辑同一个文件。
- 手机端应用自动清理目录。
- 一台设备路径填错,创建了空目录并同步过去。
- 把缓存、临时文件、工作区状态文件一起同步。
- NAS 端没有开启版本保留。
建议:
- 重要目录在 NAS 上开启文件版本。
- 使用
.stignore排除缓存和临时文件。 - 新文件夹第一次同步前,先用少量测试文件验证。
- 不确定删除策略时,不要把所有设备都设为 Send & Receive。
推荐配置
如果你有 NAS 或常开服务器,推荐直接使用星型拓扑:
- NAS 作为中心节点。
- NAS 和所有设备配对。
- 普通设备只和 NAS 配对。
- NAS 可以设为引入者。
- 不同文件夹按用途选择 Send & Receive、Send Only 或 Receive Only。
- 重要文件夹在 NAS 上开启文件版本。
- 新设备加入后,先共享一个测试文件夹确认路径和权限。
如果你只有两三台设备,而且都经常在线,可以用纯对等模式。它更直接,速度也可能更好。
总结
Syncthing 是 P2P 对等架构,但不代表你必须把所有设备配成复杂网状结构。
小规模设备可以用纯对等模式;设备多、有 NAS 或常开主机时,更建议使用星型拓扑。让 NAS 承担中心节点和引入者角色,其他设备只跟 NAS 建立关系,管理会简单很多。
真正要想清楚的是:哪些设备可信、哪些目录要同步、数据从哪里来、误删时谁负责保留版本。拓扑只是手段,数据流向才是配置的核心。