개요

Osiris는 여러 인텔리전스 영역에 걸쳐 상황 인식을 제공하는 프로덕션급 OSINT 플랫폼입니다. Next.js 16과 MapLibre GL로 구축되었으며, 모든 데이터 포인트는 WebGL을 통해 렌더링되어 수천 개의 동시 엔티티가 화면에 있어도 60fps 성능을 유지합니다.

주요 기능

아키텍처

┌─────────────────────────────────────────────────┐
│                  OSIRIS CLIENT                   │
│  ┌──────────┐  ┌──────────┐  ┌───────────────┐ │
│  │ MapLibre  │  │  HUD     │  │  RECON Toolkit│ │
│  │  GL (GPU) │  │ Panels   │  │  Port Scan    │ │
│  │  WebGL    │  │ Layers   │  │  DNS / WHOIS  │ │
│  │  Render   │  │ Controls │  │  Vuln Scanner │ │
│  └──────────┘  └──────────┘  └───────────────┘ │
├─────────────────────────────────────────────────┤
│               NEXT.JS API ROUTES                 │
│  /api/flights         /api/earthquakes          │
│  /api/cctv            /api/news                 │
│  /api/fires           /api/maritime             │
│  /api/gdelt           /api/satellites           │
│  /api/weather         /api/scanner              │
│  /api/sentinel        /api/telegram-feed        │
│  /api/osint/*  (whois, dns, ip, cve, sanctions, │
│                 crypto, sweep, threats, …)      │
├─────────────────────────────────────────────────┤
│              EXTERNAL DATA SOURCES               │
│  OpenSky · USGS · NASA · NOAA · TfL · NVD      │
│  GDACS · EONET · FIRMS · N2YO · RSS Feeds      │
│  blockstream.info · Blockscout · OpenSanctions  │
│  t.me public previews                            │
└─────────────────────────────────────────────────┘

기능

인텔리전스 레이어

• 16개의 토글 가능한 데이터 레이어와 실시간 엔티티 수
• GPU 가속 렌더링 — 모든 지도 데이터가 DOM이 아닌 WebGL을 통해 렌더링됨
• 점진적 로딩 — 레이어가 활성화될 때 온디맨드로 데이터를 가져옴
• 뷰포트 인식 — 보이는 영역에 관련된 데이터만 로드

텍사스 CCTV

공개 TxDOT ITS 스냅샷이 기존 카메라 마커, 미리보기 그리드 및 뷰어와 통합되었습니다. 텍사스만 원하면 /api/cctv?region=texas를 사용하세요. 글로벌 및 텍사스 위치 쿼리에는 동일한 소스가 포함됩니다. 지구별 인벤토리는 독립적으로 캐시되며, 장애 중에는 오래된 데이터가 유지됩니다. 가용성은 지구와 카메라에 따라 다릅니다. 이는 비디오 스트림이 아닌 갱신되는 JPEG 스냅샷입니다.

출처: TxDOT ITS.

오프라인 검사는 npm test를 실행하거나, 공개 텍사스 인벤토리를 확인하려면 RUN_LIVE_TESTS=1 npx vitest run src/app/api/cctv/texas.test.ts를 실행하세요.

RECON 툴킷

• 포트 스캐너 — 서비스 핑거프린팅을 포함한 TCP 연결 스캔
• DNS 조회 — 전체 레코드 확인 (A, AAAA, MX, NS, TXT, CNAME)
• WHOIS — 도메인/IP 등록 데이터 (OFAC SDN과 자동 교차 확인)
• SSL/TLS 검사기 — 인증서 체인 분석
• IP 인텔리전스 — 지리적 위치, ASN, 위협 평판 (OFAC SDN과 자동 교차 확인)
• 취약점 스캐너 — NVD 데이터베이스에 대한 CVE 조회
• 암호화폐 지갑 추적 — BTC + ETH 조회 (잔액, 트랜잭션 내역, OFAC SDN 제재 플래그)
• OFAC 제재 검색 — 미국 OFAC SDN 목록에 대해 개인, 조직, 선박 및 항공기를 조회

라이브 방송 네트워크

• 글로벌 방송사의 23개 라이브 24/7 뉴스 스트림
• 지도에서 뉴스 점을 클릭하면 라이브 스트림이 열림
• NBC, CBS, ABC, Sky News, Al Jazeera, France 24, NHK, WION 등의 피드

텔레그램 OSINT 레이어

• 인증이 필요 없는 t.me/s/<channel> 웹 미리보기에서 스크래핑한 공개 채널 피드 — Bot API 토큰도, MTProto도 필요 없음
• 기본 큐레이션된 5개 채널 세트 (영어 + 러시아어/우크라이나어 전쟁 보도), OSIRIS_TELEGRAM_CHANNELS로 재정의 가능
• 게시물은 다국어 장소 사전 (영어 + 키릴 문자 + 아랍어)에 대해 지오파싱되어 지도에 표시됨
• 청록색 점을 클릭하면 게시물을 읽고 텔레그램의 원본으로 이동

암호화폐 지갑 인텔리전스

• BTC 조회는 blockstream.info (Esplora API, 키 불필요)를 통해
• ETH 조회는 Blockscout의 공개 ETH 인스턴스 (eth.blockscout.com, 키 불필요)를 통해
• 모든 조회는 OFAC SDN 제재 주소 목록 (0xB10C/ofac-sanctioned-digital-currency-addresses에서 미러링됨)과 교차 확인됨
• 제재된 지갑은 RECON 패널에 빨간색 SANCTIONED — OFAC SDN 배지를 표시함

OFAC SDN 교차 확인

• RECON 툴킷의 독립형 SANCTIONS 탭 — 개인, 조직, 선박 및 항공기에 대한 전체 텍스트 검색
• WHOIS 및 IP 인텔 경로는 등록자 / ASN 소유자 이름을 SDN 목록과 자동 교차 확인하고 인라인 경고를 표시함
• 데이터 출처는 OpenSanctions (CC-BY 4.0) — 키 불필요, 약 7MB가 24시간 동안 메모리에 캐시됨

분쟁 지역 모니터링

• 심각도에 따라 코드화된 경고 마커가 있는 13개 활성 분쟁/긴장 지역
• 활성 전쟁: 우크라이나, 가자, 수단, 미얀마, 콩고민주공화국, 예멘
• 높은 긴장: 시리아, 레바논, 사헬, 소말리아, 홍해
• 상승: 대만 해협, 한반도 비무장지대

성능 최적화

• 초기 릴리스 대비 엣지 요청 75% 감소
• 공격적인 폴링 완화 (안정적인 데이터의 경우 15-30분 간격)
• 정적 데이터는 메모리에서 제공 (뉴스 피드에 대한 외부 API 호출 제로)
• layerFetchedRef가 중복 API 요청을 방지

빠른 시작

git clone https://github.com/simplifaisoul/osiris.git
cd osiris
npm install
npm run dev

http://localhost:3000을 여세요

Docker / 셀프 호스팅

git clone https://github.com/simplifaisoul/osiris.git
cd osiris
cp .env.template .env     # optional — configure keys / port
docker compose up -d

http://localhost:3000을 여세요. 이미지는 멀티 스테이지 node:22-alpine 독립 실행형 빌드 (~220 MB, 비루트)입니다. compose 파일은 또한 CasaOS에서 원클릭 설치를 위한 CasaOS 앱 메타데이터 (x-casaos:)를 포함합니다. 전체 Docker, CasaOS 및 API 키 가이드는 **DOCKER.md**를 참조하세요.

사전 빌드된 이미지 (GHCR) — 빌드를 건너뛰고 직접 가져오세요:

docker pull ghcr.io/simplifaisoul/osiris:latest
docker run -d -p 3000:3000 --env-file .env ghcr.io/simplifaisoul/osiris:latest

사용자 지정 포트 — 컨테이너는 항상 3000에서 수신 대기합니다. compose 파일을 편집하지 않고 게시된 호스트 포트를 변경하려면 .env에서 OSIRIS_PORT를 설정하세요 (예: OSIRIS_PORT=3005).

환경 변수

OSIRIS는 API 키 없이도 부분적으로 작동합니다 — 모든 핵심 피드는 공개된 키 불필요 소스를 사용합니다. .env.template을 .env로 복사하고 필요한 것만 설정하세요:

# Published host port (container always listens on 3000). Default: 3000
OSIRIS_PORT=3000

# RECON scanner backend (the only vars the current code reads).
# SCANNER_KEY must match the backend's OSIRIS_KEY — generate with: openssl rand -hex 32
SCANNER_URL=
SCANNER_KEY=

# Optional, for higher rate limits / future sources (see DOCKER.md for signup links)
FIRMS_API_KEY=                # NASA FIRMS  — firms.modaps.eosdis.nasa.gov/api/map_key/
OPENSKY_CLIENT_ID=            # OpenSky OAuth2 (since Mar 2025) — opensky-network.org
OPENSKY_CLIENT_SECRET=
N2YO_API_KEY=                 # N2YO satellites — n2yo.com (Profile → API key)
AIS_API_KEY=                 # aisstream.io maritime

SCANNER_URL/SCANNER_KEY가 없으면 RECON 툴킷은 503을 반환하지만, 다른 모든 레이어는 별도 설정 없이 작동합니다. .env는 gitignore 처리되어 있으며 템플릿만 커밋됩니다.

기술 스택

키보드 단축키

감사의 글

공개 웹캠 — 이 레이어의 카메라는 공개 데이터입니다. 각 카메라는 운영하는 사람이 자신의 사이트나 채널에서 공개적으로 방송하는 것입니다. 웹에 부족했던 것은 이들의 카탈로그였습니다.

bekijkhet.nu가 바로 그 카탈로그이며, 이 레이어의 모든 카메라의 기반입니다. Bram과 Annelies는 2012년부터 이를 수작업으로 유지해 왔으며, 그들의 색인이 없었다면 이 카메라들은 여전히 수백 개의 무관한 사이트에 흩어져 있어 찾을 방법이 없었을 것입니다.

OSIRIS는 이들 모두를 운영하는 운영자에게 바로 연결하며, 이는 bekijkhet.nu가 읽히기를 요청하는 방식이기도 합니다.

라이선스

MIT — 자세한 내용은 LICENSE를 참조하세요.