OllamaHound는 공개적으로 노출된 Ollama 서버를 발견하고, 버전을 식별하며, CVE 노출 여부를 분류하고, 텍스트 생성이 가능한지 검증하며, (선택적으로) 통제된 테스트를 위한 대화형 CLI 세션을 활성화하는 모듈식 RedTeam 지향 툴킷입니다.

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

목차

• 모듈
• 일반적인 흐름
• 주요 기능 (스캐너)
• 요구 사항
• 빠른 시작
• 명령어 치트 시트
• 스캐너 출력
• 내비게이터 (스캐너 CSV 도우미)
• 커넥터 (대화형 CLI)
• 스크레이퍼 (Shodan 도우미)
• 오케스트레이터 플래그 (고수준)
• 출력 파일 (요약)
• 모델 크기 구문 분석 참고 사항
• 안전, 윤리 및 범위
• 저자

모듈

기능

• ⚡ 비동기 소켓과 풍부한 진행 UI를 사용한 대규모 스캐닝
• 🧠 버전 + CVE 분류로 RCE/DoS 노출 확인
• ✅ 모델 검증 via /api/tags 및 /api/generate
• 🧭 중복 제거, 정렬 및 내보내기를 위한 내비게이터 필터
• 💬 안전한 프롬프트 테스트를 위한 대화형 커넥터

일반적인 흐름

1. 대상 스크래핑 (선택 사항) → results/scraper/targets.txt
2. 대상 스캔 → results/scanner/<prefix>_YYYYMMDD_HHMMSS.csv
3. 결과 탐색 + 필터링 → 선택적 JSON/CSV 내보내기
4. 선택한 호스트/모델에 연결 → 대화형 CLI

단계별로 수행하거나 오케스트레이터를 실행하여 처음 세 단계를 연결할 수 있습니다.

주요 기능 (스캐너)

• 빠른 비동기 스캐닝: asyncio + aiohttp 사용 (수천 개의 동시 소켓)
• 진행 UI: rich를 통한 ETA, 처리량, 완료율
• 타임스탬프가 있는 CSV 보고서: <prefix>_YYYYMMDD_HHMMSS.csv
• 색상화된 테이블 출력
  • RCE: 빨강
  • DoS: 노랑
  • 패치됨: 초록
• 버전 구문 분석
  • GET /api/version → 대체 GET /version → 대체 Server 헤더
• CVE 분류
  • CVE-2024-7773 (RCE): 버전 < 0.1.47
  • CVE-2025-0317 (DoS): 버전 <= 0.3.14
• 모델 발견 및 검증
  • GET /api/tags를 통해 모델 열거
  • POST /api/generate를 통해 생성 테스트
• 스마트 정렬
  • /api/generate가 HTTP 200을 반환하는 호스트가 상단에 표시됨
• 강력한 필터
  • --gen-ok-only: /api/generate가 작동하는 호스트만 유지
  • --vuln-only: RCE/DoS로 분류된 호스트만 유지
  • --show-unknown: 알 수 없거나 구문 분석할 수 없는 버전의 호스트 포함
• 조정 가능
  • 다중 포트, 시간 초과, 동시성, CSV 접두사

요구 사항

• Python 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 스크립트>

빠른 시작

최소 빠른 시작 (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는 스크레이퍼, 스캐너, 커넥터를 순차적으로 실행하여 단일 명령어로 Shodan 수집부터 대화형 CLI까지 이동할 수 있도록 합니다. 스크레이퍼와 커넥터는 대화형으로 유지되지만, 오케스트레이터가 출력을 연결해 줍니다.

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

• 대상은 results/orchestrator/targets.txt에 기록됩니다 (--targets로 변경 가능).
• 스캐너 CSV는 --scan-output-prefix (기본값 orchestrator_scan) 접두사로 results/scanner/에 저장됩니다.
• --connector-row를 전달하여 커넥터 실행 시 행을 자동 선택하거나, 평소처럼 대화식으로 선택합니다.
• --skip-scrape, --skip-scan, --skip-connect를 사용하면 기존 출력을 사용하여 중간부터 재개할 수 있습니다 (스캔 단계를 건너뛸 때는 --scan-csv가 필요).

이 섹션의 나머지 부분은 수동으로 각 모듈을 실행하려는 경우에도 적용됩니다.

명령어 치트 시트

스크레이퍼:

# 기본 대화형 스크래핑 (Shodan dork 선택기)
python3 ollamaScraper.py

# 사용자 정의 출력 폴더 + 파일명
python3 ollamaScraper.py --output-dir results/my-scrape -o targets_acme.txt

스캐너:

# targets.txt 스캔 (기본값 11434, 동시성 500, 타임아웃 8초)
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

내비게이터:

# 스캐너 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

커넥터: