🛠️ 故障排除: ggRock 客户端代理无法启动

在某些情况下，特别是在试用安装或新部署期间，客户端计算机可能无法在 ggRock UI 的硬件选项卡下出现。这通常是由于缺少 HKEY_CURRENT_USER 下的注册表项，导致 ggRock Client Agent 在系统启动时不启动。

本文将帮助您快速识别和解决此问题。

❓ 症状

• 计算机未在 ggRock 硬件页面中显示。

• 启动后，ggRock Client Agent 进程未在任务管理器中运行。
• 链接速度在 ggRock Web UI 中不可见

🔍 根本原因

ggRock Client Agent 由 HKEY_CURRENT_USER 下的 Run 键触发。如果注册表项缺失（由于不当的用户登录上下文、权限或注册表损坏），代理将不会自动启动。

🧰 解决方案

步骤 1：确认代理未运行

1. 正常启动客户端计算机。
2. 打开任务管理器，在详细信息选项卡中检查 GgRock.Client.exe。
3. 如果未列出，请继续下一步。

步骤 2：手动重新添加注册表项

1. 打开记事本并粘贴以下内容：

   Windows Registry Editor Version 5.00
   [HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\Run]
   "ggRock Client Agent"="conhost \"%PROGRAMDATA%\ggRock\Client\GgRock.Client.exe\" -agent"

2. 将文件保存为：ggrock-client-agent.reg
3. 双击 .reg 文件将其导入到注册表中。

✅ 注意： 即使条目已存在，运行这个也是安全的 — 它会简单地覆盖它。

步骤 3：保存快照并重启

1. 从 ggRock 控制面板中，为受影响的客户端保存快照。
2. 重启客户端。
3. 重启后，验证客户端是否出现在硬件页面下并报告链接速度。

🧩 其他说明

• 确保 PC 设置为正确的时区，如果登录令牌失败。
• 确保 ggRock Web UI 中每个客户端都显示链接速度，作为良好连接的标志。

如果您继续遇到问题，请联系 ggCircuit Support，并提供截图和相关日志。

祝启动愉快！🎉

更新于： 24/04/2026