Go MITM Proxy

A lightweight, developer‑friendly Man‑in‑the‑Middle (MITM) HTTP/HTTPS proxy written in Go. It supports HTTP/1.1 and HTTP/2, CONNECT tunneling, WebSocket tunneling (ws/wss), on‑disk response caching with flexible filters, and live config reloading.

बैज

एडमिन डैशबोर्ड पूर्वावलोकन

अवलोकन

Go MITM Proxy एक इंटरसेप्टिंग प्रॉक्सी है जो HTTP(S) ट्रैफ़िक के डिबगिंग, परीक्षण, सीखने और नियंत्रित इंटरसेप्शन के लिए है। जब MITM सक्षम होता है, तो यह स्थानीय CA द्वारा हस्ताक्षरित प्रति-होस्ट लीफ सर्टिफिकेट गतिशील रूप से उत्पन्न करता है, जिससे प्रॉक्सी HTTPS ट्रैफ़िक को डिक्रिप्ट और निरीक्षण कर सकता है। यह MITM अक्षम होने पर या बाहर किए गए डोमेन/पोर्ट के लिए एक पारदर्शी TCP टनल के रूप में भी काम कर सकता है।

सूचना और जिम्मेदार उपयोग आवश्यकताएँ

महत्वपूर्ण: यह एप्लिकेशन सक्रिय Man-in-the-Middle (MITM) इंटरसेप्शन करता है, जिसमें HTTPS ट्रैफ़िक को डिक्रिप्ट करने के लिए TLS सर्टिफिकेट का निर्माण और उपयोग शामिल है। आपके क्षेत्राधिकार और नेटवर्क वातावरण के आधार पर, सभी प्रभावित उपयोगकर्ताओं की स्पष्ट, पूर्व सहमति के बिना ट्रैफ़िक इंटरसेप्ट करना अवैध हो सकता है और यह गोपनीयता, कार्यस्थल नीति या नियामक आवश्यकताओं का उल्लंघन कर सकता है।

इस सॉफ़्टवेयर को अपनी स्थानीय मशीन के अलावा किसी अन्य वातावरण में उपयोग करने से पहले:

1. स्पष्ट सहमति प्राप्त करें

इस प्रॉक्सी द्वारा ट्रैफ़िक इंटरसेप्ट किए जाने वाले किसी भी नेटवर्क के सभी उपयोगकर्ताओं को स्पष्ट रूप से सूचित किया जाना चाहिए कि HTTP(S) इंटरसेप्शन और निरीक्षण होगा। सहमति स्पष्ट होनी चाहिए और आदर्श रूप से प्रलेखित होनी चाहिए।

2. केवल अधिकृत नेटवर्क पर उपयोग करें

इस सॉफ़्टवेयर को उन नेटवर्कों पर न चलाएं जिनके आप स्वामी नहीं हैं, जिन्हें आप व्यवस्थित नहीं करते, या जिनके परीक्षण या निगरानी के लिए आपके पास स्पष्ट प्राधिकरण नहीं है।

3. गोपनीयता और डेटा संरक्षण कानूनों का सम्मान करें

कई क्षेत्रों में उपयोगकर्ता डेटा के इंटरसेप्शन, लॉगिंग और भंडारण को विनियमित करने वाले सख्त कानून हैं (जैसे, GDPR, CCPA, वायरटैप कानून)। आप जिम्मेदार हैं कि आपका उपयोग सभी लागू विनियमों का अनुपालन करता है।

4. उत्पन्न CA कुंजी को सुरक्षित रखें

उत्पन्न CA निजी कुंजी (आमतौर पर ca-key.pem) धारक को संबंधित सर्टिफिकेट पर भरोसा करने वाले उपयोगकर्ताओं के लिए किसी भी डोमेन की नकल करने की अनुमति देती है।

• इसे सुरक्षित रूप से संग्रहीत करें।
• इसे कभी साझा न करें।
• यदि समझौता हो जाए तो इसे रोटेट/हटा दें।

5. केवल परीक्षण और डिबगिंग के लिए उपयोग करें

यह प्रॉक्सी विकास, डिबगिंग, नियंत्रित परीक्षण या शैक्षिक उद्देश्यों के लिए डिज़ाइन की गई है — न कि गुप्त निगरानी या अनधिकृत निगरानी के लिए।

---

इस सॉफ़्टवेयर का उपयोग करके, आप स्वीकार करते हैं और पूर्ण जिम्मेदारी लेते हैं कि आपका उपयोग कानूनी, नैतिक है, और सभी प्रभावित उपयोगकर्ताओं को इसकी उचित जानकारी दी गई है।

विशेषताएँ

• HTTP और HTTPS प्रॉक्सीिंग मानक प्रॉक्सी सेमेन्टिक्स के माध्यम से
• HTTPS के लिए प्रति-होस्ट सर्टिफिकेट के साथ MITM इंटरसेप्शन
• ALPN नेगोशिएशन के साथ HTTP/1.1 और HTTP/2 डाउनस्ट्रीम हैंडलिंग
• WebSocket टनलिंग: ws:// और wss://
• GET रिस्पॉन्स के लिए लचीला ऑन-डिस्क कैश
  • डोमेन और फ़ाइल एक्सटेंशन द्वारा शामिल/बहिष्कृत करें
  • TTL-आधारित समाप्ति
  • रिस्पॉन्स में कैश हिट संकेतक (Via और एक कस्टम x--uid हेडर)
• लाइव कॉन्फ़िग रीलोड: config.json का वैकल्पिक पोलिंग और परिवर्तनों का हॉट-अप्लाई
• लोकल एडमिन API/डैशबोर्ड जिसमें bearer-token प्रमाणीकरण, read-only टोकन समर्थन, एडमिन उपयोगकर्ता भूमिका रिकॉर्ड, health/version/audit एंडपॉइंट, लाइव ट्रैफ़िक SSE, और CA मेटाडेटा/डाउनलोड शामिल हैं
• पोर्ट, डोमेन और IP/CIDR रेंज के लिए रनटाइम ब्लॉकिंग नीति
• ह्यूरिस्टिक और AI-आधारित निर्णय, रिडैक्शन, निर्णय कैशिंग, क्वारंटाइन मेटाडेटा और डैशबोर्ड एंडपॉइंट के साथ वैकल्पिक थ्रेट स्कैनर
• वर्बोज़ और प्रति-अनुरोध लॉगिंग नियंत्रण
• वैकल्पिक JSON कॉन्फ़िगरेशन के साथ उचित डिफ़ॉल्ट

स्थापना

Prerequisites:

• Go 1.25 या नया

Clone and build: ```bash git clone https://github.com/Welfordian/mitm-proxy.git cd mitm-proxy go build ./

यह प्रोजेक्ट रूट में एक mitm-proxy (या Windows पर mitm-proxy.exe) बाइनरी उत्पन्न करता है।


## त्वरित प्रारंभ

1) प्रॉक्सी को डिफ़ॉल्ट सेटिंग्स के साथ चलाएँ (:8080 पर सुनता है): ```bash
./mitm-proxy

पहली बार प्रारंभ करने पर, एक स्थानीय CA बनाया जाएगा और ca-cert.pem और ca-key.pem में सहेजा जाएगा।

2. अपने ब्राउज़र या curl को http://localhost:8080 पर प्रॉक्सी का उपयोग करने के लिए कॉन्फ़िगर करें।

3. HTTPS इंटरसेप्शन की अनुमति देने के लिए अपने OS/ब्राउज़र में जनरेट किए गए CA प्रमाणपत्र (ca-cert.pem) पर भरोसा करें। स्थानीय CA पर भरोसा करना देखें।

4. प्रॉक्सी के माध्यम से किसी HTTPS साइट पर जाएँ और लॉग देखें। अधिक विवरण के लिए verbose मोड का उपयोग करें: ```bash ./mitm-proxy --verbose

## उपयोग

### कमांड-लाइन फ़्लैग

- --config string: config.json फ़ाइल का पथ
- --listen string: लिसन पता (config को ओवरराइड करता है)
- --ca-cert string: मौजूदा CA प्रमाणपत्र का पथ (config को ओवरराइड करता है)
- --ca-key string: मौजूदा CA कुंजी का पथ (config को ओवरराइड करता है)
- --mitm bool: MITM इंटरसेप्शन सक्षम करें (डिफ़ॉल्ट true; false करने पर टनलिंग अनिवार्य हो जाती है)
- --verbose bool: वर्बोज़ लॉगिंग सक्षम करें
- --watch-config bool: परिवर्तनों के लिए config.json देखें और स्वतः लागू करें (डिफ़ॉल्ट true)
- --admin-enabled bool: स्थानीय एडमिन API/डैशबोर्ड सक्षम करें (डिफ़ॉल्ट true)
- --admin-addr string: एडमिन API/डैशबोर्ड लिसन पता (डिफ़ॉल्ट 127.0.0.1:9090)
- --admin-token string: एडमिन बियरर टोकन (छोड़े जाने पर स्टार्टअप पर जनरेट होता है)
- --admin-read-token string: GET/HEAD/OPTIONS एडमिन एक्सेस के लिए केवल-पठनीय बियरर टोकन
- --admin-ui bool: एम्बेडेड एडमिन UI सर्व करें (डिफ़ॉल्ट true)
- --admin-store string: एडमिन SQLite स्टोर पथ (डिफ़ॉल्ट dashboard.db)

CLI फ़्लैग, कॉन्फ़िगरेशन फ़ाइल मानों को ओवरराइड करते हैं जहाँ उल्लेख किया गया है।


### कॉन्फ़िगरेशन (config.json)