Créé par Driss0007.
NetControl dispose de deux modes : démo (par défaut) et LAN local. Le mode LAN découvre, sur demande explicite, les appareils IPv4 du sous-réseau de l’ordinateur et peut bloquer/rétablir l’accès d’un appareil depuis ce PC, sans API de routeur.
Le pilote Npcap est requis pour envoyer les trames. Scapy documente cette dépendance Windows ; Npcap expose la capture et l’envoi de paquets via son API. Installation Scapy · Guide Npcap
- Installe Npcap depuis son site officiel, si nécessaire.
- Ouvre PowerShell en tant qu’administrateur dans le dossier NetControl.
- Active l’environnement local et démarre le backend en mode LAN :
.\.venv-local\Scripts\Activate.ps1
python -m pip install -r backend\requirements.txt
$env:NETCONTROL_MODE = "lan"
python -m uvicorn app.main:app --app-dir backend --host 127.0.0.1 --port 8000- Va sur http://127.0.0.1:8000, connecte-toi, ouvre Appareils, puis clique Découvrir le LAN.
Le mode LAN utilise une base distincte, data/netcontrol-lan.db. Le mode démo reste disponible en démarrant le serveur dans une nouvelle fenêtre sans NETCONTROL_MODE=lan.
Au premier démarrage LAN, crée un compte administrateur dans cette base séparée.
Sans NETCONTROL_SECRET_KEY, NetControl conserve automatiquement la clé des sessions dans un fichier .secret adjacent à la base locale afin que les connexions restent valides après un redémarrage. Garde ce fichier privé avec la base ; tu peux fournir une clé persistante via la variable NETCONTROL_SECRET_KEY ou choisir son emplacement avec NETCONTROL_SECRET_FILE.
- Le blocage utilise des réponses ARP sur le sous-réseau local et réaffirme la règle toutes les 1,5 secondes. Au rétablissement ou à l’arrêt normal du serveur, NetControl renvoie l’adresse MAC réelle de la passerelle. Si le processus ou le PC s’arrête brutalement, l’entrée ARP falsifiée expire et l’appareil récupère l’accès ; le tableau de bord ne peut pas restaurer une entrée à distance dans ce cas.
- Utilise cette fonction uniquement sur un réseau que tu administres. Ne cible ni la passerelle ni le PC qui exécute NetControl. La découverte est limitée à 1 024 adresses IPv4 et n’est jamais lancée automatiquement.
- L’isolation Wi-Fi des clients, un VLAN différent, des protections anti-usurpation ARP ou des points d’accès gérés peuvent empêcher la découverte ou le blocage.
- Pour mesurer ou limiter un appareil, utilise l’action de mesure ou de limite dans Appareils. Son trafic IPv4 est alors relayé temporairement par le PC NetControl ; les débits indiqués sont ceux des appareils explicitement surveillés. La limite configurée est agrégée entre envoi et téléchargement. La mesure seule n’applique pas de plafond.
- Le relais peut être bloqué par l’isolation des clients Wi-Fi, un VLAN différent, une protection ARP ou certains pilotes et points d’accès. Aucun logiciel exécuté sur le PC ne peut garantir la compatibilité avec tous les routeurs/Wi-Fi. La sélection automatique de l’interface suit la route IPv4 active ; seuls les appareils IPv4 du même sous-réseau sont pris en charge, pas les réseaux isolés ou IPv6.
- Arrête la mesure avec le bouton de radar avant de fermer NetControl ; un arrêt brutal peut laisser temporairement des caches ARP incorrects. Les domaines DNS ne sont pas fournis en mode LAN.
- Le contrôle est vérifié par tests sans émission de paquets. Aucun appareil de ton réseau n’a été découvert ou bloqué pendant le développement ; il faut valider sur ton LAN.
python -m pytest backend\tests -q
cd frontend
npm run buildnpm run build génère l’interface statique dans backend/app/static, servie par FastAPI. Le backend seul s’exécute dans un processus.