SuperAPI AI 工具集

twingate-troubleshoot

通用与其它

查看项目

更新于 10-16 10:21

技能介绍

用途:该技能用于诊断 Twingate 连接故障,按固定顺序走六步决策树,在第一个暴露失败的步骤停下。

六步顺序:1) 客户端是否安装、运行并完成 IdP 登录,仅安装不够;2) 资源是否出现在用户资源列表中,缺失时检查组归属与设备信任策略(设备信任失败通常无报错,资源静默消失);3) DNS 是否正确解析,受管 FQDN 应解析为 Twingate 内部地址,若返回真实后端 IP 说明客户端未拦截,若返回内部地址仍超时则问题在下游连接器或策略;4) 连接器是否 ALIVE,在管理控制台 Remote Networks → Connectors 查看,DEAD_NO_RELAYS 通常表示连接器无法访问 Twingate 控制/中继基础设施,常见原因是 DPI/SSL 检查或出站端口被阻断;5) 连接器能否访问资源,必须从连接器主机测试而非用户机器;6) 安全策略是否满足,检查设备信任注册、MFA、会话过期、地理阻断与 JIT 审批。

使用方式与规定:先 grep references/ 中的确切错误文本再推理,例如 grep -ril "too many open files" references/。不要凭训练记忆回答客户端错误文本、日志行、平台诊断命令、连接器日志特征、版本相关 bug 或第三方软件兼容性问题。不要探测连接器的入站端口,连接器没有入站端口,应检查出站连通性;先查连接器日志再跑网络诊断。中继回退是延迟问题而非安全问题,P2P 与中继均已加密。

平台与特殊情况:各操作系统有各自的首选检查项(macOS 网络扩展批准、Windows 虚拟适配器、Linux 服务状态),具体命令见 references/troubleshooting-overview.md。两台连接器均 DEAD 时可从任一具备出站互联网的机器部署新连接器,无需现有可用连接器。“更新后才出现”的症状应视为版本回归,先向用户索取确切客户端版本。

参考与路由:references/ 每周更新,包含文档摘要、帮助中心文章和公开 GitHub 仓库摘要;可同时加载 twingate-connectors、twingate-identity、twingate-architect、twingate-dns-security、twingate-idfw 等技能,跨域问题应多查而非少查。

限制:资料未提供具体命令输出示例、收费与版本下载细节;官方补充文本暂未提供。