Syncthing两设备建立信任需五种配对法：一、扫码配对；二、手动输入设备ID；三、IP显式指定；四、局域网自动发现；五、命令行提取验证ID，均需双方确认请求。
如果您在使用 Syncthing 时需要让两台设备建立信任并开始同步，但无法成功添加远程设备，则可能是由于设备 ID 输入错误、网络不可达或配对请求未被确认。以下是多种可行的设备配对连接方法：
一、二维码扫描配对法
该方法适用于移动端与桌面端之间快速建立连接，依赖视觉识别，无需手动输入长串字符，降低出错率。
1、在待添加为“远程设备”的一方（如安卓手机）打开 Syncthing-Android 应用，点击左上角菜单按钮，选择“Show device ID”。
2、界面将显示本机唯一的设备 ID 及其对应的动态二维码。
3、在另一台设备（如 Windows 或 macOS）的 Syncthing Web 管理界面（http://localhost:8384）中，进入“远程设备”页面，点击“添加远程设备”。
4、选择“扫描二维码”选项，使用设备摄像头对准手机屏幕上的二维码完成识别。
5、系统自动填充设备 ID 并提示输入设备名称，建议填写具有辨识度的名称（如“书房笔记本”），然后点击保存。
二、设备 ID 手动输入配对法
当无法使用摄像头或二维码失效时，可直接复制粘贴设备 ID 进行配对，适用于所有平台且兼容性最强。
1、在源设备（如 macOS）Syncthing Web 界面中，进入“操作”→“显示 ID”，完整复制显示的32位十六进制设备ID（含连字符）。
2、在目标设备（如 Linux 主机）Web 界面的“远程设备”页，点击“添加远程设备”。
3、在“设备 ID”字段中粘贴所复制的 ID，确保无空格、无换行、无截断。
4、填写设备名称，并勾选“自动接受文件夹共享”以简化后续同步配置。
5、点击“保存”后，源设备 Web 界面将弹出通知：“新设备请求添加”，需手动点击确认。
三、IP 地址显式指定配对法
该方法适用于跨网络环境（如异地设备）或局域网内因自动发现失败导致配对中断的情况，需主动声明通信地址。
1、在目标设备（如远程 Windows 电脑）Syncthing 配置文件中，确认监听地址已由默认的127.0.0.1:8384 修改为 0.0.0.0:8384，并开放端口 22000 的入站规则。
2、获取该设备的局域网 IP（如 192.168.1.105）或公网 IP（需配合端口映射）。
3、在源设备 Web 界面添加远程设备时，在高级设置中手动填写“地址”字段为 [IP]:22000（例如 192.168.1.105:22000）。
4、粘贴对方设备 ID 后保存，等待连接状态由灰色变为黄色，最终稳定为绿色即表示通信链路就绪。
5、双方设备均需在通知栏中点击“添加设备”完成双向信任绑定。
四、本地网络自动发现配对法
此方法依赖 mDNS/Bonjour 协议实现零配置发现，仅限同一局域网内设备间使用，无需任何手动输入。
1、确保两台设备均接入同一 Wi-Fi 或有线子网，且防火墙未屏蔽 UDP 端口 21027。
2、在任一设备 Syncthing Web 界面中，进入“设置”→“连接”，确认“启用本地发现”已开启。
3、等待约 10–30 秒，另一台设备的“远程设备”列表将自动出现带设备名称和缩略 ID 的条目。
4、点击该条目右侧的“添加”按钮，系统自动生成配对请求。
5、被发现设备的 Web 界面同步弹出确认窗口，点击“添加设备”即可完成信任建立。
五、命令行设备 ID 提取与验证法
针对服务器或无图形界面设备（如树莓派、Linux 服务器），可通过终端精准提取并校验设备身份，避免 GUI 层误差。
1、在目标设备终端执行：syncthing -generate="/tmp/syncthing-config"，生成配置目录。
2、运行 grep -A 1 "deviceID" /tmp/syncthing-config/config.xml，提取原始设备 ID 字符串。
3、比对 Web 界面中显示的 ID 是否完全一致，特别注意大小写与连字符位置。
4、将提取出的 ID 复制至源设备 Web 界面进行添加，避免浏览器渲染导致的不可见字符干扰。
5、若仍失败，检查目标设备 Syncthing 是否处于运行状态：systemctl --user is-active syncthing.service。
