गेस्ट एजेंट: यह क्यों ज़रूरी है और इसे कैसे रीइंस्टॉल करें
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.
एजेंट मशीन तक पहुँच का विकल्प नहीं है। अगर सिस्टम बूट ही न हो, तो आपकी मदद यह नहीं करता — rescue disk करता है।