> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://helpdesk.ggcircuit.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

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

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

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

---

## ❓ 症状

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

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15862337/image-20250424-212348.png?version=1&modificationDate=1745529837825&cacheVersion=1&api=v2)

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

  ![](https://ggcircuit.atlassian.net/wiki/download/attachments/15862337/image-20250424-212638.png?version=1&modificationDate=1745530005404&cacheVersion=1&api=v2)

---

## 🔍 根本原因

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. 重启后，验证客户端是否出现在**硬件**页面下并报告链接速度。

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15862337/image-20250424-212500.png?version=1&modificationDate=1745529909214&cacheVersion=1&api=v2)

---

## 🧩 其他说明

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

---

如果您继续遇到问题，请联系 [ggCircuit Support](mailto:support@ggcircuit.com)，并提供截图和相关日志。

祝启动愉快！🎉