Syncthing 不同步但设备在线：检查扫描、连接与文件冲突

Syncthing 不同步，即使对端在线，也要分别检查设备和文件夹。确认目标设备共享同一个文件夹，等扫描完成，读取本地错误，并核对具体文件内容，不只看连接图标。

关键要点：

• 设备已连接，不证明目标文件夹在两端都共享且可写。
• 扫描、本地文件错误、发现与传输连接是不同阶段。
• 中继是受支持的连接路径，不表示安装损坏。
• 两端文件内容一致，并记录实际连接类型，才算恢复。

为什么设备在线，Syncthing 不同步？

设备连接与文件夹同步状态回答不同问题。对端可达时，目标文件夹仍可能未共享、暂停、扫描中或无法在本地写入。官方 FAQ 介绍文件夹排障，也解释同步不能当成独立备份。［1］

调整发现或防火墙前，按下表检查。多个无关应用也失败时，先走设备与应用故障的一般分支；否则记录本任务具体对端、文件夹 ID 和错误。

观察结果	先检查什么	继续前需要的证据
对端已连接但目标文件夹缺失	共享和一致的文件夹 ID	两端已接受目标文件夹
文件夹显示扫描中	本地索引进度	扫描结束并识别预期文件
文件夹显示本地错误	空间、权限、标记或路径	具体本地故障安全解决
对端断开连接	设备 ID、发现与获准地址	目标设备建立获准连接
中继已连接但文件不同步	文件夹状态与文件错误	指定文件交付且可读取

步骤 1：两台设备共享的是目标文件夹吗？

通过正常受保护的访问方式，打开两台设备各自的本地 Syncthing 界面。用自己的记录或可信渠道核对设备 ID，确认是预期的一对设备；不要为了排障批准陌生配对。

比较两端文件夹 ID，并确认两端都将它共享给预期设备。本地标签与文件路径可以不同，因此看实际文件夹身份，而不是同名目录。检查待接受的共享邀请，不接受无关文件夹。

查看设备或文件夹有无暂停，文件夹类型是否刻意限制发送或接收。不要为了让状态对称就改变已设计的仅发送或仅接收安排。先询问文件夹负责人预期行为，再改配置。

怎样保护已有版本？

停止编辑受影响目录，将重要本地工作复制到独立备份位置。保留冲突版本并打开备份核对内容。Syncthing 会传播修改和删除，所以另一台同步设备不会自动保护你免受误操作影响。［1］

不要把删除再添加文件夹、改目录名称或重置数据库作为初始连接测试。这些动作会改变文件协调条件，可能影响哪些内容被当成新文件。诊断期间保留现有映射。

步骤 2：扫描完成了吗，还是本地错误阻塞？

分别查看两端文件夹状态。新建或变动文件树正在扫描时，等该阶段结束，观察进度是否推进。扫描负责枚举本地内容；它读不到文件系统时，反复换网络不能修复。

检查列出的本地文件错误、剩余空间和配置路径的可访问性。文件夹位于移动存储时，确认磁盘确实挂载在预期位置。按文件夹角色确认读写权限，不向整块磁盘授予宽泛权限。

官方 FAQ 说明文件夹标记通常是 .stfolder，并提醒清理工具可能移除它。缺少标记可能表示目录缺失或不健康，应先确认正确存储已就绪，再考虑恢复标记，不能盲目创建来遮住安全检查停止的原因。［1］

只有少量文件仍不同步怎么办？

读取列出的文件名和失败原因。文件占用、排除路径、权限失败或冲突，即使对端连接健康也需要单文件处理。不要因为一个文件失败就重建全部文件夹。

笔记目录使用这种方案时，要与Obsidian 官方 Sync 的连接问题区分。Syncthing 是另一套机制，此处成功不能诊断或修复 Obsidian 托管同步。测试时避免让多套同步系统管理同一工作目录。

步骤 3：Syncthing 中继连接能说明什么？

查看远端设备连接详情，记录当前是直连还是中继。直连不可用时，Syncthing 中继连接可以承载流量；官方说明文件内容端到端加密，中继吞吐量也可能变化。使用中继不是重装应用的理由。［2］

发现帮助设备找到地址，传输连接负责实际同步数据。因此发现对端，不等于交付文件；反过来，直连不可用而中继正常，也可能足够完成任务。

出现 Syncthing 设备断开连接时，确认远端电脑已唤醒且 Syncthing 进程运行，两端获准使用配置的发现与中继服务。组织防火墙或设备管理策略可能需要管理员批准，不是用户绕行。

应该强制直连吗？

诊断同步是否正常，不要求直连。记录当前连接类型并观察真实文件进度。官方 FAQ 提到 Windows 网络配置文件会影响直连，但这不授权你把不可信公共网络标成专用网络。［1］

Windows 中其他互联网访问与本任务不同，可比较系统代理配置与组织要求。不要假设浏览器代理控制每条 Syncthing 连接。保留安全控制，被阻断的协议交网络负责人处理。

步骤 4：获准公网路径能交付同一测试文件吗？

仅当共享、扫描和本地存储已准备好，且证据指向公网发现或中继可达性时进入此分支。目标对端只在企业私有网络可达时，保留认可的接入方式；消费级公网 VPN 不提供该网络成员资格。

在一端共享目录创建小型、无敏感内容的测试文件，使用唯一名称和容易辨认的内容，等扫描识别。保持发送端、接收端、设备 ID、文件夹 ID、客户端版本和文件不变，记录基线结果。

对于获准的公网路径测试，在发现或中继访问失败的受支持电脑连接 AethoVPN。Windows 用官方安装包；Linux 用 Debian/Ubuntu x64 的 .deb 包。Mac 需官网配置向导、VPN 客户端及 Pro 或 Premium。开启全局模式，选择当前可用的就近位置，等 Syncthing 重新连接后，观察同一文件的传输。

按连接与应用任务联合验证检查，再回到两端 Syncthing 界面。记录换路后的实际连接类型，查看接收端文件并对比发送端内容；不能用公网 IP 改变或网页可达替代交付证据。

该对照不能修复错误文件夹 ID、被忽略文件、磁盘错误或共享拒绝，也不承诺端口转发、局域网直通或 NAT 直连。新路径仍可能使用中继，或表现更差。需要试验获准公网中继分支时，可开始 3 天 Pro 免费试用；每名新用户仅一次。

怎样让对照仍然可解释？

只改变正在调查的那个端点的路径，同时连接两台电脑会增加变量。改文件夹或创建第二个测试文件，也不再是同一对象。记录哪个端点改变，测试结束后恢复原路径。

连接成功但文件仍阻塞时，停止换路，重新查看文件夹或本地错误。文件成功时，只描述该任务的路径相关证据，不能证明发现是唯一原因，也不能保证变成直连。

步骤 5：两端是否包含相同的完成版本？

测试文件须出现在预期接收目录，内容与发送端创建的内容一致。用合适本地应用打开两份副本，比较大小与内容，记录文件错误或冲突，不只看设备在线标签。

真实文档在核验期间应关闭编辑应用，确保比较的是同一已保存版本。修改时间单独不够，因为设备和文件系统可能表示不同。保留冲突副本，直到你主动选定正确工作版本。

策略禁止获准发现或中继服务、两条允许路径都失败，或本地修复将涉及重置文件夹时升级处理。通过可信支持渠道提供版本、时间、脱敏设备与文件夹资料、扫描状态、文件错误、连接类型和同文件结果。不公开 API 密钥、私有文件内容或配对邀请。

总结

• 先确认设备身份、文件夹共享和预期收发安排。
• 将本地扫描、文件系统错误与发现连接失败分开。
• 正常中继是有效路径，记录实际连接类型。
• 两端文件内容一致，才宣布同步恢复。

常见问题

为什么设备已连接还不能证明同步正常？

对端在线时，具体目录仍可能未共享、暂停、扫描或被本地错误阻塞。两端分别检查目标文件夹与指定文件，不只依赖设备指示。

两台电脑的本地路径必须相同吗？

不必。路径和标签可以不同，但两端必须共享预期文件夹身份并接受对应关系。比较文件夹 ID 与共享配置，不随意重映射重要工作。

VPN 能加快首次扫描吗？

换路径不能修复本地枚举、磁盘访问或权限失败。先等扫描结束，或处理明确本地错误，再测试公网发现和中继可达性。

用中继就说明连接需要修复吗？

不是。直连不可用时，中继是受支持连接方式。观察实际进度与内容，中继表现会变化，直连也不保证可建立。

缺少文件夹标记时应该立即重建吗？

先确认正确存储已挂载、配置路径健康。盲目重建可能隐藏目录不可用；保护数据，并按对应管理员或官方排障指引处理。

什么算成功的同文件测试？

接收端获得指定文件，内容与发送端已保存副本一致，并记录连接类型。设备已连接或网页可打开，单独不能证明文件交付。

可以把 Syncthing 当成唯一备份吗？

不可以。同步传播修改与删除，重要工作需要独立备份。保留冲突版本，主动决定恢复，不为让状态干净而直接删副本。

来源

1. Syncthing — FAQ — https://docs.syncthing.net/users/faq.html
2. Syncthing — Relaying — https://docs.syncthing.net/users/relaying.html

Sources checked 2026 年 10 月 7 日.

延伸阅读

• 单独排查 Obsidian 托管同步服务
• 用 Syncthing 实际同步检验 VPN
• 对照 Syncthing 与系统代理设置