تهيئة الوصول البعيد عبر VNC (عميل Linux)

على عميل Linux، بعد تسجيل الدخول إلى وحدة تحكم الويب 10888 (راجع تحديث عميل Linux)، تظهر بطاقة «تهيئة VNC». نقرة واحدة تُعِدّ VNC وتُبلغ وحدة التحكم، التي يمكنها بعد ذلك الاتصال بهذا العميل عن بُعد. في الغالبية العظمى من الحالات تكون العملية تلقائية بالكامل دون أي إعداد يدوي؛ ولا تحتاج إلى قسم «المعالجة اليدوية» أدناه إلا عندما يُعاق المسار التلقائي بسبب البيئة (غياب x11vnc، أو سطح مكتب Wayland، إلخ).

ماذا تفعل التهيئة بنقرة واحدة

بعد النقر على «تهيئة VNC»، يقوم العميل (vdclient، يعمل بصلاحيات root) تلقائياً بالخطوات التالية بالترتيب:

1. تعطيل نافذة تقرير الأعطال Apport (Ubuntu/Debian فقط): يمنع ظهور نافذة «تم اكتشاف مشكلة في برنامج النظام» فوق سطح المكتب الذي سيتم التحكم به، تحسباً لفشل تثبيت x11vnc.
2. التحقق من نوع جلسة سطح المكتب: إذا كانت جلسة Wayland، فلا يستطيع x11vnc التقاط الشاشة، لذا يرشدك للتبديل إلى Xorg (انظر الحالة 2).
3. ضمان تثبيت x11vnc: إن لم يكن موجوداً، يُثبَّت تلقائياً عبر الإنترنت بمدير حزم التوزيعة (apt / dnf / yum / zypper / pacman).
4. توليد كلمة مرور عشوائية ديناميكية من 8 أحرف وكتابتها في ملف كلمات مرور VNC.
5. الاكتشاف التلقائي لـ DISPLAY و XAUTHORITY للجلسة الرسومية وتشغيل x11vnc على :0 على المنفذ 9015.
6. الإبلاغ التلقائي بعنوان IP والمنفذ 9015 وكلمة المرور الديناميكية إلى خادم الإقلاع، حتى تتمكن وحدة التحكم من الاتصال عن بُعد — دون أن تُدخل كلمة مرور إطلاقاً.
7. كتابة علامة التشغيل التلقائي: بعدها، في كل مرة يقلع فيها العميل، يعيد vdclient تشغيل VNC تلقائياً بمجرد جاهزية سطح المكتب والخادم — دون الحاجة للنقر مجدداً.

منفذ VNC ثابت على 9015؛ وكلمة مرور التحكم عشوائية تُولَّد ديناميكياً عند كل تهيئة ويُبلَّغ بها إلى وحدة التحكم تلقائياً — لا يمكن ولا يلزم ضبطها يدوياً.

خطوات التهيئة التلقائية

1. على جهاز العميل نفسه، افتح http://localhost:10888 في المتصفح وسجّل الدخول بحساب المسؤول (الافتراضي admin / 123456).
2. في بطاقة «تهيئة VNC»، انقر زر «تهيئة VNC».
3. ظهور رسالة «تمت تهيئة VNC» يعني النجاح — ويمكن لوحدة التحكم الآن الاتصال عن بُعد.

المعالجة اليدوية عندما لا يستطيع البرنامج القيام بذلك تلقائياً

إذا أبلغت النقرة عن فشل، عالِج الأمر حسب الحالة المناسبة أدناه. بعد المعالجة، ارجع إلى وحدة التحكم وانقر «تهيئة VNC» مرة أخرى — يجب إعادة المحاولة عبر الزر، لأن الزر وحده هو ما يُبلِّغ معلومات VNC إلى وحدة التحكم؛ أما تشغيل x11vnc يدوياً بمفرده فلا يُبلِّغ، ولن تستطيع وحدة التحكم الاتصال.

الحالة 1: لم يُعثر على x11vnc وفشل التثبيت التلقائي

شائعة عندما لا يملك العميل اتصالاً بالشبكة أو لا يوجد مستودع برمجيات مُهيّأ. تكون الرسالة شبيهة بـ «لم يُعثر على x11vnc وفشل التثبيت التلقائي، يُرجى التثبيت يدوياً: apt-get install -y x11vnc».

ثبّت x11vnc يدوياً في طرفية العميل حسب نوع النظام (يعمل vdclient بصلاحيات root؛ والتثبيت اليدوي يتطلب root أيضاً):

النظام	أمر التثبيت
Ubuntu / Debian / Kylin / UOS (قائمة على deb)	apt-get install -y x11vnc
openEuler / Anolis / RHEL / CentOS (الأحدث)	dnf install -y x11vnc
RHEL / CentOS (الأقدم)	yum install -y x11vnc
openSUSE	zypper install x11vnc
Arch	pacman -S x11vnc

إذا لم يكن x11vnc في المستودع، فهيّئ أولاً مستودعاً صالحاً (أو نزّل x11vnc وتبعياته وثبّتها دون اتصال). بعد التثبيت، ارجع إلى وحدة التحكم وانقر «تهيئة VNC» مرة أخرى.

الحالة 2: سطح المكتب هو Wayland ولا يستطيع VNC التقاط الشاشة

تستخدم أسطح المكتب مثل GNOME مُركِّب Wayland افتراضياً، لكن x11vnc يلتقط الشاشة عبر X11 ولا يستطيع التقاط سطح المكتب تحت Wayland. يجب التبديل إلى جلسة Xorg.

التبديل التلقائي من وحدة التحكم (موصى به): بعد النقر على «تهيئة VNC»، إذا اكتُشِف Wayland، يظهر مربع تأكيد:

سطح المكتب الحالي هو Wayland، حيث لا يستطيع VNC التقاط الشاشة. التبديل إلى Xorg سيعيد تشغيل مدير العرض ويُسجّل خروج جلسة سطح المكتب الحالية (تعود إلى Xorg تلقائياً خلال ~15 ثانية). هل تريد المتابعة؟

بعد النقر على «موافق»، يعدّل العميل تلقائياً إعداد GDM (يكتب WaylandEnable=false، مع نسخ الملف الأصلي احتياطياً باسم *.osvbak) ويعيد تشغيل مدير العرض للتبديل إلى Xorg. وعندما يعود سطح المكتب إلى Xorg (نحو 15 ثانية)، انقر «تهيئة VNC» مرة أخرى.

المعالجة اليدوية عند فشل التبديل التلقائي: إذا أبلغ بتعذّر العثور على إعداد GDM، أو فشل إعادة تشغيل مدير العرض، أو أن الجلسة ما زالت Wayland بعد التبديل، فاعمل يدوياً في طرفية العميل:

1. حرّر إعداد GDM (/etc/gdm3/custom.conf في Debian/Ubuntu/Kylin/UOS، و/etc/gdm/custom.conf في الأنظمة القائمة على Red Hat)، وأضِف أو عدّل في قسم [daemon]:

   [daemon]
   WaylandEnable=false

2. أعد تشغيل مدير العرض (هذا يُسجّل خروج سطح المكتب الحالي، لذا احفظ عملك أولاً):

   systemctl restart display-manager

   يمكنك أيضاً ببساطة إعادة تشغيل العميل؛ أو من شاشة تسجيل دخول GDM، انقر رمز الترس في الزاوية السفلية واختر «على Xorg» (on Xorg) قبل تسجيل الدخول.

3. بعد التأكد من أنك في جلسة Xorg، ارجع إلى وحدة التحكم وانقر «تهيئة VNC» مرة أخرى.

ضبطت WaylandEnable=false لكن النظام ما زال Wayland: غالباً لأن الجلسة الحالية لم يُعَد تسجيل الدخول إليها — أعد تشغيل العميل أو سجّل الدخول من جديد إلى Xorg ثم أعد التهيئة.

الحالة 3: بعد التبديل إلى Xorg، انقر مرة أخرى

التبديل التلقائي إلى Xorg يُسجّل خروج سطح المكتب ويعيد الدخول إليه (نحو 15 ثانية)، ما يقطع هذه التهيئة. وعندما يعود سطح المكتب، ارجع إلى وحدة التحكم وانقر «تهيئة VNC» مرة أخرى لإكمال التشغيل والإبلاغ.

التحقق واستكشاف الأخطاء

• على العميل، تحقق مما إذا كان x11vnc يعمل على المنفذ 9015:

  pgrep -a x11vnc
  ss -lntp | grep 9015

• يوجد سجل التشغيل في log/x11vnc.log ضمن دليل برنامج vdclient؛ استخدمه لتشخيص الأعطال (مثل تعذّر العثور على DISPLAY/XAUTHORITY، أو انشغال المنفذ، أو BadMatch عند الالتقاط، إلخ).

• عندما تُظهر وحدة التحكم أن العميل متاح للاتصال البعيد، فهذا يعني نجاح الإبلاغ.

ملاحظات

هذه الميزة متاحة على عملاء Linux فقط؛ أما عملاء Windows فيستخدمون رابط TightVNC مستقلاً ولا يملكون هذا الزر.

يجب أن يكون لدى العميل جلسة سطح مكتب رسومية قيد التشغيل (X/Xorg)؛ ولا يمكن التهيئة من طرفية نصية فقط أو عند عدم تسجيل الدخول إلى سطح المكتب.

بعد التهيئة مرة واحدة، يبدأ تلقائياً عند الإقلاع — لا حاجة للنقر مجدداً بعد إعادة تشغيل العميل؛ وفي كل مرة (بما في ذلك التشغيل التلقائي) يُعاد توليد كلمة المرور الديناميكية والإبلاغ بها إلى وحدة التحكم.

عملاء Xinchuang (Kylin، UOS، openEuler، Anolis، إلخ) يتبعون المسار نفسه تماماً: عالِج الأنظمة القائمة على deb وفق صف Kylin / UOS، والأنظمة القائمة على Red Hat وفق صف openEuler / Anolis.