iNTERCEPT, एक मुक्त और ओपन-सोर्स प्लेटफ़ॉर्म जो सर्वोत्तम सिग्नल इंटेलिजेंस टूल्स को एक एकल, सुलभ इंटरफ़ेस में एकजुट करता है।
<p align="center"> <img src="https://raw.githubusercontent.com/smittix/intercept/HEAD/static/images/readme-banner.svg" alt="iNTERCEPT — सिग्नल इंटेलिजेंस प्लेटफ़ॉर्म" width="100%"> </p> <p align="center"> <img src="https://img.shields.io/badge/python-3.9+-blue.svg" alt="Python 3.9+"> <img src="https://img.shields.io/badge/license-Apache--2.0-green.svg" alt="Apache 2.0 License"> <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux-lightgrey.svg" alt="Platform"> </p> <p align="center"> इस ओपन-सोर्स प्रोजेक्ट के डेवलपर का समर्थन करें </p> <p align="center"> <a href="https://www.buymeacoffee.com/smittix" target="_blank"><img src="https://assets.kitploit.com/production/public/readmes/12080/608ca47c77206e90cac89def2d3fa14b17084ebc4a0a8dce231e4f0b3a78be1a.webp" alt="Buy Me A Coffee" style="height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;" ></a> </p> <p align="center"> <strong>सिग्नल इंटेलिजेंस प्लेटफ़ॉर्म</strong><br> सॉफ़्टवेयर-परिभाषित रेडियो टूल्स के लिए एक वेब-आधारित इंटरफ़ेस। </p> <p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12080/ccf5fc125324afe151202823a136a895449841e2cdd28325dcf6290230cda0d1.png" alt="Screenshot"> </p> --- ## विशेषताएँ - **पेजर डिकोडिंग** - rtl_fm + multimon-ng के माध्यम से POCSAG/FLEX - **433MHz सेंसर** - rtl_433 के माध्यम से मौसम स्टेशन, TPMS, IoT डिवाइस - **सब-गीगाहर्ट्ज़ विश्लेषक** - HackRF के माध्यम से 300-928 MHz ISM बैंड के लिए RF कैप्चर और प्रोटोकॉल डिकोडिंग - **विमान ट्रैकिंग** - रीयल-टाइम मैप और रडार के साथ dump1090 के माध्यम से ADS-B - **जहाज़ ट्रैकिंग** - VHF DSC आपातकालीन निगरानी के साथ AIS जहाज़ ट्रैकिंग - **ACARS मैसेजिंग** - acarsdec के माध्यम से विमान डेटालिंक संदेश - **VDL2** - dumpvdl2 के माध्यम से VHF डेटा लिंक मोड 2 विमान डेटालिंक डिकोडिंग - **लिसनिंग पोस्ट** - रीयल-टाइम ऑडियो निगरानी के साथ वाइडबैंड फ़्रीक्वेंसी स्कैनर - **मौसम उपग्रह** - ऑटो-शेड्यूलर के साथ SatDump के माध्यम से NOAA APT और Meteor LRPT इमेज डिकोडिंग - **WebSDR** - KiwiSDR नेटवर्क के माध्यम से दूरस्थ HF/शॉर्टवेव सुनना - **ISS SSTV** - अंतर्राष्ट्रीय अंतरिक्ष स्टेशन से स्लो-स्कैन TV इमेज रिसेप्शन - **HF SSTV** - शॉर्टवेव फ़्रीक्वेंसी (80m-10m, VHF, UHF) पर स्थलीय SSTV - **APRS** - direwolf के माध्यम से शौकिया पैकेट रेडियो स्थिति रिपोर्ट और टेलीमेट्री - **उपग्रह ट्रैकिंग** - पोलर प्लॉट और ग्राउंड ट्रैक मैप के साथ पास पूर्वानुमान - **उपयोगिता मीटर** - rtlamr के माध्यम से बिजली, गैस और पानी के मीटर की रीडिंग - **ADS-B इतिहास** - रिपोर्टिंग डैशबोर्ड के साथ स्थायी विमान इतिहास (Postgres वैकल्पिक) - **WiFi स्कैनिंग** - aircrack-ng के माध्यम से मॉनिटर मोड टोही - **ब्लूटूथ स्कैनिंग** - डिवाइस खोज और ट्रैकर पहचान (Ubertooth समर्थन के साथ) - **BT लोकेट** - GPS-टैग किए गए सिग्नल ट्रेल मैपिंग और निकटता अलर्ट के साथ SAR ब्लूटूथ डिवाइस लोकेशन - **WiFi लोकेट** - रीयल-टाइम सिग्नल मीटर, दूरी अनुमान और निकटता ऑडियो के साथ BSSID द्वारा WiFi एक्सेस पॉइंट का पता लगाएँ - **GPS** - लाइव मैप, गति, ऊँचाई और उपग्रह जानकारी के साथ रीयल-टाइम GPS स्थिति ट्रैकिंग - **TSCM** - RF बेसलाइन तुलना और खतरा पहचान के साथ काउंटर-निगरानी - **Meshtastic** - LoRa मेश नेटवर्क एकीकरण - **अंतरिक्ष मौसम** - NOAA SWPC, NASA SDO और HamQSL से रीयल-टाइम सौर और भू-चुंबकीय डेटा (SDR की आवश्यकता नहीं) - **स्पाई स्टेशन** - नंबर स्टेशन और राजनयिक HF नेटवर्क डेटाबेस - **रिमोट एजेंट** - रिमोट सेंसर नोड्स के साथ वितरित SIGINT - **ऑफ़लाइन मोड** - एयर-गैप्ड/फ़ील्ड परिनियोजन के लिए बंडल किए गए एसेट्स - **ड्रोन इंटेलिजेंस** - ASTM F3411 Remote ID (WiFi/BLE), RTL-SDR 433/868 MHz RF, और HackRF 2.4/5.8 GHz स्कैनिंग के माध्यम से मल्टी-वेक्टर UAV पहचान, लाइव कॉन्टैक्ट मैप और जोखिम स्कोरिंग के साथ --- ## इंस्टॉलेशन / Debian / Ubuntu / macOS ### त्वरित शुरुआत ```bash git clone https://github.com/smittix/intercept.git cd intercept ./setup.sh # Interactive menu (first run launches setup wizard) sudo ./start.sh ``` पहली बार चलाने पर, `setup.sh` एक **निर्देशित विज़ार्ड** लॉन्च करता है जो आपके OS का पता लगाता है, आपको इंस्टॉल प्रोफ़ाइल चुनने देता है, Python वातावरण सेट करता है, और वैकल्पिक रूप से पर्यावरण चर और PostgreSQL कॉन्फ़िगर करता है। बाद के रनों में, यह एक **इंटरैक्टिव मेनू** खोलता है: ``` INTERCEPT Setup Menu ════════════════════════════════════════ 1) Install / Add Modules 2) System Health Check 3) Database Setup (ADS-B History) 4) Update Tools 5) Environment Configurator 6) Uninstall / Cleanup 7) View Status 0) Exit ``` > **प्रोडक्शन बनाम डेव सर्वर:** `start.sh` स्वचालित रूप से gunicorn + gevent का पता लगाता है और सहकारी ग्रीनलेट्स के साथ एक प्रोडक्शन सर्वर चलाता है — बिना रुकावट के कई SSE/WebSocket क्लाइंट्स को संभालता है। यदि gunicorn इंस्टॉल नहीं है तो Flask डेव सर्वर पर वापस चला जाता है। त्वरित स्थानीय विकास के लिए, आप अभी भी सीधे `sudo -E venv/bin/python intercept.py` का उपयोग कर सकते हैं। ### इंस्टॉल प्रोफ़ाइल विज़ार्ड के दौरान या मेनू विकल्प 1 के माध्यम से चुनें कि क्या इंस्टॉल करना है: | # | प्रोफ़ाइल | टूल्स | |---|---------|-------| | 1 | Core SIGINT | rtl_sdr, multimon-ng, rtl_433, dump1090, acarsdec, dumpvdl2, ffmpeg, gpsd | | 2 | समुद्री और रेडियो | AIS-catcher, direwolf | | 3 | मौसम और अंतरिक्ष | SatDump, radiosonde_auto_rx | | 4 | RF सुरक्षा | aircrack-ng, HackRF, BlueZ, hcxtools, Ubertooth, SoapySDR | | 5 | पूर्ण SIGINT | उपरोक्त सभी | | 6 | कस्टम | प्रति-टूल चेकलिस्ट | कई प्रोफ़ाइलों को संयोजित किया जा सकता है (उदा. Core + Weather के लिए `1 3` दर्ज करें)। ### CLI फ़्लैग्स ```bash ./setup.sh --non-interactive # Headless full install (same as legacy behavior) ./setup.sh --profile=core,weather # Install specific profiles ./setup.sh --health-check # Check system health and exit ./setup.sh --postgres-setup # Run PostgreSQL setup and exit ./setup.sh --menu # Force interactive menu ``` ### Docker ```bash git clone https://github.com/smittix/intercept.git cd intercept docker compose --profile basic up -d --build ``` > **नोट:** Docker को USB SDR एक्सेस के लिए privileged मोड की आवश्यकता होती है। SDR डिवाइस `/dev/bus/usb` के माध्यम से पास किए जाते हैं। > **आपका डेटा:** सेटिंग्स, उपयोगकर्ता, अलर्ट नियम, वॉचलिस्ट और डिकोड किए गए संदेश होस्ट पर `./instance` में रहते हैं, इसलिए वे `--build` के बाद भी सुरक्षित रहते हैं। उस माउंट के बिना किसी compose फ़ाइल से अपग्रेड कर रहे हैं? पुनर्निर्माण से पहले पुराना डेटा बाहर कॉपी करें: `docker cp intercept:/app/instance ./instance`। मल्टी-आर्किटेक्चर बिल्ड (Raspberry Pi के लिए amd64 + arm64) के लिए, `build-multiarch.sh` देखें — यह एक ही चरण में क्रॉस-कंपाइलेशन और रजिस्ट्री पुश को संभालता है। ### पर्यावरण कॉन्फ़िगरेशन किसी भी `INTERCEPT_*` वेरिएबल को इंटरैक्टिव रूप से सेट करने के लिए **Environment Configurator** (मेनू विकल्प 5) का उपयोग करें। सेटिंग्स एक `.env` फ़ाइल में सहेजी जाती हैं जिसे `start.sh` स्टार्टअप पर स्वचालित रूप से सोर्स करता है। आप `.env` को मैन्युअल रूप से भी बना या संपादित कर सकते हैं: ```bash # .env (auto-loaded by start.sh) INTERCEPT_PORT=5050 INTERCEPT_ADSB_AUTO_START=true INTERCEPT_DEFAULT_LAT=51.5074 INTERCEPT_DEFAULT_LON=-0.1278 ``` ### ADS-B इतिहास (वैकल्पिक) ADS-B इतिहास सुविधा दीर्घकालिक विश्लेषण के लिए विमान संदेशों को PostgreSQL में सहेजती है। **स्वचालित सेटअप (स्थानीय इंस्टॉल):** ```bash ./setup.sh --postgres-setup # Or use menu option 3: Database Setup ``` यह आवश्यकता पड़ने पर PostgreSQL इंस्टॉल करेगा, डेटाबेस/उपयोगकर्ता/तालिकाएँ बनाएगा, और कनेक्शन सेटिंग्स को `.env` में लिखेगा। **Docker:** ```bash docker compose --profile history up -d ``` `.env` में निम्नलिखित environment variables सेट करें: ```bash INTERCEPT_ADSB_HISTORY_ENABLED=true INTERCEPT_ADSB_DB_HOST=adsb_db INTERCEPT_ADSB_DB_PORT=5432 INTERCEPT_ADSB_DB_NAME=intercept_adsb INTERCEPT_ADSB_DB_USER=intercept INTERCEPT_ADSB_DB_PASSWORD=intercept ``` Postgres डेटा को बाहरी स्टोरेज पर संग्रहीत करने के लिए, `PGDATA_PATH` सेट करें (डिफ़ॉल्ट `./pgdata` है): ```bash PGDATA_PATH=/mnt/usbpi1/intercept/pgdata ``` फिर रिपोर्टिंग डैशबोर्ड के लिए **/adsb/history** खोलें। ### सिस्टम स्वास्थ्य जाँच सत्यापित करें कि आपका इंस्टॉलेशन पूर्ण और कार्यशील है: ```bash ./setup.sh --health-check # Or use menu option 2 ``` स्थापित टूल, SDR डिवाइस, पोर्ट उपलब्धता, अनुमतियाँ, Python venv, `.env` कॉन्फ़िगरेशन और PostgreSQL कनेक्टिविटी की जाँच करता है। ### इंटरफ़ेस खोलें शुरू करने के बाद, अपने ब्राउज़र में **http://localhost:5050** खोलें। **कोई डिफ़ॉल्ट पासवर्ड नहीं है।** पहली बार शुरू होने पर, INTERCEPT `admin` खाते के लिए एक पासवर्ड जनरेट करता है, उसे लॉग करता है, और उसे `instance/.initial_password` में लिखता है। उसी से लॉग इन करें, और इंटरफ़ेस अनलॉक होने से पहले आपसे अपना स्वयं का पासवर्ड सेट करने के लिए कहा जाएगा। शुरू से ही अपना पासवर्ड चुनने के लिए, पहली बार शुरू करने से पहले `INTERCEPT_ADMIN_PASSWORD` सेट करें। विवरण के लिए और यह पिछले `admin`/`admin` डिफ़ॉल्ट को क्यों प्रतिस्थापित करता है, इसके लिए [Security](https://github.com/smittix/intercept/blob/main/docs/SECURITY.md#authentication) देखें। --- ## हार्डवेयर आवश्यकताएँ | हार्डवेयर | उद्देश्य | मूल्य | |----------|---------|-------| | **RTL-SDR** | सभी SDR सुविधाओं के लिए आवश्यक | ~$25-35 | | **WiFi एडाप्टर** | promiscuous (monitor) मोड का समर्थन करना चाहिए | ~$20-40 | | **Bluetooth एडाप्टर** | डिवाइस स्कैनिंग (आमतौर पर अंतर्निहित) | - | | **GPS** | कोई भी Linux समर्थित GPS यूनिट | ~10 | अधिकांश सुविधाएँ एक बेसिक RTL-SDR डोंगल (RTL2832U + R820T2) के साथ काम करती हैं। | :exclamation: RTL-SDR डिवाइस का उपयोग नहीं कर रहे हैं? | |----------------------------------------------- |Intercept किसी भी ऐसे डिवाइस का समर्थन करता है जिसे SoapySDR समर्थित करता है। हालाँकि, आपके पास अपने डिवाइस के लिए सही मॉड्यूल इंस्टॉल होना चाहिए! उदाहरण के लिए यदि आपके पास SDRPlay डिवाइस है तो आपको soapysdr-module-sdrplay इंस्टॉल करना होगा। | :exclamation: GPS उपयोग | |----------------------------------------------- |वास्तविक समय स्थान के लिए gpsd आवश्यक है। जब भी कोई मैप रेंडर होता है, Intercept स्वचालित रूप से जाँचता है कि आप बैकग्राउंड में gpsd चला रहे हैं या नहीं। --- ## Discord सर्वर <p align="center"> <a href="https://discord.gg/EyeksEJmWE">हमारे Discord से जुड़ें</a> </p> --- ## दस्तावेज़ीकरण - [उपयोग गाइड](https://github.com/smittix/intercept/blob/main/docs/USAGE.md) - प्रत्येक मोड के लिए विस्तृत निर्देश - [हार्डवेयर गाइड](https://github.com/smittix/intercept/blob/main/docs/HARDWARE.md) - SDR हार्डवेयर, मैन्युअल इंस्टॉल, और उन्नत सेटअप - [समस्या निवारण](https://github.com/smittix/intercept/blob/main/docs/TROUBLESHOOTING.md) - सामान्य समस्याएँ और समाधान - [वितरित एजेंट](https://github.com/smittix/intercept/blob/main/docs/DISTRIBUTED_AGENTS.md) - रिमोट सेंसर नोड परिनियोजन - [Webhooks](https://github.com/smittix/intercept/blob/main/docs/WEBHOOKS.md) - अलर्ट नियम और webhook एकीकरण - [सुरक्षा](https://github.com/smittix/intercept/blob/main/docs/SECURITY.md) - नेटवर्क सुरक्षा और सर्वोत्तम प्रथाएँ --- ## अस्वीकरण यह प्रोजेक्ट AI को एक कोडिंग साथी के रूप में उपयोग करके विकसित किया गया था, जिसमें मानवीय दिशा-निर्देश को AI-सहायता प्राप्त कार्यान्वयन के साथ जोड़ा गया। लक्ष्य: सामान्य SDR टूल के लिए एक स्वच्छ, एकीकृत इंटरफ़ेस प्रदान करके Software Defined Radio को अधिक सुलभ बनाना। **यह सॉफ़्टवेयर केवल शैक्षिक और अधिकृत परीक्षण उद्देश्यों के लिए है।** - केवल उचित प्राधिकरण के साथ उपयोग करें - सहमति के बिना संचार को इंटरसेप्ट करना अवैध हो सकता है - लागू कानूनों के अनुपालन के लिए आप ज़िम्मेदार हैं --- ## लाइसेंस Apache 2.0 लाइसेंस - देखें [LICENSE](https://github.com/smittix/intercept/blob/main/LICENSE) ## लेखक **smittix** द्वारा निर्मित - [GitHub](https://github.com/smittix) ## आभार [rtl-sdr](https://osmocom.org/projects/rtl-sdr/wiki) | [multimon-ng](https://github.com/EliasOenal/multimon-ng) | [rtl_433](https://github.com/merbanan/rtl_433) | [dump1090](https://github.com/flightaware/dump1090) | [AIS-catcher](https://github.com/jvde-github/AIS-catcher) | [acarsdec](https://github.com/TLeconte/acarsdec) | [direwolf](https://github.com/wb2osz/direwolf) | [rtlamr](https://github.com/bemasher/rtlamr) | [dumpvdl2](https://github.com/szpajder/dumpvdl2) | [aircrack-ng](https://www.aircrack-ng.org/) | [Leaflet.js](https://leafletjs.com/) | [SatDump](https://github.com/SatDump/SatDump) | [Celestrak](https://celestrak.org/) | [Priyom.org](https://priyom.org/)
