Port-Guard

Port-Guard هو أداة لإدارة وتأمين منافذ USB مصممة لدبيان. يتيح التحكم في الوصول إلى أجهزة USB، والحفاظ على قائمة بيضاء مخصصة، وتنفيذ فحص تلقائي في الخلفية لكشف أي اتصال غير مصرح به.

⚠️ إصدار تجريبي: البرنامج يعمل، ولكن قد تبقى بعض السلوكيات غير المتوقعة. يُرجى الإبلاغ عن أي خطأ أو خلل عبر issues مستودع Git.

الترخيص: GNU GPL v3 المؤلف: k3rnix

🧩 الميزات

• 🔒 حظر / إلغاء حظر جميع منافذ USB.
• 📜 إدارة قائمة بيضاء (إضافة، حذف، تنظيف).
• 🛰️ خدمة الفحص التلقائي (portguard.service).
• 🖥️ واجهة CLI واضحة وموجّهة.
• 🗂️ تسجيل مفصّل في: /opt/port-guard/logs/daemon-scan.log.

🚧 خارطة الطريق وقائمة مهام المشروع

هذا القسم بمثابة لوحة تقدم لمكونات المشروع المختلفة. يمكن تحديثه عبر إصدارات Git.

🔹 البرنامج الرئيسي (Shell)

🔹 الواجهة الرسومية (C++ / ImGui)

📦 التثبيت

إصدار CLI

1. افصل جميع أجهزة USB الخارجية (باستثناء تلك التي تريد تضمينها في القائمة البيضاء الأولية).
2. ثبّت حزمة .deb:
   root@kitploit:~

   sudo dpkg -i PortGuard_1.x.x.deb
   

الإعداد الافتراضي

بعد التثبيت:

• لا تحتوي القائمة البيضاء على أي جهاز.
• الفحص التلقائي غير مفعّل افتراضيًا. يجب تشغيل التطبيق وتفعيله يدويًا من القائمة الرئيسية.

إدارة القائمة البيضاء

• ملف الإعداد: /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/.

• حذف توثيق النظام في /usr/share/doc/port-guard/.

• حفظ القائمة البيضاء والسجلات في /tmp/.

• بعد التنفيذ، ستتم إزالة Port-Guard بالكامل من الجهاز.