遇到Syncthing添加了远程设备后，设备状态一直显示“Disconnected”，或日志反复提示“no connection to device”？

这通常是网络可达性、身份验证或服务状态出了问题。以下是从基础到深入的排查指南，能帮你一步步定位并解决问题。

一、验证设备ID与配对状态

连接失败，首先要检查设备ID是否正确，以及配对是否完成。Syncthing要求双方设备必须互相确认。

操作步骤如下：

• 在源设备的Web管理界面（通常是 http://127.0.0.1:8384），点击「设备」→「添加远程设备」，粘贴目标设备的完整ID。
• 立刻前往目标设备的Web界面，进入「操作」→「显示设备 ID」，仔细核对ID是否完全一致。注意大小写和连字符。
• 在目标设备界面右上角，检查有无等待处理的配对弹窗。如有，点击「接受」；如无，可尝试刷新页面或重启Syncthing服务。
• 最后，确认双方设备列表中，对方的「地址」字段不为空。若为空，通常意味着自动发现失败，需要进入下一步，手动指定地址。

二、检查本地网络发现与端口连通性

Syncthing默认依赖局域网广播（UDP端口21027）来自动发现设备。若网络有隔离或防火墙严格，此机制会失效。

此时需手动指定地址并测试核心同步端口（TCP 22000）：

• 在源设备的「设备」设置页面，找到目标设备，点击「编辑」图标，展开「地址」栏。
• 删除默认的 dynamic 条目，手动添加目标设备的局域网IP和端口，格式如：tcp://192.168.1.100:22000（请替换为真实IP）。
• 在源设备的命令行终端，执行连通性测试：nc -zv 192.168.1.100 22000。若返回“succeeded”则端口通畅；若超时或被拒绝，则问题可能在防火墙或路由器。
• 同时，在目标设备上确认Syncthing正在监听该端口。运行 lsof -i :22000（Linux/macOS）或 netstat -ano | findstr :22000（Windows），查看输出中是否有Syncthing进程。

三、排查防火墙与网络策略限制

系统防火墙或路由器设置（如AP隔离）可能阻断Syncthing流量。

排查方法：

• 为快速判断，可在目标设备上临时关闭系统防火墙（Linux: sudo ufw disable；Windows：在高级安全防火墙中暂时禁用相关入站规则）。
• 检查Wi-Fi路由器设置。登录管理后台，查找「AP隔离」或「客户端隔离」功能。此功能开启会阻止同一Wi-Fi下的设备间直接通信，必须关闭。
• 对于Windows用户：打开「Windows Defender 防火墙」→「允许应用通过防火墙」，确保 syncthing.exe 同时拥有“专用网络”和“公用网络”的通行权限。
• 若设备不在同一局域网或需从外网访问，则需在路由器上设置端口转发：将外部端口22000的TCP/UDP流量，转发到内部目标设备的IP地址和22000端口。

四、验证 Syncthing 守护进程运行状态

问题可能出在Syncthing服务本身，如未启动、崩溃或端口被占用。

验证步骤：

• 在目标设备终端，确认Syncthing进程正常运行：使用 ps aux | grep syncthing（Linux/macOS）或 tasklist | findstr syncthing（Windows）命令检查。
• 若未找到进程，手动启动：syncthing -no-browser -logflags=0。注意观察终端输出，如出现“address already in use”报错，说明端口被占用。
• 若日志提示“failed to load config”或“invalid json”，可能是配置文件损坏。建议先备份 ~/.config/syncthing/config.xml 文件，然后删除它，重启Syncthing以生成全新默认配置。
• 最后，在源设备的Web界面，点击「操作」菜单，选择「重启」。此操作可强制刷新连接状态，有时能清除因缓存导致的“假离线”。

五、检查 .stfolder 标记与文件夹同步状态

设备连接可能已正常，但同步未开始。这常因共享文件夹状态有问题，Syncthing拒绝建立数据通道。

检查与修复：

• 在目标设备上，找到用于接收文件的共享文件夹根目录。确认其中存在名为 .stfolder 的隐藏文件夹。若无，请手动创建空文件夹，并确保运行Syncthing的用户有读写权限。
• 回到源设备的Web界面，进入「文件夹」页面。找到对应共享文件夹，点击「编辑」，查看「状态」列。若显示“已暂停”或“忽略”，点击旁边的「恢复」按钮。
• 在目标设备终端，进入共享文件夹路径，执行 ls -la | grep stfolder。检查 .stfolder 文件夹的所有者是否与运行Syncthing的用户一致。若Syncthing非root运行，则该文件夹不应属于root。
• 若文件夹状态长时间显示“扫描中”，可尝试右键点击该文件夹，选择「立即扫描」。若仍缓慢，需考虑磁盘I/O负载是否过高（如NAS正处理繁重任务），导致响应延迟。

《夸克》非常好用的免费AI浏览器

下载APP查看