Port-Guard

Port-Guard Debian के लिए डिज़ाइन किया गया एक USB पोर्ट प्रबंधन एवं सुरक्षा उपकरण है। यह USB डिवाइसों तक पहुँच को नियंत्रित करने, एक अनुकूलित whitelist बनाए रखने तथा किसी भी अनधिकृत कनेक्शन का पता लगाने के लिए पृष्ठभूमि में स्वचालित स्कैन चलाने की सुविधा देता है।

⚠️ बीटा संस्करण: सॉफ्टवेयर कार्यात्मक है, लेकिन अप्रत्याशित व्यवहार हो सकते हैं। कृपया Git रिपॉजिटरी के issues के माध्यम से किसी भी बग या विसंगति की रिपोर्ट करें।

लाइसेंस: GNU GPL v3 लेखक: k3rnix

---

🧩 विशेषताएँ

• 🔒 सभी USB पोर्टों का ब्लॉक / अनब्लॉक।
• 📜 Whitelist प्रबंधन (जोड़ना, हटाना, सफाई)।
• 🛰️ स्वचालित स्कैन डेमॉन (portguard.service)।
• 🖥️ स्पष्ट और निर्देशित CLI इंटरफ़ेस।
• 🗂️ विस्तृत लॉगिंग यहाँ: /opt/port-guard/logs/daemon-scan.log।

---

🚧 रोडमैप और प्रोजेक्ट चेकलिस्ट

यह अनुभाग प्रोजेक्ट के विभिन्न घटकों के लिए प्रगति तालिका के रूप में कार्य करता है। इसे Git संस्करणों के साथ अद्यतन किया जा सकता है।

🔹 मुख्य सॉफ्टवेयर (Shell)

मॉड्यूल	स्थिति	विवरण
USB प्रबंधन (ब्लॉक/अनब्लॉक)	✔️ पूर्ण	मुख्य कार्य परिचालनात्मक
Whitelist प्रबंधन	✔️ पूर्ण	जोड़ना / हटाना / खाली करना / usb-whitelist.conf पार्सिंग
स्वचालित स्कैन डेमॉन	✔️ पूर्ण	मैन्युअल सक्रियण, लॉग शामिल
.deb पैकेजिंग	✔️ पूर्ण	स्वच्छ स्थापना + अनइंस्टॉलर

🔹 ग्राफिकल इंटरफ़ेस (C++ / ImGui)

मॉड्यूल	स्थिति	विवरण
CMake सेटअप + प्रोजेक्ट संरचना	⬜ बाकी	प्रोजेक्ट का आधार
ImGui एकीकरण	⬜ बाकी	विंडो, बटन, USB तालिका
Shell स्क्रिप्ट के साथ इंटरैक्शन	⬜ बाकी	सिस्टम कॉल, स्थिति प्रतिक्रियाएँ
AppImage / बाइनरी रिलीज़	⬜ बाकी	क्रॉस-प्लेटफ़ॉर्म पैकेजिंग

---

📦 स्थापना

CLI संस्करण

1. सभी बाहरी USB डिवाइसों को अनप्लग करें (उन डिवाइसों को छोड़कर जिन्हें प्रारंभिक whitelist में शामिल करना है)।
2. .deb पैकेज स्थापित करें:

   sudo dpkg -i PortGuard_1.x.x.deb
   

डिफ़ॉल्ट कॉन्फ़िगरेशन

स्थापना के बाद:

• WhiteList में कोई डिवाइस नहीं होती।
• स्वचालित स्कैन डिफ़ॉल्ट रूप से सक्रिय नहीं होता। एप्लिकेशन लॉन्च करके इसे मुख्य मेनू के माध्यम से मैन्युअल रूप से सक्रिय करना आवश्यक है।

WhiteList प्रबंधन

• कॉन्फ़िगरेशन फ़ाइल: /opt/port-guard/conf/usb-whitelist.conf
• प्रारूप: [USB] SERIAL=123456789 MODEL=USB_DISK_x
• आप एप्लिकेशन के मुख्य मेनू के माध्यम से डिवाइसों को जोड़, हटा या सूची खाली कर सकते हैं।

अनइंस्टॉलेशन

Port-Guard को सही ढंग से अनइंस्टॉल करने के लिए, बस यह विकल्प चलाएँ:

sudo portguard -u
# ou
sudo portguard --uninstall

यह प्रक्रिया:

• portguard.service सेवा को रोकता और अक्षम करता है।

• /opt/port-guard/ में एप्लिकेशन की सभी फ़ाइलों को हटाता है।

• /usr/local/bin/portguard बाइनरी को हटाता है।

• /usr/share/ में desktop फ़ाइल और आइकन को हटाता है।

• /usr/share/doc/port-guard/ में सिस्टम दस्तावेज़ीकरण को हटाता है।

• WhiteList और लॉग को /tmp/ में सहेजता है।

• निष्पादन के बाद, Port-Guard मशीन से पूरी तरह हटा दिया जाएगा।