<p align="center">
<img src="https://raw.githubusercontent.com/KatrielMoses/voidaccess/HEAD/public/logo_circle.png" width="160" alt="VoidAccess logo">
</p>
<h1 align="center">VoidAccess</h1>
<p align="center">
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
<a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.10%2B-blue.svg" alt="Python 3.10+"></a>
<a href="docker-compose.yml"><img src="https://img.shields.io/badge/Docker-Compose-blue.svg" alt="Docker Compose"></a>
<a href="https://pypi.org/project/voidaccess/"><img src="https://img.shields.io/pypi/v/voidaccess?logo=pypi&logoColor=white" alt="PyPI version"></a>
<a href="https://pypi.org/project/voidaccess/"><img src="https://img.shields.io/pypi/dm/voidaccess" alt="PyPI downloads"></a>
</p>
자체 호스팅 가능한 OSINT(Open Source Intelligence) 도구로, 다크 웹 리서치 쿼리를 구조화된 위협 인텔리전스로 변환합니다. 수집(collection), 풍부화(enrichment), 관계 매핑(relationship mapping), 그리고 단일 워크플로우 내에서의 내보내기(export)가 필요한 보안 연구원, 위협 인텔리전스 팀, 승인된 조사관을 위해 구축되었습니다.
터미널 출력
VoidAccess
빠른 시작
pip install voidaccess
voidaccess investigate "LockBit ransomware" --no-llm --no-tor --depth shallow
voidaccess list
...
VoidAccess investigation demo
기능 설명
- 병렬 수집 (Parallel collection) - Tor 인덱스, 붙여넣기 사이트(paste sites), 코드 포지(code forges), 보안 피드, 그리고 선별된
.onion 시드를 검색합니다.
- 개체 추출 (Entity extraction) - IOC(침해 지표), 지갑, 자격 증명, 핸들, 취약점, 행위자(actors), 악성코드, 사람, 조직을 찾습니다.
- 다중 소스 강화 (Multi-source enrichment) - 평판, 유출(breach), 수동 DNS(passive DNS), 샌드박스, 블록체인, 위협 피드 컨텍스트를 추가합니다.
- 행위자 인텔리전스 (Actor intelligence) - 별명(aliases), 인프라, 메모, 타임라인, 그리고 교차 조사 관계를 유지합니다.
- 관계 그래프 (Relationship graphs) - 동시 발생 그래프, 커뮤니티, 경로, 그리고 인프라 클러스터를 구축합니다.
- 콘텐츠 안전성 (Content safety) - 필수 파이프라인 게이트에서 금지된 쿼리, URL, 콘텐츠, 추출된 개체를 필터링합니다.
- 구조화된 내보내기 (Structured exports) - STIX 2.1, MISP, Sigma, YARA, Snort, Suricata, CSV, Markdown, JSON, 그리고 IOC 패키지를 생성합니다.
- CLI 및 웹 UI - SQLite를 사용하거나 PostgreSQL과 브라우저 인터페이스가 있는 Docker Compose 스택으로 로컬에서 실행됩니다.
파이프라인 (Pipeline)
| 단계 (Stage) | 동작 (Action) |
|---|
| 1 | 선택된 LLM을 사용하여 조사 쿼리를 정제합니다 (Refine the investigation query with the selected LLM) |
| ... | |
| Full pipeline behavior, timeouts, recovery, and data flow are documented in Architecture. | |
개체 유형 (Entity Types)
| 카테고리 (Category) | 예시 (Examples) |
|---|
| 암호화폐 (Cryptocurrency) | Bitcoin, Ethereum, Monero, Litecoin, Zcash, Solana, Tron, ENS |
| ... | |
수집 및 강화 (Collection and Enrichment)
| 계층 (Layer) | 소스 (Sources) |
|---|
| 다크 웹 검색 (Dark-web search) | 16개 이상의 Tor 검색 엔진 및 선별된 .onion 시드 |
| ... | |
| Sources that need API keys skip cleanly when their keys are absent. The complete key and configuration reference is in Architecture. | |
선택적 벡터 임베딩 (Optional vector embeddings)
The default installation can run without PyTorch. When the embedding stack is unavailable, VoidAccess logs that it is using a deterministic SHA-256 fallback encoder. Install the optional NLP dependencies to enable full sentence-transformer vector embeddings:
pip install "voidaccess[nlp]"
LLM 제공업체 (LLM Providers)
Provider | Typical models | Notes |
|---|---|
| OpenRouter | DeepSeek, Llama, Claude | 기본 경로(Default route); 무료 모델 사용 가능 |
| ... |
CLI 참고 자료 (CLI Reference)
| 명령어 (Command) | 설명 (Description) |
|---|
voidaccess investigate "QUERY" | 조사 실행 (Run an investigation) |
| ... | |
선택적 클린넷(clearnet) 요청은 --use-scraping-api 또는 --use-proxies와 함께 ScrapingAnt를 사용할 수 있으며, Tor, .onion, GitHub 및 GitLab 트래픽에는 영향을 주지 않습니다. | |
자체 호스팅 (Self-Hosting)
Docker Compose를 사용하여 전체 PostgreSQL, Tor, FastAPI, Next.js 스택을 실행합니다. 자체 호스팅 가이드에서는 안내된 설정(guided setup), 환경 구성, 운영 및 문제 해결 방법을 다룹니다.
링크 (Links)
| | |
|-||
| 자체 호스팅 가이드 | Docker Compose, 환경 설정, 운영 및 문제 해결 방법 |
| ... |
라이선스 (License)
MIT. VoidAccess는 승인된 보안 연구 및 위협 인텔리전스(threat-intelligence) 작업에만 사용해야 합니다. 사용 정책을 참조하십시오.