设备连不上怎么办：从发现机制到 NAT 与中继逐层排查

先确认四件事

按官方入门文档的建议顺序，连接问题先查这几项，多数情况到这里就解决了：

1. 双方是否互加了 ID——只加一边永远连不上，这是设计；
2. ID 是否抄对——七段字符一位都不能错；
3. 两边程序都在运行——任务管理器/进程列表确认；
4. 防火墙是否放行——首次运行时的系统弹窗若被拒绝，局域网发现和直连都会失败，修复见[防火墙放行(../07-网络与连通/04-firewall.md)。

理解设备互相找到的三条路径

排查前要知道「找到对方」是怎么发生的：

• 本地发现：同一局域网内广播/组播（21027/UDP），自动发现彼此；
• 全局发现：向官方发现服务器登记 ID 与外部地址，跨网络时靠它找到对方（默认开启）；
• 静态地址：在设备设置的 Addresses 里手写对方地址，跳过发现。

对应地：同网段连不上→查本地发现与防火墙；跨网络连不上→查全局发现是否被关、路由器是否挡了出站。

直连不通时会怎样：中继兜底

如果端口没开、NAT 打洞失败，两台设备仍能通过官方公共中继服务器建立连接——速度慢但可用，而且连接仍是端到端加密的。所以「设备显示已连接但速度慢」和「设备一直灰色」是两个不同的问题：

• 一直灰色：发现或防火墙层面的问题，按上文排查；
• 已连接但慢：先看是不是走了中继，处理见[中继(../07-网络与连通/02-relay.md)与[同步慢先看连接类型(../10-常见问题/01-faq-slow.md)。

看连接状态的第一现场

设备列表里双击设备卡片，弹出连接详情：

• Connection Type 显示 TCP LAN / QUIC / Relay 开头——判断连接质量的第一依据；
• Address 显示实际链路；
• 若长时间 Disconnected，错误信息也会出现在界面顶部横幅里。

还不行：看日志

控制台窗口或日志文件里的 INFO/WARN 行会写明发现与连接的具体报错（地址、端口、错误码）。日志在哪、怎么读，见[日志位置与审计(../09-配置与进阶/04-logs-and-audit.md)。