🛠️ استكشاف الأخطاء: وكيل ggRock للعميل لا يبدأ عند التمهيد

في بعض الحالات، خاصة أثناء التثبيتات التجريبية أو النشرات الجديدة، قد تفشل آلة العميل في الظهور ضمن علامة التبويب الأجهزة في واجهة ggRock. غالباً ما يكون السبب هو عدم تشغيل وكيل ggRock Client Agent عند بدء التشغيل بسبب إدخال تسجيل مفقود ضمن HKEY_CURRENT_USER.

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

❓ الأعراض

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

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

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

يتم تشغيل وكيل 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. بعد إعادة التشغيل، تحقق من أن العميل يظهر ضمن صفحة الأجهزة وأنه يبلغ عن سرعة الاتصال.

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

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

إذا استمرت في مواجهة مشاكل، يرجى التواصل مع ggCircuit Support مع لقطات شاشة وسجلات ذات صلة.

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

تحديث في: 22/04/2026