2745 字
14 分钟
文件同步实战:Syncthing 点对点同步与备份
2026-11-15

先说主线:网盘之外,为什么还需要「同步」#

网盘系列的 Cloudreve 解决的是「文件放在哪儿」,这一篇解决的是「文件怎么在设备之间自己流动」。日常场景是这样的:电脑上改了一份文档,希望手机立刻能看;相机拍的照片,希望回家自动躺进电脑硬盘;服务器上的配置,希望本地留一份随时能改。

这类需求用网盘也能凑合,但要么靠手动上传下载,要么依赖公共云的同步客户端。Syncthing 是更纯粹的解法:开源、点对点(P2P)、不经过任何中心服务器,文件只在你自己的设备之间直连传输,加密、实时、多端,特别适合「我的文件只在我自己的设备之间转」这个场景。

部署形态有两种,本文的主线是:

  • 每台要同步的设备(电脑、手机)装 Syncthing 客户端
  • VPS 上用 Docker 再跑一个节点,作为 7×24 在线的「中转站 + 常驻副本」
  • 讲清文件夹类型、版本控制、忽略规则和冲突处理
  • 最后把最重要的概念钉死:同步不是备份,同步要配合版本控制和独立备份才安全。

Syncthing 的工作方式#

Syncthing 没有「云端」概念,每台设备是一个节点,节点之间靠设备 ID 互相识别、双向配对后才开始同步。文件变化会被切成块做增量传输,改一个大文件只传变化的部分。节点发现靠全球发现服务器和局域网广播,真正传文件时优先直连,连不上才走公共中继——中继只转发加密流量,看不到内容,但自建玩家也可以连中继都不用,只在自己的设备间组网。

几个关键概念先建立起来:

概念含义
设备 ID每台设备一串唯一 ID,配对靠它,相当于「手机号」
文件夹一个同步单元,有自己的 ID、路径和同步类型
文件夹类型发送与接收 / 仅发送 / 仅接收,决定数据流向
版本控制文件被覆盖或删除时保留历史版本,是防误删的关键
忽略规则.stignore 文件,排除缓存、临时文件等不想同步的内容

VPS 节点:Docker 部署#

官方镜像 syncthing/syncthing。VPS 节点的作用是常驻在线:电脑关机、手机离网时,文件先同步到 VPS 攒着,其他设备上线再取走,不用等两台设备同时在线。

services:
syncthing:
image: syncthing/syncthing:latest
container_name: syncthing
hostname: vps-node
restart: unless-stopped
environment:
- TZ=Asia/Shanghai
- PUID=1000
- PGID=1000
ports:
- "127.0.0.1:8384:8384" # Web 管理界面,只绑本机走反代
- "22000:22000/tcp" # 同步传输(TCP)
- "22000:22000/udp" # 同步传输(QUIC)
- "21027:21027/udp" # 局域网发现,公网 VPS 可不开
volumes:
- ./config:/var/syncthing/config
- ./sync:/var/syncthing/sync

要点:

  • 22000 是设备间传文件的端口,必须对公网放行(或至少对你其他设备所在网络放行),否则只能绕中继,速度慢且不稳定;它传的是加密流量,暴露本身没有数据泄露风险
  • 8384 管理界面只绑 127.0.0.1,通过 Nginx Proxy Manager 反代出来并套 HTTPS
  • 同步目录挂在 ./sync 下,每个同步文件夹在里面建一个子目录,路径固定方便备份

启动后打开管理界面,第一件事是给 Web 界面设账号密码(设置 → 常规 → GUI 认证),然后记下本机设备 ID(操作 → 显示 ID),配对要用。

客户端安装与设备配对#

  • Windows / macOS / Linux:官网下载,或用包管理器安装;想要开机自启和托盘图标,Windows 可用 SyncTrayzor 这类官方推荐的封装
  • Android:官方 App(应用商店或 F-Droid),注意给足后台运行和存储权限,否则同步会断断续续
  • iOS:没有官方客户端,有第三方付费应用(如 Möbius Sync),体验尚可但不如安卓原生顺畅,这是选设备时要提前知道的现实

配对流程在任意一端操作即可:

  1. 在 VPS 管理界面点「添加远程设备」,填入电脑的设备 ID,给它起个名
  2. 电脑端会弹出新设备请求,确认接受
  3. 反过来在电脑端也能看到 VPS 已配对——双向确认过才算配对成功

配对完成后,再共享文件夹:选中文件夹 → 编辑 → 共享 → 勾选要同步到的设备。对方界面会弹出「新文件夹」邀请,选好本地存放路径再接受。第一次全量同步大文件夹时耐心等索引和传输完成,状态显示「已同步」才算落地。

文件夹类型:同步方向要想清楚#

这是最容易配置错、又最重要的一组设置:

类型行为典型用途
发送与接收双向同步,任何一端改动都互相同步工作文档、多设备协作目录
仅发送本端改动推出去,不接受对端改动手机相册 → 电脑/VPS 单向归档
仅接收只收对端改动,本端修改会被对端版本覆盖VPS 上的分发目录、镜像副本

两个经典配置:

  • 手机相册:手机端设「仅发送」,VPS 端「仅接收」。照片只流向服务器,手机上删照片不会把服务器上的删掉(配合下面要讲的版本控制更稳)
  • 工作中转目录:所有设备「发送与接收」,哪台设备改了都自动散布到其他设备
WARNING

「仅接收」文件夹里手动改了文件,Syncthing 会认为本地版本与全局不一致并显示「本地新增」,下次同步可能被覆盖。只读归档目录就只让它收,不要在里面直接编辑;要改文件,去源头设备上改。

版本控制:防误删的保险丝#

同步最大的风险是「错误也会被同步」:在一台设备上误删或误改,全网设备一起遭殃。Syncthing 的版本控制(文件夹 → 高级设置 → 文件版本控制)就是保险丝,被覆盖、被删除的文件会先挪进 .stversions 目录留档。

四种模式:

模式说明建议
无版本控制直接覆盖删除只用于纯缓存类目录
回收站式旧版本移到 .stversions,可设保留天数通用首选,如保留 30 天
简单版本控制按数量保留最近 N 个版本文档类目录,保留 5–10 个
交错版本控制按时间密度保留多个时间点的版本重要长期目录

给 VPS 节点的工作目录开「回收站式、保留 30 天」是性价比最高的默认:多占一点磁盘,换误删后一个月内可回滚。注意 .stversions 本身不参与同步,它是每台设备本地的留档,所以常开机的 VPS 节点留档最可靠。

忽略规则与冲突处理#

不想同步的东西用文件夹根目录下的 .stignore 排除,一行一个模式:

(?d)Thumbs.db
(?d).DS_Store
*.tmp
~$*
node_modules

(?d) 表示「如果对端删除了它,本地也允许删」,适合缓存类文件。注意:.stignore 本身可以作为普通文件同步到各端,保持各端规则一致,省得一台一台改。

冲突文件是双向同步的日常:两台设备离线时改了同一个文件,重连后 Syncthing 会保留一份胜出版本,另一份改名为 文件名.sync-conflict-日期-设备.后缀 放在旁边。冲突文件不会自动合并,也不会有人提醒你,重要目录要定期搜一下 sync-conflict 关键字手动处理,养成习惯能避免「我改的那版到底去哪了」的灵异事件。

同步不等于备份:怎么组合才完整#

再强调一遍逻辑:同步保证的是「每台设备上都有一份」,但如果文件被勒索软件加密、被误删且过了版本保留期,所有副本会一起完蛋。完整的方案是分层:

  1. Syncthing 负责流动:文件在设备间实时同步,VPS 节点常驻兜底
  2. 版本控制负责回滚:30 天内的误改误删能找回
  3. 独立备份负责兜底:VPS 上的同步目录再按 自建服务备份与迁移实战 的节奏,定期打包同步到另一台机器或对象存储——这份备份不参与实时同步,灾难时它是最后一根稻草

另外 VPS 节点本身也别当成保险箱:它同时在线、同时可达,真出事时和其它节点是一根绳上的蚂蚱。独立的、离线的或异地的备份副本才是备份。安全边界和暴露面控制可以再看 自建服务安全加固。

常见问题与排障#

设备显示「已断开」 按顺序查:22000 端口在 VPS 防火墙和云厂商安全组里是否放行(TCP+UDP)、设备 ID 是否填错、两端时间是否差太多。管理界面设备详情里能看到连接方式是直连还是中继,走中继且速度慢,基本就是端口没通。

文件夹卡在「正在扫描」或同步不动 大文件夹首次扫描要时间,先看 CPU 和进度百分比。若某文件一直报错,多为权限问题或文件名包含对端系统不支持的字符(如 Windows 不允许的 :),改名即可。

手机同步时好时坏 安卓的电池优化在杀后台。给 Syncthing 关闭电池优化、允许后台运行,并打开「在 Wi-Fi 下同步」等条件设置里的开关;国产 ROM 还要在自启动管理里放行。

磁盘被 .stversions 吃满 版本保留策略太宽或同步了频繁变动的大文件目录。调小保留天数/份数,并把日志、缓存类目录用 .stignore 排除,版本控制只给真正重要的目录开。

两台设备版本不一致 不要跨太多个大版本混跑,客户端保持自动更新即可;VPS 的 Docker 镜像定期 docker compose pull 更新,更新前看一眼官方发布说明。

小结#

Syncthing 是自建文件体系里最「润物细无声」的一件:配好之后,文件在自己的设备之间安静流动,不经过任何第三方。记住三条就够了:相册类目录单向发送、工作目录双向同步、所有重要目录都开版本控制;再叠一层独立备份,同步才真正等于安心。它和 Cloudreve 是互补关系——网盘管归档与分享,同步管日常流动,两件一起上,文件这块就再没什么可操心的了。

文件同步实战:Syncthing 点对点同步与备份
https://www.anexns.cloudns.org/posts/selfhost-file-sync/
作者
Anexns
发布于
2026-11-15
许可协议
CC BY-NC-SA 4.0