工具与效率

Syncthing 文件同步实践:连接两台设备并处理冲突与误删

笔记本上改完方案,台式机还留着旧稿,于是又把整个目录复制一遍——这是很多人用 Syncthing 之前的日常。Syncthing 能让两台设备持续交换文件变化,但它也会传递删除:一端清理了文件,另一端可能跟着消失;两端同时改同一份文件,则会留下需要自己整理的冲突副本。下面用两台设备的离线修改和重新连接实验,走一遍设备配对、文件夹共享、冲突处理和误删恢复,并划清同步与备份的边界。

两台设备通过 Syncthing 同步文件并产生冲突副本的示意图

先理解 Syncthing 在同步什么

Syncthing 是一个开源、去中心化的文件同步工具。它不依赖中心服务器保存你的文件,而是让设备之间直接建立连接,交换文件索引和内容块。设备配对只是让两端“认识”,真正决定哪些文件参与同步的是文件夹共享:每个共享文件夹有一个文件夹 ID,两端路径可以不同,但文件夹 ID 必须对应同一份资料。

同步的基本流程是:本地扫描文件变化,生成索引,与其他设备交换索引,按需传输缺失的块。删除也是一种变化,会被同步到另一端。冲突则发生在两端对同一文件产生了不同版本,Syncthing 不会自动合并文档内容,而是保留一份冲突副本,让你人工处理。

文件夹模式有三种:发送与接收适合两端都编辑;仅发送适合一端作为权威源,只向外分发;仅接收则只接收远端改动。普通用户从发送与接收开始即可。

环境准备:从测试目录开始

准备两台能互相访问的设备。安装 Syncthing 的方式很多:Debian/Ubuntu 可以用 sudo apt install syncthing,macOS 可以用 brew install syncthing,Windows、NAS、Android 也有对应包或客户端。也可以选择 Docker 部署,但本文不展开容器细节。安装后启动服务,默认 Web 管理界面在 http://127.0.0.1:8384。

这里有一条安全底线:不要把 Web GUI 直接暴露到公网。默认只监听本机是合理的,需要远程管理时优先走 VPN 或 Tailscale、WireGuard 这类私有网络,而不是在公网开放 8384 端口再配一个弱密码。

同步目录从测试目录开始。新建一个只放可丢弃文件的文件夹,确认自己理解共享范围后,再逐步加入重要资料。不要一上来就把整个家目录、运行中的数据库或唯一一份正式资料加进去。运行 Syncthing 的用户需要对目录有读写权限,但不要用 root 跑,也不要用 chmod 777 绕过权限问题。

设备配对与文件夹共享

添加设备 ID

在 A 端 Web GUI 的“操作”或“设备”页面找到本机设备 ID,是一串长字母数字。在 B 端选择“添加设备”,填入 A 的设备 ID 和名称,保存。A 端会收到新设备连接提示,确认后两端建立连接。连接成功后,界面可能显示“已连接(未使用)”——这表示设备认识了,但还没有共享任何文件夹。

共享文件夹

在 A 端添加文件夹,填写文件夹 ID、本地路径,然后在“共享”标签勾选 B 端。B 端随后会出现接收新文件夹的提示,确认时可以选择自己的存放位置。两端路径可以不同,文件夹 ID 要一致。

验证同步时,在 A 端放入几个文件和子目录,触发扫描,等 B 端收到后逐个打开核对。中文文件名和子目录通常能保留,但仍要实际读回内容,不要只看界面上的“已同步”。如果两端都在同一台机器上测试,注意使用不同端口和不同配置目录,避免两个实例互相干扰。

离线修改实验:冲突从哪来

现在做关键实验:让两台设备离线修改同一份文件。

在 A 端和 B 端都暂停该文件夹的同步,或者直接断开网络。然后在 A 端把 会议记录.md 改成版本 A,在 B 端把同一文件改成版本 B。两端都保存后,恢复连接。

Syncthing 重新交换索引时会发现:同一个文件在两端都有了新版本,且无法判断哪个更新。它不会覆盖其中一份,而是保留一份为冲突副本,文件名通常类似 会议记录.sync-conflict-20250101-120000-ABCDEF.md。原文件和冲突副本都会留在目录里。

冲突文件不等于文件损坏。它表示“有两份都有效的改动”,是 Syncthing 保留双方成果的方式。处理方法是:打开原名文件和 .sync-conflict 副本,对比内容,把需要的东西合并进其中一份;确认后删掉多余的另一份。合并完删掉多余那份,这一页就翻过去了。

Syncthing 版本恢复与冲突文件合并的示意图

如果冲突频繁出现,说明两端同时编辑同一文件的频率太高。可以约定“同一时间只在一端编辑”,或者把文档拆成不同文件,减少冲突概率。Syncthing 不会替你合并 Word、Markdown 或代码内容,人工比较这一步省不掉。

删除传播实验:为什么同步不等于备份

在 A 端删除一个测试文件,等 B 端同步。你会看到 B 端也删除了它。这是同步工具的正常行为:一端删除,另一端跟着匹配。问题在于,误删也会这样传播。

如果提前启用了版本控制,误删后还有恢复入口。Syncthing 的文件夹设置里可以启用版本控制,常见策略有“回收站”和“交错版本”等。启用后,旧版本会保存在文件夹内的 .stversions 目录,或者你指定的版本路径。在 Web GUI 的文件夹版本入口可以查看并恢复。恢复后,文件会重新同步回另一端。

如果没有启用版本控制,误删又已经同步到所有设备,恢复就只能靠独立备份、系统快照或文件系统快照。紧急情况下,先暂停其他设备的同步或关机,减少删除继续扩散,再从备份里找回。

版本控制不是无限备份。交错版本有保留期限和磁盘占用,回收站也可能被清理。重要资料仍然要另存一份不参与同步的备份,比如外置硬盘、NAS 快照或云存储的独立副本。Syncthing 官方社区也反复强调:同步不等于备份。

冲突与删除的边界设置

Syncthing 有一个高级选项 ignoreDelete,可以让某台设备忽略远端传来的删除。官方文档对它的警告很直接:除非你清楚自己在做什么,否则应保持 false(官方文档)。开启后,一端删除文件,另一端不会删,但两端对“谁是最新”的判断会不一致,后续可能出现持续的状态偏差。普通用户不建议开启。

如果一端是权威源,可以考虑把该文件夹设为“仅发送”。这样它只向外分发改动,不应用远端修改。远端如果出现改动,仅发送端会出现“覆盖更改”按钮,用来把远端拉回自己的版本。实验结束后再恢复为发送与接收。

忽略模式也要两端保持一致。如果一端用 .stignore 忽略了某些文件,另一端没有忽略,就可能出现“目录已被远程删除但本地非空”之类的提示。大小写敏感、符号链接、文件权限在不同系统间也有差异,跨平台同步前最好先小范围验证。

故障排查清单

设备显示未连接:检查设备 ID 是否填错、两端网络是否互通、发现服务器和中继是否可用,以及防火墙是否拦截。局域网内可以尝试手动添加地址。

文件夹没有共享:确认文件夹 ID 两端一致,共享标签里勾选了对方设备,B 端已经接受并选择了本地路径。

权限错误:检查运行 Syncthing 的用户是否对目录有读写权限,目录属主和挂载权限是否匹配。不要用 777 权限掩盖问题。

出现冲突副本:人工比较合并,删除多余副本。不要直接删除原文件。

删除没有同步:检查是否开启了 ignoreDelete,或者两端忽略模式不一致。也可能是某台设备离线,重新上线后会补同步。

状态长期不一致:暂停文件夹再恢复,触发重新扫描,查看日志中的具体错误。必要时先备份目录,再排查。

适合谁,不适合谁

Syncthing 适合经常在多个位置使用同一组文件、愿意先练习同步流程、能够处理冲突并安排独立备份的人。它不适合只想临时发送一份文件、不想做设备配对的人,也不适合希望自动合并文档内容或无限保留所有历史版本的人。

把两台设备连起来只是第一步。真正影响数据安全的,是提前启用版本控制、理解删除会同步、遇到冲突先保留两份,以及始终保留一份不参与同步的备份。做到这些,Syncthing 才能成为可靠的同步工具,而不是一次误操作的放大器。

热门话题

52okp 是一名关注人工智能、开源软件与效率工具的技术内容创作者,长期实践 Stable Diffusion、ComfyUI、AI 智能体、MCP、Codex 和各类开源项目。通过实际安装、配置与测试,整理可复现的操作教程、问题排查方法和工具使用经验。

登录用户才能发表评论! 登录账户

取消回复

评论列表 (1条):

加载更多评论 Loading...

延伸阅读:

用 FastCopy 搬迁办公大文件:参数调优、哈希校验与防中断策略

每次用 Windows 自带的复制粘贴搬几十 GB 的设计稿、项目文件或数据库备份,中途弹个“无法复制”的对话框让你整晚...

52okp
2026-11-03

Gitea 自托管入门:搭建小团队代码仓库并验证备份恢复

小团队想把代码留在自己控制的服务器上,又需要成员协作和权限管理,可以考虑 Gitea。它是自托管的 Git 服务,除了代...

52okp
2026-11-20

LaVague 浏览器自动化评估:把自然语言查询变成 Selenium 代码靠谱吗

每次回归测试都要打开页面、找到入口、点击,再确认结果;如果页面改了,脚本里的元素定位也可能跟着失效。LaVague 的吸...

52okp
2026-10-20

开源项目值得部署吗?用维护状态、文档与许可证做一轮检查

你在 GitHub 上找到一个工具,README 的演示正好解决眼前的问题,于是准备把它部署到团队环境。真正需要确认的却...

52okp
2026-10-16

用 7-Zip 分卷压缩并校验大文件:设置分卷大小、密码和解压检查

大文件受网盘、邮箱附件或 FAT32 单文件限制时,7-Zip 可按指定大小分卷,并为 7z 格式设置 AES-256 ...

52okp
2026-10-04
    返回顶部