OllamaHound एक मॉड्यूलर, RedTeam-उन्मुख टूलकिट है जो सार्वजनिक रूप से एक्सपोज़्ड Ollama सर्वरों की खोज, संस्करण फिंगरप्रिंटिंग, CVE एक्सपोज़र का वर्गीकरण, यह सत्यापित करना कि टेक्स्ट जनरेशन संभव है या नहीं, और (वैकल्पिक रूप से) नियंत्रित परीक्षण के लिए एक इंटरैक्टिव CLI सत्र सक्षम करना।

@@@@@@@@@@@@@@@@@@@@@@@@@@@#*#@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@%.-+-:#@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@+--=%@@@@@@@@-.@@@+ #@@@@@@@@@@@@@@@@@
@@@@@@@@@@@= %%+.=@@@%###-.@@@@= %@@@@@@@@@@@@@@@@
@@@@@@@@@@@-.@@@@..--====-.=@@@@.-@@@@@@@@@@@@@@@@
@@@@@@@@@@@# +#+-:*%@@@@@@@@@@@@- +@@@@@@@@@@@@@@@
@@*@@@@@#*+=:::.-*%@@@@@@@@@@@@@@%::%@@@@@@@@@@@@@
@+:-@@*----=***+==-=#@@@@@@@@@@@@@@::@@@@@@@@@@@@@
@*+#@=-==+=%@@@@%#=+:*%%%@@@@#++%@@+ %@@@@@@@@@@@@
+:=@#.+-@#=#@%+++%@:* =++==*@-  *@@-.@@@@@@@@@@@@@
%=+@+--*@@*=##+++%#.+::=@#%:+@%@@@@%.=@@@@@@@@@@@@
@@@@#.+-@@%=*@@@@@+.* =-:*@-=@@@@@@@* %@@@@@@@@@@@
@@@@@+:==#*=%@@@@*-=.:--+*-=@@@@@@@@+ %@@@@@@@@@@@
@@@@@@#=----+*++=--=**++*#%@@@@@@@@% =@@@@@@@@@@@@
@@@@@@@@%*-:---.+*%@@@@@@@@@@@@@@@@+-:+@@@@@@@@@@@
@@@@@@@@@@# ==:.%@@@@@@@@@@@@@@@@@@@@%.-@@@@@@@@@@
@@@@@@@@@@#.@@:.#@@@@@@@@@@@@@@#@@@@@@% *@@@@@@@@@
@@@@@@@@@*::--::=%@@@@@@@@@@@@::@@@@@@@ =@@@@@@@@@
@@@@@@@@-.#@@@@@-.@@@@@@@@@@#.-@@@@@@@@*.-@@@@@@@@
@@@@@@@@.-@@@@@%::@@@@@@@@%=.+@@@@@@@@@@%.-@@@@@@@
@@@@@@@@#::++=::+@@@@@@@%=:=%@@@@@%%@@@@@+ @@@@@@@
@@@@@@@@@@=.:: #@@@@@@@=.+@@@@@@%=:*@@@@@= @@@@@@@
@@@@@@@@@@@@%-.%@@@@@@# *@@@@@#-:+@@@@@@% +@@@@@@@
@@@@@@@@@@@@@.=@@@@@@@@=:===---*@@@@@@@@@.=@@@@@@@
@@@@@@@@@@@@@=.%@@@@@@@@#-##%@@@@@@@@@@@@.-@@@@@@@
@@@@@@@@@@@@@@= -%@@@@@@# #@@@@@@@@@@@@@# #@@@@@@@
@@@@@@@@@@@@@@@ .:=*%%@%#..*@@@@@@@@@@@+.+@@@@@@@@
@@@@@@@@@@@@@@@.=@*==- -=*. --==+*#**=:-#@@@@@@@@@
@@@@@@@@@@@@@@@:-@@@@# #@@+ %%##*..++#%@@@@@@@@@@@
@@@@@@@@@@@@@@@::@@@@-.@@@% *@@@@-:@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@*.=++::%@@@@::%@%+ *@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@%***%@@@@@@%=---=%@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@---OllamaHound---@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@---By 7h30th3r0n3---@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

विषय सूची

• मॉड्यूल
• सामान्य प्रवाह
• मुख्य विशेषताएँ (स्कैनर)
• आवश्यकताएँ
• त्वरित आरंभ
• कमांड चीट शीट
• स्कैनर आउटपुट
• नेविगेटर (स्कैनर CSV सहायक)
• कनेक्टर (इंटरैक्टिव CLI)
• स्क्रैपर (शॉडन सहायक)
• ऑर्केस्ट्रेटर फ़्लैग (उच्च-स्तरीय)
• आउटपुट फ़ाइलें (सारांश)
• मॉडल आकार पार्सिंग पर नोट्स
• सुरक्षा, नैतिकता और दायरा
• लेखक

मॉड्यूल

विशेषताएँ

• ⚡ उच्च‑स्तरीय स्कैनिंग async सॉकेट और समृद्ध प्रगति UI के साथ
• 🧠 संस्करण + CVE वर्गीकरण RCE/DoS एक्सपोज़र के लिए
• ✅ मॉडल सत्यापन /api/tags और /api/generate के माध्यम से
• 🧭 नेविगेटर फ़िल्टर डीडुप, सॉर्टिंग और निर्यात के लिए
• 💬 इंटरैक्टिव कनेक्टर सुरक्षित रूप से प्रॉम्प्ट परीक्षण के लिए

सामान्य प्रवाह

1. लक्ष्य स्क्रैप करें (वैकल्पिक) → results/scraper/targets.txt
2. लक्ष्य स्कैन करें → results/scanner/<prefix>_YYYYMMDD_HHMMSS.csv
3. परिणाम नेविगेट करें + फ़िल्टर करें → वैकल्पिक JSON/CSV निर्यात
4. चुने गए होस्ट/मॉडल से कनेक्ट करें → इंटरैक्टिव CLI

आप इसे चरण-दर-चरण कर सकते हैं या पहले तीन चरणों को जोड़ने के लिए ऑर्केस्ट्रेटर चला सकते हैं।

मुख्य विशेषताएँ (Scanner)

• तेज़, अतुल्यकालिक स्कैनिंग asyncio + aiohttp का उपयोग कर (हजारों सॉकेट इन-फ़्लाइट)
• प्रगति UI (ETA, थ्रूपुट, पूर्णता) rich के माध्यम से
• टाइमस्टैम्प्ड CSV रिपोर्टिंग: <prefix>_YYYYMMDD_HHMMSS.csv
• रंगीन तालिका आउटपुट
  • RCE: लाल
  • DoS: पीला
  • Patched: हरा
• संस्करण पार्सिंग
  • GET /api/version → फ़ॉलबैक GET /version → फ़ॉलबैक Server हेडर
• CVE वर्गीकरण
  • CVE-2024-7773 (RCE): संस्करण < 0.1.47
  • CVE-2025-0317 (DoS): संस्करण <= 0.3.14
• मॉडल डिस्कवरी और सत्यापन
  • GET /api/tags के माध्यम से मॉडलों की गणना

आवश्यकताएँ

• पायथन 3.10+
• पैकेज:
  • aiohttp
  • rich
  • packaging
  • requests
  • shodan

निर्भरताएँ स्थापित करें:

python3 -m pip install -U aiohttp rich packaging requests shodan

Docker का उपयोग करें:

docker build -t ollamahound .
docker run -it --rm ollamahound <ollamahound scripts>

त्वरित आरंभ

त्वरित आरंभ न्यूनतम (2–3 कमांड)

विकल्प A (सबसे तेज़): स्क्रैप → स्कैन → कनेक्ट

python3 ollamaScraper.py
python3 ollamaScanner.py results/scraper/targets.txt --gen-ok-only
python3 ollamaConnector.py --scan-csv results/scanner/ollama_scan_*.csv

विकल्प B (एक-शॉट): ऑर्केस्ट्रेटर पाइपलाइन

python3 ollamaOrchestrator.py --scan-gen-ok-only

ऑर्केस्ट्रेटर (एक-शॉट स्क्रैप → स्कैन → कनेक्ट)

ollamaOrchestrator.py केवल स्क्रैपर, स्कैनर, फिर कनेक्टर चलाता है ताकि आप एक ही कमांड में शॉडन हार्वेस्टिंग से इंटरैक्टिव CLI तक जा सकें। स्क्रैपर और कनेक्टर इंटरैक्टिव रहते हैं, लेकिन ऑर्केस्ट्रेटर आपके लिए उनके आउटपुट को जोड़ देता है।

python3 ollamaOrchestrator.py --scan-gen-ok-only --scan-vuln-only

• लक्ष्य results/orchestrator/targets.txt में लिखे जाते हैं (--targets के साथ बदलें)।
• स्कैनर CSV results/scanner/ में --scan-output-prefix (डिफ़ॉल्ट orchestrator_scan) के उपसर्ग के साथ आते हैं।
• कनेक्टर लॉन्च करते समय स्वचालित रूप से एक पंक्ति चुनने के लिए --connector-row पास करें, या सामान्य रूप से इंटरैक्टिव रूप से चुनें।
• --skip-scrape, --skip-scan, और --skip-connect आपको मौजूदा आउटपुट का उपयोग करके आंशिक रूप से फिर से शुरू करने देते हैं (स्कैन चरण को छोड़ते समय --scan-csv आवश्यक है)।

बाकी यह खंड अभी भी लागू होता है यदि आप प्रत्येक मॉड्यूल को मैन्युअल रूप से चलाना चाहते हैं।

कमांड चीट शीट

Scraper:

# मूल इंटरैक्टिव स्क्रैप (शॉडन dork पिकर)
python3 ollamaScraper.py

# कस्टम आउटपुट फ़ोल्डर + फ़ाइल नाम
python3 ollamaScraper.py --output-dir results/my-scrape -o targets_acme.txt

Scanner:

# targets.txt स्कैन करें (डिफ़ॉल्ट 11434, 500 समवर्तीता, 8s टाइमआउट)
python3 ollamaScanner.py results/scraper/targets.txt

# केवल वे होस्ट जहाँ /api/generate 200 लौटाता है
python3 ollamaScanner.py results/scraper/targets.txt --gen-ok-only

# मल्टी-पोर्ट स्कैन (स्पेस और कॉमा मिक्स)
python3 ollamaScanner.py results/scraper/targets.txt -p 11434 8080,13871

# आक्रामक स्वीप (छोटा टाइमआउट + उच्च समवर्तीता)
python3 ollamaScanner.py results/scraper/targets.txt --timeout 3 -c 800

# केवल कमजोर होस्ट (RCE/DoS) और अज्ञात संस्करण रखें
python3 ollamaScanner.py results/scraper/targets.txt --vuln-only --show-unknown

# कस्टम CSV उपसर्ग + आउटपुट निर्देशिका
python3 ollamaScanner.py results/scraper/targets.txt -o scan_acme.csv --output-dir results/scanner_acme

Navigator:

# स्कैनर CSV की निर्देशिका फ़िल्टर करें
python3 ollamaNavigator.py --scan-csv results/scanner --require-gen-ok --vuln rce

# एकल CSV फ़िल्टर करें, llama मॉडल तक सीमित, आकार >= 7B
python3 ollamaNavigator.py --scan-csv results/scanner/scan_20260107_180002.csv \
  --model llama --min-params 7

# मॉडल बहिष्कृत करें + कीवर्ड खोजें
python3 ollamaNavigator.py --scan-csv results/scanner --exclude-model qwen --search france

# फ़िल्टर की गई पंक्तियाँ निर्यात करें
python3 ollamaNavigator.py --scan-csv results/scanner --vuln dos \
  --json-output results/navigator/dos.json --csv-output results/navigator/dos.csv

# इंटरैक्टिव फ़िल्टर मेनू
python3 ollamaNavigator.py --scan-csv results/scanner --interactive

Connector:

# सीधे कनेक्ट करें
python3 ollamaConnector.py --host http://127.0.0.1:11434 --model llama3

# स्कैनर CSV में एक पंक्ति का उपयोग करें (1-आधारित अनुक्रमणिका)
python3 ollamaConnector.py --scan-csv results/scanner/scan_20260107_180002.csv --scan-row 3

Orchestrator:

# पूर्ण पाइपलाइन
python3 ollamaOrchestrator.py

# पूर्ण पाइपलाइन + केवल gen-ok + vuln-only
python3 ollamaOrchestrator.py --scan-gen-ok-only --scan-vuln-only

# मौजूदा लक्ष्य और CSV का पुन: उपयोग करें, केवल कनेक्टर चलाएं
python3 ollamaOrchestrator.py --skip-scrape --skip-scan --scan-csv results/scanner/scan_20260107_180002.csv

# कनेक्टर छोड़ें (केवल स्क्रैप + स्कैन)
python3 ollamaOrchestrator.py --skip-connect

1) लक्ष्य तैयार करें

targets.txt में प्रति पंक्ति एक हो सकता है:

• एकल IP: 192.0.2.10
• CIDR: 10.0.0.0/24
• FQDN: ollama.example.org

यदि आप स्क्रैपर के साथ सूची उत्पन्न करते हैं, तो स्कैनर को results/scraper/targets.txt (या जो भी पथ आपने --output-dir के साथ चुना है) पर इंगित करें।

ollamaScraper.py शॉडन से क्वेरी करके आपके लिए results/scraper/targets.txt बना सकता है:

python3 ollamaScraper.py

स्क्रिप्ट आपकी API कुंजी को .shodan_api में कैश करती है, आपको एक dork (वैश्विक या देश-स्कोप्ड) चुनने देती है, और प्रत्येक हिट को results/scraper/targets.txt में जोड़ते हुए बुनियादी संदर्भ प्रिंट करती है। आप वैकल्पिक रूप से परिणामों को संकीर्ण करने के लिए org:"Company" फ़िल्टर जोड़ सकते हैं। Ctrl+C या अधिकतम-IP सीमा तक पहुँचने पर रन रुक जाता है। फ़ोल्डर या फ़ाइल नाम बदलने के लिए --output-dir / -o का उपयोग करें, फिर उस पथ को स्कैनर को पास करें।

2) स्कैनर चलाएँ

केवल वे होस्ट दिखाएँ जहाँ /api/generate HTTP 200 लौटाता है:

python3 ollamaScanner.py targets.txt --gen-ok-only

अधिक आक्रामक स्वीप (छोटा टाइमआउट + उच्च समवर्तीता):

python3 ollamaScanner.py targets.txt --gen-ok-only --timeout 3 -c 800

पूर्ण स्वीप उदाहरण:

• पोर्ट 11434 और 8080 स्कैन करें
• 2s टाइमआउट, 1200 समवर्ती सॉकेट
• केवल /api/generate == 200 रखें
• केवल कमजोर होस्ट दिखाएँ + अज्ञात संस्करण शामिल करें
• CSV उपसर्ग scan.csv

python3 ollamaScanner.py targets.txt -p 11434,8080 --timeout 2 -c 1200 \
  --gen-ok-only --vuln-only --show-unknown -o scan.csv

स्कैनर CSV अब results/scanner/ के अंतर्गत आते हैं। यदि आप फ़ाइलों को कहीं और भेजना चाहते हैं तो --output-dir का उपयोग करें (फ़ोल्डर स्वचालित रूप से बनाया जाता है)।

स्कैनर आउटपुट

कंसोल तालिका

स्कैनर एक rich तालिका प्रिंट करता है जिसमें शामिल हैं:

• IP, पोर्ट
• संस्करण (या ? यदि अज्ञात)
• vuln वर्गीकरण (rce, dos, patched, unknown)
• एंडपॉइंट HTTP स्थिति कोड (tags, generate, show)
• खोजे गए मॉडल (केवल जब जनरेशन की पुष्टि हो)

CSV रिपोर्ट

एक टाइमस्टैम्प्ड CSV स्वचालित रूप से लिखा जाता है, उदाहरण के लिए:

ollama_scan_20260107_180002.csv

फ़ील्ड:

• ip, port, version, vuln, tags, generate, show, models

नेविगेटर (स्कैनर CSV सहायक)

नेविगेटर का उपयोग एक CSV या स्कैनर आउटपुट की पूरी निर्देशिका (होस्ट/पोर्ट द्वारा डिडुप, मॉडल विलय) से परिणामों को फ़िल्टर, सॉर्ट और निर्यात करने के लिए करें।

python3 ollamaNavigator.py --scan-csv results/scanner --require-gen-ok --vuln rce --model llama

• --scan-csv एक एकल CSV फ़ाइल या स्कैनर आउटपुट की निर्देशिका स्वीकार करता है।
• फ़िल्टर में मॉडल शामिल/बहिष्कृत, vuln स्थिति, पैरामीटर आकार सीमा, पोर्ट और खोज स्ट्रिंग शामिल हैं।
• सॉर्टिंग: params (डिफ़ॉल्ट), ip, या version.
• मेनू-संचालित फ़िल्टर संपादक + निर्यात के लिए --interactive का उपयोग करें।
• --json-output या --csv-output के साथ फ़िल्टर की गई पंक्तियाँ निर्यात करें।

कनेक्टर (इंटरैक्टिव CLI)

एक खोजे गए इंस्टेंस से कनेक्ट करें और प्रतिक्रियाएँ स्ट्रीम करें:

python3 ollamaConnector.py --host http://127.0.0.1:11434 --model llama3

यदि आप --model छोड़ते हैं, तो CLI /api/tags लाता है, सर्वर द्वारा उजागर किए गए प्रत्येक मॉडल को सूचीबद्ध करता है, और आपको संख्या द्वारा चुनने देता है। प्रत्येक प्रॉम्प्ट सर्वर के समाप्त होने या Ctrl+C दबाने तक सियान में टोकन स्ट्रीम करता है। बाहर निकलने के लिए exit / quit टाइप करें।

आप कनेक्टर को स्कैनर CSV के अंदर एक पंक्ति पर भी इंगित कर सकते हैं ताकि आपको होस्ट और मॉडल दोबारा न लिखना पड़े:

python3 ollamaConnector.py --scan-csv scan_20260107_141056.csv --scan-row 3

--scan-row 1-आधारित है (हेडर के बाद पहली पंक्ति 1 है)। यदि आप इसे छोड़ते हैं, तो कनेक्टर CSV लोड करता है, आपको प्रत्येक होस्ट (IP/पोर्ट, vuln स्थिति, पहला मॉडल) दिखाता है, आपको इंडेक्स चुनने देता है, फिर खोजे गए मॉडलों को सूचीबद्ध करता है ताकि आप चुन सकें कि किससे बात करनी है। मॉडल प्रॉम्प्ट के दौरान 0 चुनने पर एक नई /api/tags फ़ेच पर जाता है, इसलिए मूल कनेक्टर व्यवहार अभी भी काम करता है यदि CSV पुराना या खाली है।

स्क्रैपर (शॉडन सहायक)

ollamaScraper.py एक सरल सहायक है जो .shodan_api टोकन फ़ाइल रखता है, एक देश (या वैश्विक) के लिए संकेत देता है, आपको कई तैयार शॉडन dorks (या एक कस्टम क्वेरी) में से चुनने देता है, फिर शॉडन पेजों पर चलता है जब तक आप बाधित नहीं करते या उपयोगकर्ता-परिभाषित होस्ट सीमा तक नहीं पहुँचते। प्रत्येक IP results/scraper/targets.txt में लिखा जाता है, जिसका अर्थ है कि स्कैनर तुरंत आउटपुट का पुन: उपयोग कर सकता है। यदि वांछित हो तो --output-dir के माध्यम से एक अलग निर्देशिका प्रदान करें।

यह वैकल्पिक रूप से एक कंपनी/संगठन फ़िल्टर भी प्रदान करता है जो dork में org:"Company" जोड़ता है, और केवल उन सिस्टमों को लक्षित करने की चेतावनी प्रिंट करता है जिनके आप स्वामी हैं या जिनके परीक्षण की स्पष्ट अनुमति है।

ऑर्केस्ट्रेटर फ़्लैग (उच्च-स्तरीय)

• --skip-scrape, --skip-scan, --skip-connect पाइपलाइन के कुछ हिस्सों को फिर से शुरू करने के लिए
• --targets साझा लक्ष्य फ़ाइल चुनने के लिए
• --ports, --scan-concurrency, --scan-timeout स्कैनर चरण को ट्यून करने के लिए
• --scan-output-prefix, --scan-output-dir स्कैनर CSV आउटपुट को नियंत्रित करने के लिए
• --scan-gen-ok-only, --scan-vuln-only, --scan-show-unknown स्कैनर फ़िल्टर के लिए
• --scan-csv स्कैन छोड़ते समय मौजूदा स्कैनर CSV का पुन: उपयोग करने के लिए

आउटपुट फ़ाइलें (सारांश)

मॉडल आकार पार्सिंग पर नोट्स

नेविगेटर 7B, 13b, या 500m जैसे मॉडल नामों से पैरामीटर आकार निकालता है। प्रति होस्ट सबसे बड़ा आकार तालिका में प्रदर्शित होता है और सॉर्टिंग/फ़िल्टरिंग (--min-params / --max-params) के लिए उपयोग किया जाता है।

सुरक्षा, नैतिकता और दायरा

OllamaHound रक्षात्मक और अधिकृत आक्रामक सुरक्षा के लिए बनाया गया है:

• केवल उन सिस्टमों पर उपयोग करें जिनके आप स्वामी हैं या जहाँ आपके पास स्पष्ट लिखित अनुमति है।
• स्कैन करने से पहले दायरा, कानूनी बाधाओं और सहभागिता नियमों को मान्य करें।
• किसी भी खोजे गए डेटा/मॉडल/आउटपुट को संवेदनशील मानें।

लेखक

7h30th3r0n3