VPN maillé pair-à-pair chiffré pour la forensique mobile à distance, permettant l'acquisition sans fil via ADB et libimobiledevice, la surveillance réseau et la détection d'intrusion à travers NAT et pare-feu.
MESHforensics permet le débogage sans fil d'appareils mobiles, routable sur Internet, via un réseau maillé pair-à-pair chiffré et résistant à la censure.
Les appareils mobiles sont souvent bloqués derrière un NAT, des pare-feu ou des réseaux d'opérateurs restrictifs qui empêchent tout accès entrant direct. MESHforensics crée une superposition pair-à-pair chiffrée et attribue à chaque nœud une adresse de la plage CGNAT via une interface TUN virtuelle, de sorte que les appareils se comportent comme s'ils partageaient un sous-réseau privé, sans VPN central, redirection de ports ni infrastructure permanente.
Cela permet aux analystes d'effectuer de la forensique mobile à distance via ADB Wireless Debugging et libimobiledevice, en utilisant des outils comme WARD, MVT et AndroidQF comme si l'appareil était local. MESHforensics prend également en charge la surveillance réseau à distance, notamment la capture PCAP et la détection d'intrusion Suricata sur le même maillage.
Les maillages sont éphémères et contrôlés par l'analyste : mettez les appareils en ligne, collectez, puis démontez le réseau, afin que rien ne reste en fonctionnement pour être identifié.
[!IMPORTANT] Bêta publique : en développement actif. Un test d'intrusion complet a été réalisé et les principales vulnérabilités ont été corrigées. Des changements incompatibles sont à prévoir, et une certaine expertise technique est requise. Signalez les bogues ou les problèmes de sécurité via les GitHub Issues.
Documentation complète : https://docs.meshforensics.org/
Clonez d'abord le dépôt :
git clone https://github.com/BARGHEST-ngo/mesh.git
cd MESH
Choisissez ensuite comment votre plan de contrôle est accessible depuis Internet.
Exécutez le plan de contrôle sur votre poste de travail et exposez-le via le provisionneur MESHforensics, un tunnel de proxy inverse hébergé. Demandez une clé d'API de provisionnement auprès de BARGHEST (voir https://docs.meshforensics.org/). Le provisionneur attribue automatiquement un sous-domaine éphémère *.tunnels.meshforensics.app et émet vos identifiants d'API, donc task apikey n'est pas nécessaire sur ce chemin.
# Choose the "Ephemeral" control plane when prompted
task build
task controlPlane
# Open the web UI at the provisioner-assigned URL and log in
Utilisez votre propre ingress (un reverse proxy sur un serveur exposé à Internet, ou un service de tunneling tel que Cloudflare Tunnel ou ngrok), puis générez une clé API localement.
# 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
L'interface web utilise un certificat auto-signé par défaut. Une fois connecté, votre réseau MESHforensics est prêt à accepter des nœuds. Consultez la documentation pour l'enrôlement des nœuds et les workflows forensiques.
[!IMPORTANT] L'ACL par défaut permet à tous les nœuds d'un réseau de communiquer entre eux. Les déploiements en production doivent utiliser des politiques restrictives, définies via l'onglet ACL.
MESHforensics est un fork fortement modifié de Tailscale qui ne nécessite pas l'infrastructure Tailscale. Les pairs se connectent directement via WireGuard chiffré de bout en bout en utilisant le hole punching UDP. Lorsque l'UDP est bloqué, le trafic bascule vers des relais DERP HTTPS E2EE, qui transportent les paquets sans visibilité sur leur contenu.
Le plan de contrôle ne gère que la découverte des pairs et l'échange de clés, et le trafic forensique circule directement entre les points de terminaison lorsque cela est possible. Les opérateurs peuvent exécuter leurs propres serveurs DERP (le plan de contrôle intègre une implémentation), rendant MESHforensics entièrement auto-hébergeable. Sinon, il se rabat sur les serveurs DERP publics de Tailscale pour la connectivité.
MESHforensics est construit sur WireGuard, mais un simple VPN WireGuard n'est pas adapté aux réseaux hostiles. WireGuard ne parle qu'UDP, et l'UDP est exactement ce que les réseaux censurés et restrictifs des opérateurs dégradent ou bloquent en premier. Lorsque cela se produit, un tunnel WireGuard brut échoue simplement, ce qui est inacceptable lorsqu'un analyste doit atteindre un appareil sur le terrain.
MESHforensics conserve WireGuard pour son transport chiffré de bout en bout rapide et moderne, puis ajoute la connectivité que WireGuard ne possède pas seul. Les pairs tentent une connexion UDP directe via hole punching, et lorsque l'UDP est bloqué, ils basculent vers des relais DERP HTTPS chiffrés de bout en bout. La retransmission HTTPS est l'élément critique : elle est indiscernable du trafic web ordinaire, elle survit donc au DPI et à la censure UDP qui bloqueraient un VPN conventionnel, tandis que le relais transporte toujours les paquets sans visibilité sur leur contenu.
Les conceptions VPN traditionnelles et hub-and-spoke ajoutent également un risque d'infrastructure persistante, des points centralisés d'analyse du trafic, des points de défaillance uniques et une exposition opérationnelle. MESHforensics sépare la coordination du transport. Le plan de contrôle ne transporte aucun trafic forensique, les connexions entre pairs sont directes, les relais sont des solutions de repli plutôt que des hubs, et les maillages sont jetables et limités à une tâche. Il est optimisé pour des environnements transitoires à haut risque plutôt que pour la mise en réseau d'entreprise permanente.
android-client : APK du point de terminaison Androidcontrol-plane : Serveur de coordinationanalyst : Client CLI analyste