01 / 连接诊断

确认底层网络真实可用

先打开普通网页或访问已知可用的网络服务,检查 Wi-Fi、网线、移动数据及门户认证。若系统整体无法联网,应先处理接入问题。确认设备系统时间合理,特别是在刚恢复的虚拟机或长期离线主机上,时间异常可能影响认证和安全连接。

02 / 连接诊断

检查登录身份与 Tailnet

查看客户端是否已登录、是否加入预期网络,以及设备是否待审批、到期或被撤销。目标设备也要检查相同项目。一个账号可以在不同身份环境中看到不同资源,因此不要仅凭应用正在运行就认定双方属于同一个网络。重新认证时只使用官方提供的流程。

状态检查命令
tailscale status
tailscale ip
tailscale netcheck

03 / 连接诊断

检查两端状态和实际路径

在具备命令行的设备上运行 tailscale status,确认目标是否存在及其连接信息。必要时使用诊断工具与目标通信,区分直连和中继。对端显示离线时先联系设备管理人确认电源、休眠与服务状态;不要为了让状态变绿而立即删除网络成员或重新创建全部配置。

04 / 连接诊断

用设备地址隔离 DNS 问题

访问目标的真实设备地址和已知服务端口,再使用设备名称重复同样访问。地址成功而名称失败时,检查 MagicDNS、搜索域及客户端 DNS 接受设置。两者都失败时,继续检查路径、访问策略和服务。公共网页能够打开,不代表私有设备名称解析也一定正常。

设备连接状态检查主题场景示意
原创场景示意 · 用于说明设备与网络关系

05 / 连接诊断

核对应用端口和监听范围

目标应用需要启动并监听合适接口,系统防火墙和 Tailnet 策略也要允许对应来源和端口。网络诊断成功不代表网页、文件共享或数据库登录成功。先在目标本机验证服务,再从私有地址访问;证书、应用账号和系统用户问题应按各自服务的机制单独处理。

06 / 连接诊断

需要路由时增加一层检查

如果访问的是子网资源,核对路由设备本机可达性、网段发布、审批、访问端路由及策略。如果使用出口节点,先测试停止使用出口后的表现,再检查出口的互联网链路和转发能力。把这两种路由角色分开测试,能够避免默认路由问题被误认为所有 Tailnet 连接都已失效。

07 / 连接诊断

记录结果并保护诊断资料

CLI 的 tailscale ip 和 tailscale netcheck 可提供地址及本地网络条件信息,但输出包含环境细节。记录问题时间、两端系统、网络类型、发生前的变更和每一步结果,分享前遮盖账号、设备名、域名及地址。排错结束后撤销临时放开的规则,并恢复不再需要的测试配置。

官方参考资料

操作前请核对当前系统支持与功能条件。

接下来,验证一个真实连接。

先选择你管理的设备,再按对应指南完成检查。

查看连接检查教程