گیسٹ ایجنٹ: یہ کیوں اہم ہے اور اسے کیسے دوبارہ انسٹال کریں

qemu-guest-agent کیا فراہم کرتا ہے، کیسے پتہ چلے کہ یہ غائب ہو گیا ہے، اور Debian، Ubuntu، AlmaLinux اور Windows Server پر اسے کیسے بحال کریں۔

اپ ڈیٹ 23 اگست، 2026

پینل کو اپنا کچھ ڈیٹا باہر سے نہیں بلکہ سسٹم کے اندر موجود ایک چھوٹی سروس سے ملتا ہے — qemu-guest-agent۔ یہ پورٹس نہیں کھولتی اور نیٹ ورک کو نہیں چھوتی: مواصلت اندرونی ورچوئلائزیشن چینل کے ذریعے ہوتی ہے۔

یہ کیا فراہم کرتی ہے

Overview رنگ میں اصل استعمال شدہ ڈسک اسپیس۔ ایجنٹ کے بغیر پینل صرف امیج کا سائز جانتا ہے۔
نرم ری بوٹ اور شٹ ڈاؤن: سسٹم کو سگنل ملتا ہے اور سروسز بجلی کٹنے کے بجائے درست طریقے سے بند ہوتی ہیں۔
مشین کے نیٹ ورک ایڈریسز کی درست فہرست۔

ایجنٹ کے بغیر مشین چلتی رہتی ہے؛ پینل صرف کم دکھاتا ہے، اور ری بوٹ مشکل ہو جاتے ہیں — ڈیٹابیس اور فائل سسٹم کے لیے تمام خطرات کے ساتھ۔

کیسے پتہ چلے کہ یہ موجود نہیں

پہلی نشانی یہ ہے کہ /hosting/vds/m/<id> پر Overview میں استعمال شدہ ڈسک اسپیس غائب ہو جاتی ہے۔ ایسی صورت میں پینل خود آپ کے سسٹم کے لیے انسٹالیشن کمانڈ دکھاتا ہے۔

اندر سے چیک کریں:

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 انسٹال کریں، پھر "Services" سنیپ اِن میں یقینی بنائیں کہ QEMU Guest Agent چل رہا ہے اور خودکار طور پر شروع ہونے پر سیٹ ہے۔

چند سیکنڈ بعد Overview ریفریش کریں — استعمال شدہ اسپیس نظر آنی چاہیے۔

یہ کیوں غائب ہو جاتا ہے

وجہ	کیا ہوا
کم سے کم پیکج سیٹ کی انسٹالیشن	ایجنٹ شروع ہی سے موجود نہیں تھا
`apt autoremove`	"غیر ضروری ڈیپنڈنسی" کے طور پر ہٹا دیا گیا
"Extra services" کی صفائی	سروس دستی طور پر غیر فعال کر دی گئی
OS کی دوبارہ انسٹالیشن	آپ کی حسب ضرورت کنفیگریشن کے بغیر تازہ امیج

آپ اسے کسی بھی وقت محفوظ طریقے سے واپس لا سکتے ہیں: سروس قابلِ ذکر لوڈ نہیں بناتی اور نیٹ ورک کو نہیں چھوتی۔

عام غلطیاں

سروس active ہے لیکن پینل میں کوئی ڈیٹا نہیں — گراف کے اپ ڈیٹ ہونے کا انتظار کریں اور /dev/virtio-ports میں ڈیوائس چیک کریں۔
Unit qemu-guest-agent.service not found — پیکج انسٹال نہیں ہے، خراب نہیں۔
ایجنٹ انسٹال ہے لیکن ری بوٹ اب بھی مشکل ہیں — آٹو اسٹارٹ چیک کریں: systemctl is-enabled qemu-guest-agent۔

ایجنٹ مشین تک رسائی کا متبادل نہیں ہے۔ اگر سسٹم بوٹ نہ ہو تو یہ آپ کی مدد نہیں کرتا — ریسکیو ڈسک کرتی ہے۔