암호화된 P2P 메시 VPN으로 원격 모바일 포렌식을 지원하며, 무선 ADB 및 libimobiledevice 수집, 네트워크 모니터링, NAT 및 방화벽을 통한 침입 탐지를 가능하게 합니다.
MESHforensics는 암호화된 검열 저항형 피어 투 피어 메시 네트워크를 통해 모바일 기기에 대한 인터넷 라우팅 가능한 무선 디버깅을 지원합니다.
모바일 기기는 종종 NAT, 방화벽 또는 직접 인바운드 접근을 차단하는 제한적인 통신사 네트워크 뒤에 갇혀 있습니다. MESHforensics는 암호화된 피어 투 피어 오버레이를 생성하고 가상 TUN 인터페이스를 통해 각 노드에 CGNAT 범위 주소를 할당하므로, 기기들은 마치 사설 서브넷을 공유하는 것처럼 동작하며, 중앙 VPN, 포트 포워딩 또는 상시 인프라가 필요하지 않습니다.
이를 통해 분석가는 기기가 로컬에 있는 것처럼 WARD, MVT, AndroidQF와 같은 도구를 사용하여 ADB 무선 디버깅 및 libimobiledevice를 통한 원격 모바일 포렌식을 수행할 수 있습니다. MESHforensics는 또한 동일한 메시를 통한 PCAP 캡처 및 Suricata 침입 탐지를 포함한 원격 네트워크 모니터링도 지원합니다.
메시는 일시적이며 분석가가 제어합니다. 기기를 온라인으로 연결하고, 수집한 다음, 네트워크를 해체하므로 지문 채취에 노출될 만한 것이 아무것도 실행 중인 상태로 남지 않습니다.
[!IMPORTANT] 퍼블릭 베타: 활발히 개발 중입니다. 전체 침투 테스트가 완료되었고 주요 취약점이 패치되었습니다. 호환성을 깨는 변경이 예상되며, 일정 수준의 기술 전문성이 필요합니다. 버그나 보안 문제는 GitHub Issues를 통해 보고해 주세요.
전체 문서: https://docs.meshforensics.org/
먼저 저장소를 클론하세요:
git clone https://github.com/BARGHEST-ngo/mesh.git
cd MESH
그런 다음 인터넷에서 제어 플레인에 접근하는 방식을 선택하세요.
워크스테이션에서 제어 플레인을 실행하고, 호스팅 리버스 프록시 터널인 MESHforensics 프로비저너를 통해 노출하세요. BARGHEST에 프로비저너 API 키를 요청하세요(https://docs.meshforensics.org/ 참조). 프로비저너는 임시 *.tunnels.meshforensics.app 서브도메인을 자동 할당하고 API 자격 증명을 발급하므로, 이 경로에서는 task apikey가 필요하지 않습니다.
# Choose the "Ephemeral" control plane when prompted
task build
task controlPlane
# Open the web UI at the provisioner-assigned URL and log in
자체 인그레스(인터넷에 노출된 서버의 리버스 프록시 또는 Cloudflare Tunnel이나 ngrok과 같은 터널링 서비스)를 준비한 다음, 로컬에서 API 키를 발급하세요.
# Choose the "Persistent" control plane when prompted, and your own domain
# (or the hostname your Cloudflare Tunnel / ngrok endpoint provides)
task build
task controlPlane
task apikey
# Open the web UI and log in with the API key
# Local: https://localhost
# Remote: https://your-domain:8443/login
웹 UI는 기본적으로 자체 서명 인증서를 사용합니다. 로그인하면 MESHforensics 네트워크가 노드를 받아들일 준비가 됩니다. 노드 등록 및 포렌식 워크플로에 대해서는 문서를 참조하십시오.
[!IMPORTANT] 기본 ACL은 네트워크의 모든 노드가 서로 통신할 수 있도록 허용합니다. 프로덕션 배포에서는 ACL 탭을 통해 설정하는 제한적 정책을 사용해야 합니다.
MESHforensics는 Tailscale 인프라를 필요로 하지 않는 Tailscale의 대폭 수정된 포크입니다. 피어는 UDP 홀 펀칭을 사용하여 종단 간 암호화된 WireGuard를 통해 직접 연결됩니다. UDP가 차단되면 트래픽은 E2EE HTTPS DERP 릴레이로 페일오버되며, 이 릴레이는 패킷 내용을 볼 수 없이 전송합니다.
제어 평면은 피어 검색과 키 교환만 처리하며, 포렌식 트래픽은 가능할 때마다 엔드포인트 간에 직접 흐릅니다. 운영자는 자체 DERP 서버를 실행할 수 있으며(제어 평면에 구현이 내장되어 있음), 이를 통해 MESHforensics는 완전히 자체 호스팅이 가능합니다. 그렇지 않으면 연결성을 위해 Tailscale의 공용 DERP 서버로 폴백합니다.
MESHforensics는 WireGuard를 기반으로 구축되었지만, 일반 WireGuard VPN은 적대적 네트워크에 적합한 형태가 아닙니다. WireGuard는 UDP만 사용하며, UDP는 검열되고 제한적인 통신사 네트워크가 가장 먼저 저하시키거나 차단하는 대상입니다. 그런 상황이 발생하면 순수 WireGuard 터널은 단순히 실패하는데, 이는 분석가가 현장에서 기기에 접근해야 할 때 용납할 수 없는 일입니다.
MESHforensics는 빠르고 현대적이며 종단 간 암호화된 전송을 위해 WireGuard를 유지하면서, WireGuard 자체에는 없는 연결성을 추가합니다. 피어는 홀 펀칭을 통해 직접 UDP 연결을 시도하고, UDP가 차단되면 종단 간 암호화된 HTTPS DERP 릴레이로 페일오버합니다. HTTPS 릴레이는 핵심 요소입니다. 일반 웹 트래픽과 구별할 수 없으므로 기존 VPN을 고립시킬 DPI 및 UDP 검열을 견뎌내며, 릴레이는 여전히 패킷 내용을 볼 수 없이 전송합니다.
전통적인 VPN 및 허브 앤 스포크 설계는 지속적인 인프라 위험, 중앙 집중식 트래픽 분석 지점, 단일 장애점, 운영 노출을 추가합니다. MESHforensics는 조정과 전송을 분리합니다. 제어 평면은 포렌식 트래픽을 전달하지 않고, 피어 연결은 직접 이루어지며, 릴레이는 허브가 아닌 폴백이고, 메시는 일회용이며 작업 범위로 한정됩니다. 영구적인 엔터프라이즈 네트워킹이 아닌 일시적이고 고위험 환경에 최적화되어 있습니다.
android-client: Android 엔드포인트 APKcontrol-plane: 조정 서버analyst: 분석가 CLI 클라이언트mesh-analyst-client에 미러링합니다.main이 아닌 명시적 버전 태그에 의존해야 합니다.
MESHforensics는 인권 옹호자를 대상으로 한 스파이웨어 및 감시에 대한 합의 기반 원격 포렌식을 지원하기 위해 Open Technology Fund의 지원을 받습니다.
MESHforensics는 GNU Affero General Public License v3.0 or later(AGPL-3.0-or-later)에 따라 라이선스가 부여됩니다. BARGHEST에 의한 모든 수정 및 추가 사항은 Copyright (c) BARGHEST입니다.
일부는 Tailscale(BSD 3-Clause)의 2차적 저작물입니다. AmneziaWG/WireGuard 코드는 MIT 라이선스입니다. 원본 저작권 및 라이선스는 .licenses/에 보존되어 있습니다. WireGuard는 Jason A. Donenfeld의 등록 상표입니다.