Skip to content

About

NetControl est un logiciel de supervision du réseau local avec mode démo, découverte des appareils IPv4, contrôle d’accès et mesure de débit par appareil

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

NetControl

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.

Activer le contrôle LAN sous Windows

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

  1. Installe Npcap depuis son site officiel, si nécessaire.
  2. Ouvre PowerShell en tant qu’administrateur dans le dossier NetControl.
  3. 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
  1. 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.

Limites du mode LAN

  • 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.

Tests et interface

python -m pytest backend\tests -q
cd frontend
npm run build

npm run build génère l’interface statique dans backend/app/static, servie par FastAPI. Le backend seul s’exécute dans un processus.

About

NetControl est un logiciel de supervision du réseau local avec mode démo, découverte des appareils IPv4, contrôle d’accès et mesure de débit par appareil

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages