Flowsint 딥다이브
— 엔티티를 그래프로 잇는 오픈소스 OSINT 수사 플랫폼

1프로젝트 한줄 요약

이 레포가 무엇을 하는 물건인가.

Flowsint는 OSINT (Open Source Intelligence, 공개 출처 정보) 조사를 위한 그래프 기반 수사 플랫폼입니다. OSINT란 누구나 접근할 수 있는 공개된 정보(WHOIS 등록 정보, DNS 기록, 공개 SNS 계정, 유출된 데이터베이스 목록 등)를 모아 의미 있는 그림을 그리는 활동을 말합니다. 해킹이 아니라, 이미 공개된 조각들을 잘 엮는 것이 핵심입니다.

사용 방식은 단순합니다. 화면에 도메인·이메일·IP 같은 엔티티(entity, 조사 대상이 되는 객체) 노드를 하나 놓고, 그 노드에서 엔리처를 실행하면 관련된 새 노드들이 그래프에 붙습니다. 이 과정을 반복하면 처음엔 점 하나였던 화면이 수백 개의 노드와 관계선으로 이루어진 관계 지도로 자라납니다.

2왜 주목받는가

트렌딩 이유 · 경쟁 대비 장점.

OSINT 그래프 도구의 대명사는 오랫동안 상용 소프트웨어인 Maltego였습니다. 강력하지만 비싸고, 데이터가 외부 서버를 거치는 구조라 민감한 조사에는 부담이 있었습니다. Flowsint는 완전 오픈소스 + 자체 호스팅(self-hosted)으로 이 빈자리를 노립니다 — 내 컴퓨터에서 Docker로 띄우면 끝이고, 데이터는 한 발짝도 밖으로 나가지 않습니다.

두 번째 강점은 확장성입니다. 엔리처가 도메인·IP·ASN·이메일·전화번호·암호화폐 지갑·SNS 닉네임 등 30종 이상 내장돼 있고, 모듈식 구조라 새 엔리처를 코드로 쉽게 추가할 수 있습니다. 세 번째는 성능 — 프론트엔드가 WebGL 렌더링(pixi.js)을 써서 노드가 수천 개로 불어나도 화면이 버벅이지 않습니다.

3기술 스택 전체 지도

프론트엔드·백엔드·데이터·인프라를 한눈에.

Flowsint는 TypeScript 프론트엔드 + Python 백엔드의 조합입니다. 언어 비중도 거의 반반(TS 약 153만 줄, Python 약 128만 줄)이라 어느 한쪽이 곁다리가 아니라 둘 다 본체입니다. 가장 독특한 점은 데이터베이스를 둘 쓴다는 것 — 관계형 DB(PostgreSQL)와 그래프 DB(Neo4j)를 역할에 따라 나눠 씁니다.

4아키텍처 심화 분석

데이터가 어디서 어디로 흐르는가.

Flowsint는 다섯 개의 독립 모듈로 쪼갠 모듈식 모노레포(modular monorepo)입니다. 하나의 저장소 안에 여러 패키지를 두되, 서로의 의존 방향을 한 줄기로 고정한 것이 특징입니다. 위층은 아래층을 알지만 아래층은 위층을 모릅니다 — 덕분에 엔리처(아래층)를 고쳐도 화면(위층)이 깨지지 않습니다.

구조가 한눈에 안 들어와도 괜찮습니다. 흐름 한 줄기를 끝까지 따라가 보면 전체가 잡힙니다. "사용자가 도메인 노드에서 '서브도메인 찾기' 엔리처를 실행했다"는 가장 흔한 동작 하나를 추적해 봅시다.

5디렉토리 구조 해부

어떤 폴더가 무슨 일을 하나.

루트에는 다섯 개의 flowsint-* 모듈과, 환경별 Docker Compose 파일 세 종, 그리고 모든 명령을 묶어주는 Makefile이 있습니다. 모듈 이름만 봐도 역할이 드러나는 설명적 작명이 이 레포의 관례입니다.

개발 워크플로도 이 구조를 그대로 따릅니다 — 새 타입은 flowsint-types에, 새 엔리처는 flowsint-enrichers에, 새 API는 flowsint-api에. 어디에 무엇을 넣을지가 폴더 이름만으로 정해지니, 초보자가 길을 잃기 어렵습니다.

6학습 포인트 (기술별)

이 레포에서 배울 만한 것 + 어디를 보면 되는지.

엔리처가 어떤 모양인지 감을 잡기 위한 개념 코드입니다(실제 코드가 아니라 패턴을 단순화한 예시):

# 모든 엔리처가 공유하는 약속: 엔티티를 받아 새 엔티티들을 돌려준다
class SubdomainEnricher(BaseEnricher):
    input_type = Domain          # 도메인을 입력으로
    output_type = Domain         # 서브도메인(역시 도메인)을 출력으로

    def run(self, entity: Domain) -> list[Domain]:
        subs = discover_subdomains(entity.name)   # 실제 스캔
        return [Domain(name=s) for s in subs]      # 그래프에 붙을 새 노드들

7시스템 요구사항

돌리려면 무엇이 필요한가.

좋은 소식은 전부 Docker로 묶여 있다는 점입니다. 언어 런타임을 일일이 깔 필요 없이, Docker와 Make만 있으면 make prod 한 줄로 다섯 개 서비스가 한꺼번에 뜹니다.

# 설치 3줄 — README가 약속하는 가장 빠른 길
git clone https://github.com/reconurge/flowsint.git
cd flowsint
make prod   # → http://localhost:5173/register 에서 계정 생성

8직접 해볼 수 있는 실습 과제

난이도별로 손에 익히는 단계.

9관련 기술 심화 학습 로드맵

한 주씩 따라가는 계획.

10핵심 키워드 사전

본문에 나온 용어 빠른 참조.

11참고 링크

• GitHub: reconurge/flowsint
• 공식 사이트: flowsint.io
• 윤리 가이드라인: ETHICS.md
• Neo4j 문서: neo4j.com/docs
• FastAPI 문서: fastapi.tiangolo.com
• React Flow 문서: reactflow.dev