शैडो फ्लीट ट्रैकर लाइट

बाल्टिक सागर शैडो फ्लीट निगरानी लाइव AIS डेटा के माध्यम से। यूक्रेनी GUR युद्ध और प्रतिबंध सूची के 1200+ जहाजों को AISStream वेबसॉकेट फीड के विरुद्ध देखता है, एक स्व-अपडेटिंग मानचित्र पर स्थिति दर्शाता है, पनडुब्बी केबलों से निकटता को चिह्नित करता है, और रूस↔पश्चिम अंतरण पैटर्न का पता लगाता है।

मुफ़्त, ओपन सोर्स, स्थानीय रूप से चलता है। कोई क्लाउड नहीं, मुफ़्त AISStream API कुंजी के अलावा कोई सब्सक्रिप्शन नहीं।

फॉर्मर लैब संप्रभु खुफिया टूलचेन का हिस्सा।

फॉर्मर लैब का समर्थन करें

शैडो फ्लीट ट्रैकर लाइट फॉर्मर लैब टीम द्वारा बनाया और संचालित किया गया है — संप्रभु कंप्यूटिंग, पुराने हार्डवेयर पर बिना VC बैकिंग के खुले, गोपनीयता-प्रथम उपकरण बनाना।

यदि यह उपकरण आपके लिए उपयोगी है, तो कृपया Patreon पर समर्थन करने पर विचार करें। एक मुफ़्त स्तर उपलब्ध है, जिसमें भुगतान स्तरों पर 7-दिन का परीक्षण शामिल है। हमेशा यूक्रेन का समर्थन करें!

patreon.com/FormerLab

ट्रैकर पर ब्लॉग पोस्ट, स्क्रीनशॉट और अधिक: https://www.patreon.com/posts/153285871

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

git clone https://github.com/FormerLab/shadow-fleet-tracker-light.git
cd shadow-fleet-tracker-light
pip install -r requirements.txt
export AISSTREAM_API_KEY=your_key_here   # aisstream.io पर मुफ़्त
python shadow_tracker.py &
uvicorn webserver:app --host 0.0.0.0 --port 8000

http://localhost:8000 खोलें — मानचित्र /map पर है।

विंडोज़ उपयोगकर्ता: पर्यावरण चर सिंटैक्स के लिए सेटअप अनुभाग देखें।

Linux / macOS उपयोगकर्ता start.sh का उपयोग कर सकते हैं। विंडोज़ उपयोगकर्ता start.bat या start.ps1 का उपयोग कर सकते हैं — दोनों ट्रैकर और डैशबोर्ड को अलग-अलग विंडो में खोलते हैं और ब्राउज़र को स्वचालित रूप से लॉन्च करते हैं।

यह क्या करता है

• AISStream वेबसॉकेट से जुड़ता है और बाल्टिक सागर बाउंडिंग बॉक्स की सदस्यता लेता है
• यूक्रेनी GUR सूची (Vessels1.db) से प्राप्त 1200+ जहाज MMSI की वॉचलिस्ट के विरुद्ध स्ट्रीम को फ़िल्टर करता है
• Folium/Leaflet मानचित्र पर लाइव स्थिति और रूट ट्रेल प्लॉट करता है, हर 3 मिनट में ताज़ा होता है
• जब कोई जहाज़ केबल सेगमेंट (filtered_cables.kml से) के 10 किमी के भीतर आता है तो अलर्ट करता है
• लॉटरिंग का पता लगाता है — धीमे या स्थिर जहाज़ 20+ मिनट के लिए एक निश्चित क्षेत्र में
• अंतरण पैटर्न का पता लगाता है — जहाज़ 21 दिनों के भीतर रूसी बंदरगाहों और फिर पश्चिमी केंद्रों (या इसके विपरीत) पर कॉल करते हैं
• सभी स्थिति डेटा को SQLite में ऑफ़लाइन विश्लेषण के लिए लॉग करता है
• स्थिति लॉग से वार्म-रीस्टार्ट — स्टार्टअप पर अंतिम ज्ञात स्थितियों के साथ मानचित्र तुरंत भर जाता है, बिना खाली कैनवास प्रतीक्षा के
• लॉग निरीक्षण, जहाज विश्लेषण, GPX निर्यात, अंतरण समीक्षा और इंटरैक्टिव रूट रीप्ले के लिए FastAPI डैशबोर्ड प्रदान करता है

मानचित्र

डार्क CartoDB बेसमैप जिसमें केबल रूट हरे रंग में ओवरले हैं। जहाज मार्कर हर 3 मिनट में अपडेट होते हैं और अगले रिफ्रेश के लिए लाइव काउंटडाउन होता है — पेज स्वचालित रूप से रीलोड होता है। पॉपअप MMSI, IMO, ध्वज, गति, हेडिंग, गंतव्य, और MarineTraffic, VesselFinder, और War&Sanctions के लिए डीप लिंक दिखाते हैं। यदि API कुंजी कॉन्फ़िगर की गई है तो OpenSanctions प्रतिबंध स्थिति दिखाई जाती है।

Vessels1.db से ज्ञात जहाज के नाम AIS स्थैतिक संदेश की प्रतीक्षा किए बिना पहली उपस्थिति पर तुरंत दिखाए जाते हैं।

स्टार्टअप पर मानचित्र पिछले 24 घंटों के स्थिति लॉग से पूर्व-जनसंख्या होता है। वर्तमान सत्र में अभी तक नहीं देखे गए जहाजों को "पिछली बार X घंटे पहले देखा गया" लेबल के साथ ग्रे मार्कर के रूप में दिखाया जाता है — नए पिंग आने पर वे लाइव रंग में बदल जाते हैं।

फ़ाइलें

shadow_tracker.py          मुख्य प्रक्रिया — WS उपभोक्ता, मानचित्र रेंडरर, DB लेखन
loitering_module.py        लॉटरिंग का पता लगाना और मानचित्र एनोटेशन
transshipment_module.py    पोर्ट कॉल का पता लगाना और रूस↔पश्चिम अंतरण फ़्लैगिंग
webserver.py               FastAPI डैशबोर्ड
gur_scrape.py              एक-शॉट स्क्रैपर — IMO→GUR-ID मैपिंग + पूर्ण जहाज सूची बनाता है
check.py                   प्रीफ़्लाइट जाँच — Python संस्करण, निर्भरताएँ, API कुंजी, नेटवर्क
start.sh                   Linux / macOS के लिए लॉन्चर
start.bat                  विंडोज़ के लिए लॉन्चर (कमांड प्रॉम्प्ट)
start.ps1                  विंडोज़ के लिए लॉन्चर (PowerShell)
requirements.txt           निर्भरताएँ

Vessels1.db                वॉचलिस्ट — 1200+ जहाज (MMSI + IMO + नाम जहाँ ज्ञात)
vessel_data_log.db         स्थिति लॉग — रनटाइम, ऐपेंड-ओनली
vessel_static.db           AIS स्थैतिक डेटा कैश (नाम, गंतव्य, ध्वज इतिहास)
transshipment.db           पोर्ट कॉल लॉग और अंतरण घटनाएँ
loitering_events.db        लॉटरिंग घटनाएँ
filtered_cables.kml        बाल्टिक सागर पनडुब्बी केबल ज्यामिति
cables.kml                 पूर्ण केबल डेटासेट (पूर्व-फ़िल्टर स्रोत)
gur_mapping.json           IMO→GUR-ID मैपिंग (gur_scrape.py द्वारा उत्पादित, वैकल्पिक)
gur_vessels_full.json      पूर्ण GUR सूची — GUR-ID→{imo, mmsi, name, flag} (gur_scrape.py द्वारा उत्पादित)

वॉचलिस्ट

Vessels1.db ट्रैक किए गए जहाजों की विहित सूची है। यूक्रेनी GUR युद्ध और प्रतिबंध सूची से 1200+ प्रविष्टियाँ, जिनमें टैंकर और कार्गो जहाज शामिल हैं जिन्हें रूसी शैडो फ्लीट के हिस्से के रूप में पहचाना गया है या बाल्टिक हाइब्रिड गतिविधि में शामिल पाया गया है।

सूची में हाल ही में बाल्टिक अधिकारियों द्वारा जब्त या रोके गए जहाज शामिल हैं:

MMSI को वर्तमान AIS डेटा के विरुद्ध सही किया गया है — शैडो फ्लीट जहाज बार-बार ध्वज बदलते हैं। update_vessels_2026_03.sql फ़ाइल स्रोतों के साथ सभी परिवर्तनों का दस्तावेजीकरण करती है।

वॉचलिस्ट जानबूझकर खुली है। ट्रैकर चलने के दौरान सीधे Vessels1.db में जहाज जोड़ें — वे 5 मिनट के भीतर बिना पुनरारंभ के उठा लिए जाएंगे।

Linux / macOS:

sqlite3 Vessels1.db "INSERT OR IGNORE INTO vessels (mmsi, imo, name) VALUES ('123456789', '9999999', 'VESSEL NAME');"

विंडोज़ (sqlite3 CLI की आवश्यकता नहीं):

import sqlite3
conn = sqlite3.connect("Vessels1.db")
conn.execute("INSERT OR IGNORE INTO vessels (mmsi, imo, name) VALUES ('123456789', '9999999', 'VESSEL NAME')")
conn.commit()
conn.close()

डेटा मॉडल

Vessels1.db — वॉचलिस्ट

vessels(mmsi TEXT PK, imo TEXT, name TEXT, destination TEXT)

vessel_data_log.db — स्थिति लॉग

vessel_data_log(timestamp, mmsi, name, imo, destination, speed, heading, latitude, longitude, cable_alert)

केवल-जोड़ें। प्रत्येक मानचित्र रेंडर चक्र पर लिखा जाता है।

vessel_static.db — AIS स्थैतिक डेटा कैश

vessel_static(mmsi TEXT PK, name TEXT, imo TEXT, destination TEXT, flag TEXT)
flag_history(id, mmsi, flag, timestamp)

लाइव ShipStaticData AIS संदेशों से भरा गया। प्राप्त होने के बाद Vessels1.db नामों पर प्राथमिकता लेता है। flag_history प्रत्येक ध्वज परिवर्तन को टाइमस्टैम्प के साथ रिकॉर्ड करता है — प्रति-जहाज पृष्ठ पर पुनः-ध्वजीकरण घटनाएँ लॉग और प्रदर्शित की जाती हैं।

loitering_events.db — लॉटरिंग लॉग (रनटाइम पर बनाया गया)

loitering_events(id, mmsi, timestamp, latitude, longitude, near_cable)

transshipment.db — पोर्ट कॉल और अंतरण लॉग (रनटाइम पर बनाया गया)

port_calls(id, mmsi, name, port, port_type, entry_ts, exit_ts, min_speed)
transshipment_events(id, mmsi, name, direction, from_port, from_exit_ts,
                     to_port, to_entry_ts, days_between, detected_ts)

आवश्यकताएँ

• Python 3.11 या नया — python.org/downloads
• एक AISStream API कुंजी — aisstream.io पर मुफ़्त (पंजीकरण करें, फिर डैशबोर्ड से अपनी कुंजी कॉपी करें)
• requirements.txt में निर्भरताएँ

प्रारंभ स्क्रिप्ट

ट्रैकर चलाने का सबसे आसान तरीका। प्रत्येक स्क्रिप्ट निर्भरताएँ स्थापित करती है, प्रीफ़्लाइट जाँच चलाती है, और दोनों प्रक्रियाएँ लॉन्च करती है।

Linux / macOS:

chmod +x start.sh
export AISSTREAM_API_KEY=your_key_here
./start.sh

विंडोज़ (PowerShell):

$env:AISSTREAM_API_KEY = "your_key_here"
.\start.ps1

विंडोज़ (कमांड प्रॉम्प्ट):

set AISSTREAM_API_KEY=your_key_here
start.bat

तीनों स्क्रिप्ट पहले check.py चलाती हैं — एक प्रीफ़्लाइट जो Python संस्करण, निर्भरताएँ, डेटा फ़ाइलें, API कुंजी, और नेटवर्क पहुंच की जाँच करती है, जिसमें किसी भी चीज़ के गायब होने पर स्पष्ट त्रुटि संदेश होते हैं।

आप किसी भी समय प्रीफ़्लाइट जाँच स्वयं भी चला सकते हैं:

python check.py

सेटअप (मैन्युअल)

1. क्लोन और निर्भरताएँ स्थापित करें

git clone https://github.com/FormerLab/shadow-fleet-tracker-light.git
cd shadow-fleet-tracker-light
pip install -r requirements.txt

Ubuntu 22.04+ और Debian 12+ पर आपको pip से "externally managed environment" त्रुटि मिल सकती है। स्टार्ट स्क्रिप्ट स्वचालित रूप से एक वर्चुअल वातावरण बनाकर इसे संभालती हैं — बस start.sh चलाएँ और यह ध्यान रखेगी। यदि मैन्युअल रूप से स्थापित कर रहे हैं, तो पहले एक venv बनाएँ:

python3 -m venv .venv
source .venv/bin/activate   # Linux/macOS
.venv\Scripts\activate      # विंडोज़
pip install -r requirements.txt

2. अपनी AISStream API कुंजी सेट करें

Linux / macOS:

export AISSTREAM_API_KEY=your_key_here
export OPENSANCTIONS_API_KEY=your_key_here  # वैकल्पिक

विंडोज़ (कमांड प्रॉम्प्ट):

set AISSTREAM_API_KEY=your_key_here
set OPENSANCTIONS_API_KEY=your_key_here

विंडोज़ (PowerShell):

$env:AISSTREAM_API_KEY = "your_key_here"
$env:OPENSANCTIONS_API_KEY = "your_key_here"

3. ट्रैकर और डैशबोर्ड को दो अलग-अलग टर्मिनलों में चलाएँ

टर्मिनल 1 — AIS फ़ीड उपभोक्ता:

python shadow_tracker.py

टर्मिनल 2 — वेब डैशबोर्ड:

uvicorn webserver:app --host 0.0.0.0 --port 8000

4. डैशबोर्ड खोलें

http://localhost:8000

लाइव मानचित्र http://localhost:8000/map पर है और हर 3 मिनट में अपडेट होता है। पहली बार चलाने पर मानचित्र तुरंत डेटाबेस में पहले से मौजूद किसी भी स्थिति इतिहास से रेंडर होता है — कोई खाली कैनवास प्रतीक्षा नहीं।

API कुंजियाँ

OPENSANCTIONS_API_KEY के बिना ट्रैकर सामान्य रूप से चलता है — प्रतिबंध बैज मानचित्र पॉपअप से हटा दिए जाते हैं।

कॉन्फ़िगरेशन

सभी ट्यून करने योग्य मान shadow_tracker.py के शीर्ष पर हैं:

पर्यावरण चर:

OpenSanctions गैर-वाणिज्यिक उपयोग के लिए मुफ़्त है — opensanctions.org/api पर पंजीकरण करें। कुंजी के बिना ट्रैकर सामान्य रूप से चलता है; प्रतिबंध फ़ील्ड पॉपअप से हटा दिए जाते हैं।

War&Sanctions डीप-लिंक (वैकल्पिक)

war-sanctions.gur.gov.ua यूक्रेनी GUR की शैडो फ्लीट और प्रतिबंधित जहाजों की सार्वजनिक सूची है। प्रत्येक जहाज का पोर्ट कॉल इतिहास, मानचित्र और प्रतिबंध विवरण के साथ एक क्रमांकित पृष्ठ होता है।

gur_scrape.py सूची को एक बार क्रॉल करके एक स्थानीय IMO→GUR-ID मैपिंग बनाता है:

python gur_scrape.py

यह gur_mapping.json उत्पन्न करता है। ट्रैकर इसे स्टार्टअप पर लोड करता है और उपलब्ध होने पर मानचित्र पॉपअप में प्रत्यक्ष डीप-लिंक (/en/transport/ships/{id}) का उपयोग करता है, सूची में अभी तक नहीं आए जहाजों के लिए Google साइट-सर्च पर वापस आ जाता है।

क्रॉल ~1600 प्रविष्टियों को 1.5 s/अनुरोध (~40 मिनट) पर कवर करता है। सूची बढ़ने पर कभी-कभी पुनः चलाएँ — किसी विशिष्ट ID से फिर से शुरू करने के लिए --start का उपयोग करें:

python gur_scrape.py --start 1580

एक पृष्ठ को डीबग करने के लिए:

python gur_scrape.py --probe 1517

gur_mapping.json वॉचलिस्ट के साथ हर 5 मिनट में स्वचालित रूप से पुनः लोड होता है — पुनः क्रॉल के बाद ट्रैकर पुनरारंभ की आवश्यकता नहीं है।

loitering_module.py में लॉटरिंग थ्रेशोल्ड:

transshipment_module.py में अंतरण सेटिंग्स:

कवर किए गए पोर्ट ज़ोन:

डैशबोर्ड

प्रति-जहाज पृष्ठ

प्रत्येक जहाज पृष्ठ (/vessel/<mmsi>) दिखाता है:

• रूट रीप्ले — प्ले/पॉज़/रीसेट और स्पीड कंट्रोल के साथ इंटरैक्टिव Leaflet मानचित्र। ट्रेल बिंदु दर बिंदु बनता है; केबल अलर्ट पिंग पर मार्कर लाल हो जाता है
• सारांश — पहली/आखिरी बार देखा गया, कुल पिंग, केबल अलर्ट गणना, AIS गैप गणना, देखे गए गंतव्य
• AIS ब्लैकआउट — ≥60 मिनट का कोई भी गैप प्रारंभ/समाप्ति टाइमस्टैम्प और अवधि के साथ चिह्नित
• केबल निकटता — उन पिंगों का प्रतिशत जहाँ केबल अलर्ट सक्रिय था
• स्थैतिक डेटा बहाव — नाम परिवर्तन, तिथियों के साथ ध्वज परिवर्तन, गंतव्य इतिहास। पुनः-ध्वजीकरण एक प्राथमिक शैडो फ्लीट चोरी रणनीति है
• GPX निर्यात — टाइमस्टैम्प के साथ पूर्ण ट्रैक, किसी भी GIS उपकरण में लोड करने योग्य

अंतरण पृष्ठ

दो पैटर्न को स्थिति डेटा से अनुमानित करता है:

• RU→WEST — जहाज ने 21 दिनों के भीतर एक रूसी बंदरगाह पर कॉल किया फिर एक पश्चिमी केंद्र पर। यूरोपीय आपूर्ति श्रृंखलाओं में संभावित कार्गो लॉन्डरिंग
• WEST→RU — जहाज ने 21 दिनों के भीतर एक पश्चिमी केंद्र पर कॉल किया फिर एक रूसी बंदरगाह पर। प्रतिबंधित क्षेत्र में पूर्व की ओर बहने वाले संभावित यूरोपीय सामान

पोर्ट कॉल का अनुमान स्थिति पिंग से लगाया जाता है — किसी बाहरी API की आवश्यकता नहीं है। एक जहाज को कॉल दर्ज करने के लिए कम से कम 2 पिंगों के लिए <1.5 kn पर पोर्ट ज़ोन के अंदर होना चाहिए। यह एक पैटर्न दिखाता है, फैसला नहीं।

केबल डेटा

filtered_cables.kml ओपन-सोर्स डेटासेट से प्राप्त किया गया है और अनुमानित है — सटीक निकटता गणना के लिए उपयुक्त नहीं है। 10 किमी अलर्ट थ्रेशोल्ड इस मार्जिन को ध्यान में रखता है। बेहतर केबल ज्यामिति के योगदान का स्वागत है।

आर्किटेक्चर नोट्स

ट्रैकर वेबसॉकेट स्ट्रीम पर एक एकल async लूप चलाता है। स्थिति मेमोरी में रखी जाती है (vessel_info, static_cache) और प्रत्येक रेंडर चक्र पर SQLite में फ्लश की जाती है। मानचित्र को आंशिक फ़ाइल परोसने से बचने के लिए os.replace के माध्यम से परमाणु रूप से लिखा जाता है।

स्टार्टअप पर, warm_restart() vessel_data_log.db से पिछले WARM_RESTART_HOURS घंटे पढ़ता है और वेबसॉकेट कनेक्ट होने से पहले vessel_info को पूर्व-जनसंख्या करता है। प्रारंभिक मानचित्र तुरंत रेंडर होता है। पुरानी स्थितियों को दृश्य रूप से अलग किया जाता है (ग्रे मार्कर, मंद ट्रेल) और नए पिंग आने पर लाइव रंग में बदल जाते हैं।

वॉचलिस्ट और gur_mapping.json हर 5 मिनट में डिस्क से पुनः लोड होते हैं — ट्रैकर चलने के दौरान जहाज जोड़े जा सकते हैं और GUR मैपिंग को पुनः क्रॉल किया जा सकता है, बिना पुनरारंभ के।

वेबसर्वर स्टेटलेस है और सीधे SQLite फ़ाइलों से पढ़ता है — ट्रैकर प्रक्रिया के साथ कोई साझा मेमोरी नहीं।

स्थिति