OllamaHound est une boîte à outils modulaire orientée RedTeam pour découvrir les serveurs Ollama exposés publiquement, identifier les versions, classer l'exposition aux CVE, vérifier si la génération de texte est possible, et (optionnellement) activer une session CLI interactive pour des tests contrôlés.

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

Table des matières

• Modules
• Flux typique
• Fonctionnalités principales (Scanner)
• Prérequis
• Démarrage rapide
• Aide-mémoire des commandes
• Sortie du scanner
• Navigator (assistant CSV du scanner)
• Connector (CLI interactive)
• Scraper (assistant Shodan)
• Options de l'orchestrateur (vue d'ensemble)
• Fichiers de sortie (résumé)
• Notes sur l'analyse de la taille des modèles
• Sécurité, éthique et périmètre
• Auteur

Modules

Fonctionnalités

• ⚡ Scan à grande échelle avec sockets asynchrones et interface de progression riche
• 🧠 Classification version + CVE pour l'exposition RCE/DoS
• ✅ Validation des modèles via /api/tags et /api/generate
• 🧭 Filtres Navigator pour déduplication, tri et export
• 💬 Connector interactif pour tester des invites en toute sécurité

Flux typique

1. Collecter des cibles (optionnel) → results/scraper/targets.txt
2. Scanner les cibles → results/scanner/<prefix>_YYYYMMDD_HHMMSS.csv
3. Naviguer et filtrer les résultats → exports JSON/CSV optionnels
4. Se connecter à un hôte/modèle choisi → CLI interactive

Vous pouvez procéder étape par étape ou exécuter l'Orchestrator pour enchaîner les trois premières étapes.

Fonctionnalités principales (Scanner)

• Scan rapide et asynchrone utilisant asyncio + aiohttp (des milliers de sockets en vol)
• Interface de progression (ETA, débit, achèvement) via rich
• Rapport CSV horodaté : <prefix>_YYYYMMDD_HHMMSS.csv
• Tableau de sortie coloré
  • RCE : rouge
  • DoS : jaune
  • Corrigé : vert
• Analyse de version
  • GET /api/version → repli GET /version → repli en-tête Server
• Classification CVE
  • CVE-2024-7773 (RCE) : version < 0.1.47
  • CVE-2025-0317 (DoS) : version <= 0.3.14
• Découverte et validation des modèles
  • Énumère les modèles via GET /api/tags
  • Teste la génération via POST /api/generate
• Tri intelligent
  • Les hôtes où /api/generate renvoie HTTP 200 remontent en tête
• Filtres puissants
  • --gen-ok-only ne conserve que les hôtes avec /api/generate fonctionnel
  • --vuln-only ne conserve que les hôtes classés RCE/DoS
  • --show-unknown inclut les hôtes dont la version est inconnue/non analysable
• Paramétrable
  • multi‑ports, timeouts, concurrence, préfixe CSV

Prérequis

• Python 3.10+
• Paquets :
  • aiohttp
  • rich
  • packaging
  • requests
  • shodan

Installer les dépendances :

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

Utiliser Docker :

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

Démarrage rapide

Démarrage rapide minimal (2–3 commandes)

Option A (la plus rapide) : collecter → scanner → connecter

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

Option B (tout-en-un) : pipeline orchestrateur

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