وكيل الضيف: لماذا يهم وكيف تعيد تثبيته

تحصل اللوحة على بعض بياناتها ليس من الخارج، بل من خدمة صغيرة داخل النظام — qemu-guest-agent. وهي لا تفتح منافذ ولا تلمس الشبكة: فالاتصال يمر عبر قناة المحاكاة الافتراضية الداخلية.

ما الذي توفره

• المساحة الفعلية المستخدمة على القرص في حلقة نظرة عامة. بدون الوكيل، لا تعرف اللوحة سوى حجم الصورة.
• إعادة تشغيل وإيقاف تشغيل سلسان: يتلقى النظام إشارة ويوقف الخدمات بشكل صحيح بدلًا من قطع التيار.
• قائمة دقيقة بعناوين الشبكة الخاصة بالجهاز.

بدون الوكيل، يبقى الجهاز يعمل؛ لكن اللوحة تعرض أقل، وتصبح إعادة التشغيل قسرية — بكل ما تحمله من مخاطر على قاعدة البيانات ونظام الملفات.

كيف تعرف أنه مفقود

أول علامة هي اختفاء المساحة المستخدمة على القرص في نظرة عامة عند /hosting/vds/m/<id>. في هذه الحالة، تعرض اللوحة نفسها أمر التثبيت الخاص بنظامك.

تحقق من الداخل:

systemctl status qemu-guest-agent
ls -l /dev/virtio-ports/org.qemu.guest_agent.0

إذا لم يكن هناك جهاز في /dev/virtio-ports، فإن الخدمة تبدأ ثم تنتقل فورًا إلى وضع السكون: فالقناة الخاصة بها غير موجودة.

التثبيت

Debian وUbuntu:

apt update
apt install -y qemu-guest-agent
systemctl enable --now qemu-guest-agent

AlmaLinux وCentOS Stream:

dnf install -y qemu-guest-agent
systemctl enable --now qemu-guest-agent

Windows Server 2022 و2025: الوكيل جزء من مجموعة تعريفات virtio-win. ثبّت virtio-win-guest-tools، ثم في أداة «الخدمات» تأكد من أن QEMU Guest Agent يعمل ومضبوط على البدء تلقائيًا.

بعد بضع ثوانٍ، حدّث نظرة عامة — يجب أن تظهر المساحة المستخدمة.

لماذا يختفي

يمكنك إعادته بأمان في أي وقت: فالخدمة لا تخلق حملًا ملحوظًا ولا تلمس الشبكة.

الأخطاء الشائعة

• الخدمة بحالة active لكن لا توجد بيانات في اللوحة — انتظر تحديث الرسوم البيانية وتحقق من وجود الجهاز في /dev/virtio-ports.
• Unit qemu-guest-agent.service not found — الحزمة غير مثبتة، وليست معطوبة.
• الوكيل مثبت لكن إعادة التشغيل ما زالت قسرية — تحقق من البدء التلقائي: systemctl is-enabled qemu-guest-agent.

الوكيل لا يغني عن الوصول إلى الجهاز. إذا لم يُقلع النظام، فهو ليس ما يساعدك — بل قرص الإنقاذ.