> ## 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. غالباً ما يكون السبب هو **عدم تشغيل وكيل ggRock Client Agent عند بدء التشغيل** بسبب إدخال تسجيل مفقود ضمن `HKEY_CURRENT_USER`.

يرشدك هذا المقال خلال كيفية تحديد وحل هذه المشكلة بسرعة.

---

## ❓ الأعراض

* لا تظهر الأجهزة في صفحة **الأجهزة** بـ ggRock.

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

* عملية وكيل ggRock Client Agent لا تعمل في Task Manager بعد التشغيل.
* سرعة الاتصال غير مرئية في واجهة ggRock الويب

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

---

## 🔍 السبب الجذري

يتم تشغيل وكيل ggRock Client Agent بواسطة مفتاح `Run` ضمن `HKEY_CURRENT_USER`. إذا كان إدخال التسجيل مفقوداً (بسبب سياق تسجيل دخول المستخدم غير الصحيح أو الأذونات أو تلف التسجيل)، فلن يبدأ الوكيل تلقائياً.

---

## 🧰 الحل

### الخطوة 1: تأكد من أن الوكيل لا يعمل

1. قم بتشغيل جهاز العميل بشكل طبيعي.
2. افتح **Task Manager** وابحث عن `GgRock.Client.exe` ضمن علامة التبويب **Details**.
3. إذا لم يكن مدرجاً، تابع إلى الخطوة التالية.

---

### الخطوة 2: إعادة إضافة إدخال التسجيل يدوياً

1. افتح **Notepad** والصق ما يلي:

```
   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)

---

## 🧩 ملاحظات إضافية

* تأكد من تعيين الكمبيوتر الشخصي للمنطقة الزمنية الصحيحة إذا كانت رموز تسجيل الدخول تفشل.
* تأكد من ظهور سرعة الاتصال لكل عميل في واجهة ggRock الويب كدليل على اتصال جيد.

---

إذا استمرت في مواجهة مشاكل، يرجى التواصل مع [ggCircuit Support](mailto:support@ggcircuit.com) مع لقطات شاشة وسجلات ذات صلة.

تمنياتنا بتشغيل سعيد! 🎉