DeskGate安装帮助

排查客户端连接问题

按可重复的顺序诊断软件包、服务、DNS、TCP、服务器和报告问题。

首先找出故障阶段

设备离线可能是由于数据包错误、服务停止、端点无法访问或服务器端故障造成的。已连接但报告为空的设备则属于另一种情况。请按以下顺序进行检查，并记录更改。

首先选择一个受影响的终端节点。记录时间、部署模型、软件包版本、操作系统、预期组织结构以及可见错误。请勿在公开屏幕截图中泄露密码、连接字符串、许可证标识符和设备私有信息。

确认您安装的是 Agent 版本而非 Admin 或 Portable 版本，并且其云部署或本地部署与组织匹配。在Windows服务中，检查 GoMyid 对于云代理或 GoMyit 适用于现场代理。

如果服务缺失，请检查安装程序结果和保护历史记录。如果服务启动后立即停止，请在反复重新安装之前捕获相关的Windows事件和程序包错误。请勿首先更改服务帐户或禁用端点保护。

对于本地部署环境，请将软件包端点与分配的服务器主机名或 IP 地址进行比较。主机名必须能够从受影响的设备（包括其 VPN 或分支机构网络）正确解析。在服务器本身上有效的主机名在客户端上可能无法以相同的方式解析。

如果组织或端点信息有误，请通过已批准的安装流程获取正确生成的软件包。切勿手动复制其他客户的配置。

请向部署管理员询问活动的服务器端口。在受影响的Windows设备上，可以使用PowerShell连接性检查来帮助区分网络故障和应用程序故障：

Test-NetConnection -ComputerName <server-hostname> -Port <configured-port>

运行命令前，请替换这两个占位符。 TcpTestSucceeded 如果结果为假，请检查 DNS、路由、VPN、服务器监听器和作用域防火墙规则。如果结果为真，请继续检查应用程序配置和组织结构；TCP 连接成功并不代表已注册或已认证。

对于本地部署环境，请确认服务器正在运行并监听预期接口。检查启动或连接错误，并使用实际运行时身份验证其数据库连接。如果数据库连接缺失或无法访问，请检查服务器是否正在运行或监听预期接口。 Sql.udl 即使 DBA 可以使用 SQL，该文件也可能影响本地服务器。

请将GoMyidServer和GoMyidCore与端点Agent分开检查。设置测试会同时测试登录页面和注册/数据库页面。仅凭登录响应无法证明数据库正常工作。请参阅图解设置步骤.

如果设备已连接但报告为空，请验证所选组织、组、用户、日期范围、审阅者权限和已启用的收集设置。确保已配置收集间隔已设置，并与最近已知的事件进行比较。请勿将筛选后的空报告解读为安装失败的证据。

症状	初步检查
安装程序失败	已批准的软件包、标高、安装结果和防病毒事件。
代理服务缺失	代理与管理员配置文件、部署类型和安装完成情况。
在局域网内工作，故障时可通过 VPN 恢复。	DNS 解析结果、路由、目标监听器和允许的源网络。
TCP连接成功，但设备不存在	组织特定软件包、端点配置和服务器端错误。
GateCore HTTP 或注册检查失败	记录端点和 HTTP 状态或连接错误。检查GoMyidCore 、所选 Web 端口和已安装的配置。当注册/数据库检查报告数据库错误时，调查 SQL。
设备已连接，报告为空	过滤器、权限、集合配置、间隔和服务器数据处理。

请提供版本号和软件包类型、 Windows版本、包含时区的时间戳、具体错误信息、服务状态、DNS 和 TCP 检查是否成功，以及已脱敏的相关日志。请注明最后成功执行的步骤。仅通过已批准的私有支持渠道共享组织特定的标识符。