DHCPig

व्हाइटहैट DHCP हार्डनिंग सत्यापन: एक पूल को ख़त्म करें, पड़ोसियों के लीज़ हाईजैक करें, जाली ARP से होस्ट्स को उनके पतों से बेदखल करें, और रिपोर्ट करें कि क्या नेटवर्क ने आपको रोका। रूट और Python 3.11+ की आवश्यकता है।

वेब UI चलाएँ

Debian / Kali: नवीनतम .deb को Releases से प्राप्त करें और इसे इंस्टॉल करें — dhcpig और dhcpig-web को PATH पर रखता है, किसी venv की आवश्यकता नहीं:

curl -LO https://github.com/kamorin/DHCPig/releases/download/v2.7.2/dhcpig_2.7.2-1_all.deb
sudo apt install ./dhcpig_2.7.2-1_all.deb
sudo dhcpig-web --open

ग्लोबल इंस्टॉल (कोई भी Linux, Python 3.11+, बिना venv):

git clone https://github.com/kamorin/DHCPig && cd DHCPig
sudo pip install --break-system-packages .
sudo dhcpig-web --open

सीधे रूट के रूप में सिस्टम Python में इंस्टॉल होता है, इसलिए sudo dhcpig-web बिना किसी .venv/bin/ पाथ-जुगाड़ के कमांड ढूँढ लेता है। --break-system-packages Debian/Kali के PEP 668 गार्ड को ओवरराइड करता है जो pip को सिस्टम पैकेजों को छूने से रोकता है — वह गार्ड apt-प्रबंधित पैकेजों की सुरक्षा के लिए मौजूद है, इसलिए नहीं कि यह इंस्टॉल असामान्य है; .deb या एक venv इसकी आवश्यकता को पूरी तरह टाल देते हैं।

स्रोत से (कोई भी Linux, Python 3.11+):

git clone https://github.com/kamorin/DHCPig && cd DHCPig
python3 -m venv .venv && .venv/bin/pip install -e .
sudo .venv/bin/dhcpig-web --open

छपा हुआ http://127.0.0.1:8787/?token=... URL खोलें। तीन ध्यान देने योग्य बातें:

• रूट किसी भी तरह आवश्यक है (raw sockets)। स्रोत (venv) से, पूरा .venv/bin/ पाथ उपयोग करें — sudo PATH रीसेट कर देता है।
• ?token= अनिवार्य है। इसके बिना आपको 401s और एक खाली पेज मिलता है।
• हेडलेस? यह जानबूझकर loopback पर बाइंड होता है। इसे फॉरवर्ड करें, दोबारा बाइंड न करें: ssh -L 8787:127.0.0.1:8787 user@<vm-ip>। --open हटा दें।

Debian/Kali पर, यदि venv चरण विफल हो जाए तो पहले sudo apt install -y python3-venv चलाएँ।

CLI

sudo .venv/bin/dhcpig exhaust eth0 --report run.json
sudo .venv/bin/dhcpig release eth0 --scope 192.168.4.0/22     # DESTRUCTIVE
sudo .venv/bin/dhcpig active-scan eth0 --scope 192.168.4.0/22 # read-only
sudo .venv/bin/dhcpig release-previous eth0                   # undo a previous run
dhcpig ifaces

-v0 केवल परिणाम प्रिंट करता है; -v3 पैकेट-स्तरीय डीबग जोड़ता है। पूर्ण फ़्लैग संदर्भ: man dhcpig (या इंस्टॉल से पहले packaging/dhcpig.1)।

प्रत्येक मोड क्या करता है

DHCP एक्ज़ॉशन (exhaust) — विनाशकारी

• सेगमेंट का ARP-इन्वेंटरी करता है, फिर सिद्ध करता है कि इस मशीन से और एक अज्ञात MAC के लिए DHCP काम करता है
• हर पड़ोसी के लीज़ का DHCPRELEASE करता है — प्रोटोकॉल को स्वामित्व के प्रमाण की आवश्यकता नहीं होती
• गढ़े हुए MACs से DISCOVER/REQUEST का फ्लड करता है जब तक सर्वर जवाब देना बंद न कर दे
• पूल खाली हो जाने पर मुक्त किए गए पतों को नाम (option 50) द्वारा पुनः अनुरोध करता है
• यह देखने के लिए कि क्या होस्ट्स पता छोड़ देते हैं, लिए गए पतों के विरुद्ध RFC 5227 ARP संघर्ष गढ़ता है
• निर्णय: क्या उसके बाद भी एक बिल्कुल नया क्लाइंट पता प्राप्त कर सकता है?

DHCP रिलीज़ एक्टिव क्लाइंट्स (release) — विनाशकारी

• फ्लड को छोड़कर वही श्रृंखला: इन्वेंटरी → रिलीज़ → नाम द्वारा पुनः-अनुरोध → ARP संघर्ष
• अभी कनेक्टेड डिवाइसों को प्रभावित करता है; पूल को बरकरार छोड़ दिया जाता है ताकि अधिकांश पुनः प्राप्त कर सकें
• निर्णय: क्या किसी होस्ट ने अपना पता खोया और नया पता पाने में विफल रहा?

पोस्ट एक्ज़ॉशन / रीसेट (release-previous) — पुनर्प्राप्ति

• डिस्क पर सहेजे गए लीज़ जर्नल को दोबारा चलाता है और इस टूल द्वारा लिए गए हर पते को वापस करता है
• इस इंटरफ़ेस, नेटवर्क और DHCP सर्वर तक सीमित; --max-age पुरानी प्रविष्टियों को हटा देता है
• रिकॉर्ड करता है कि पूल पहले से खाली था या नहीं, लेकिन जर्नल में दर्ज लीज़ किसी भी स्थिति में रिलीज़ करता है
• निर्णय: क्या पूल फिर से उपयोग योग्य है?

पड़ोसी खोजें (active-scan) — केवल-पठनीय

• स्कोप का ARP-स्वीप करता है, DHCP सर्वरों की फ़िंगरप्रिंटिंग के लिए एक DHCPINFORM भेजता है
• कोई पता नहीं लेता, किसी लीज़ को परेशान नहीं करता

पैसिव स्कैन (scan) — केवल-पठनीय, केवल CLI

• DHCP और ARP पर नज़र रखता है; option-55 क्रम द्वारा होस्ट्स की फ़िंगरप्रिंटिंग करता है, MAC वेंडर पर फ़ॉलबैक करता है
• कुछ नहीं भेजता। रोके जाने तक चलता है

रन पढ़ना

सब कुछ इवेंट लॉग में दर्ज होता है, सबसे गंभीर पहले: फाइंडिंग्स, फिर प्रति होस्ट एक पंक्ति, फिर एक OUTCOME सारांश। Verbosity 0 (वेब) या -v0 (CLI) पैकेट ट्रैफ़िक को छिपाता है। JSON एक्सपोर्ट पूरा रिकॉर्ड है — लॉग एक सारांश है।

रन पूर्ववत करना

रन के बाद लीज़ बनाए रखे जाते हैं ताकि एक्ज़ॉशन की स्थिति सत्यापित की जा सके। उन्हें रिलीज़ करें:

sudo .venv/bin/dhcpig restore eth0             # same process still running
sudo .venv/bin/dhcpig release-previous eth0    # any time later, from the lease journal

जर्नल ($XDG_STATE_HOME/dhcpig/leases-<iface>.jsonl) प्रति लीज़ लिए गए MAC, IP, सर्वर और टाइमस्टैम्प रिकॉर्ड करता है — एंगेजमेंट डेटा। काम पूरा होने पर इसे हटा दें।

अस्वीकरण

इसे केवल उन नेटवर्कों पर चलाएँ जिनके आप स्वामी हैं या जिनके परीक्षण के लिए आपको स्पष्ट रूप से अधिकृत किया गया है। release और exhaust डिज़ाइन के अनुसार लाइव क्लाइंट्स को बाधित करते हैं; --scope वैकल्पिक है और डिफ़ॉल्ट रूप से पूरे सेगमेंट पर लागू होता है। लेखक दुरुपयोग के लिए ज़िम्मेदार नहीं हैं।

डिज़ाइन नोट्स और इंटर्नल्स: docs/DESIGN.md। योगदान: CONTRIBUTING.md। लाइसेंस: GPL v2 या उसके बाद का संस्करण।