VIGIL MESH

Documentation

Héberger une vigie privée sur une Freebox ou une box Internet

Une box Internet reste allumée, se trouve au bord du réseau domestique et dispose d’une connexion fixe : sur le papier, c’est un excellent endroit pour héberger une vigie privée. En pratique, très peu de box opérateur savent exécuter une machine virtuelle. La Freebox Ultra et les Freebox Delta/Delta S font figure d’exception en France. Voici ce que cela apporte, les prérequis réels et la solution à retenir dans les autres pays.

Pourquoi placer une vigie chez soi ?

Un relais souverain

Quand deux nœuds ne peuvent pas établir un chemin direct, leurs paquets chiffrés passent par une machine que vous contrôlez, à votre domicile.

Une machine déjà allumée

La box fonctionne 24 h/24 : une VM évite d’ajouter un ordinateur uniquement pour un petit service réseau permanent.

Un chemin proche

Pour la maison connectée, le homelab et les appareils mobiles de la famille, un relais situé sur la connexion domestique peut raccourcir le chemin relayé.

Un point d’ancrage local

La même VM peut aussi porter un nœud passerelle du LAN pour joindre Home Assistant, Jeedom, un NAS ou des caméras sans les publier sur Internet.

Box compatibles, classées par pays de souscription

Ce tableau porte uniquement sur l’exécution d’une VM ou d’un conteneur utilisateur dans la box elle-même. « Non documenté » ne signifie pas que la connexion est incompatible : on place simplement la vigie sur une petite machine derrière la box. État de la documentation publique consultée en juillet 2026.

PaysBox opérateurVM dans la boxSolution recommandée
Allemagne / AutricheSpeedport, FRITZ!Box fournies par les FAINon documentéMini-PC, NAS ou Raspberry Pi derrière la box
BelgiqueProximus Internet Box / Internet Box+Non documentéHôte Linux externe
CanadaBell Giga Hub, Rogers Ignite GatewayNon documentéHôte Linux externe
EspagneMovistar Smart WiFi 6 / 6 GoNon documentéHôte Linux externe
États-UnisXfinity xFi Gateway, AT&T Wi-Fi GatewayNon documentéHôte Linux externe
FranceFreebox Ultra, Delta et Delta SOui, Linux ARM64VM Freebox OS ; sinon mini-PC/NAS
Italieiliadbox Wi-Fi 5/6/7Non documentéMini-PC, NAS ou Raspberry Pi
Pays-BasKPN Box 12/14Non documentéHôte Linux externe
Royaume-UniBT Smart Hub 2, EE Smart Hub PlusNon documentéHôte Linux externe
SuisseSwisscom Internet-Box, Sunrise Internet BoxNon documentéHôte Linux externe

Installer la vigie dans une VM Freebox Ultra ou Delta

Free a officiellement introduit les VM sur Delta et Delta S avec Freebox OS 4.1.0. Elles exécutent un Linux ARM64 avec des périphériques VirtIO. La Freebox Ultra reprend la fonction et possède un emplacement NVMe : installez un SSD adapté avant de créer une VM destinée à rester active.

  1. 1
    Vérifier le modèle et le stockageDans Freebox OS, confirmez la présence de l’application Machines virtuelles. Utilisez un stockage interne fiable ; sur Ultra, installez un NVMe 2280 compatible.
  2. 2
    Demander une IPv4 full-stackDans l’Espace Abonné Free, demandez l’IPv4 fixe full-stack. Une vigie doit recevoir udp/443, udp/4433 et tcp/443 ; une IPv4 partagée peut ne pas vous attribuer ces ports.
  3. 3
    Créer une VM Linux ARM64Créez une Debian ou Ubuntu ARM64 minimale, sans bureau graphique. Allouez les ressources disponibles, un disque persistant et une adresse DHCP fixe sur le LAN.
  4. 4
    Installer le paquet adaptéInstallez la version ARM64 de la vigie lorsqu’elle est disponible pour votre version VIGIL-MESH. Ne tentez pas d’installer un paquet amd64 dans la VM ARM64.
  5. 5
    Ouvrir uniquement les trois listenersRedirigez udp/443, udp/4433 et tcp/443 de la Freebox vers l’adresse LAN fixe de la VM. N’utilisez pas une DMZ générale.
  6. 6
    Enregistrer et qualifierGénérez un jeton de flotte à usage unique dans la console, enregistrez la vigie, puis attendez que le contrôleur vérifie les trois listeners depuis l’extérieur.
  7. 7
    Tester le redémarrageRedémarrez la VM puis la Freebox et vérifiez le démarrage automatique, l’état /healthz et le retour de la vigie dans la console.

Si votre box ne lance pas de VM : la meilleure architecture

Dans presque tous les pays, la bonne architecture consiste à laisser la box faire son métier de routeur et à brancher un hôte Linux basse consommation en Ethernet. Le résultat réseau est identique : la vigie reçoit les trois redirections publiques, tandis que le nœud passerelle du site accède uniquement aux appareils LAN explicitement autorisés.

HôtePourquoi le choisirPoint de vigilance
Mini-PC x86-64Bon rapport performance/prix, SSD, virtualisation Proxmox/KVMConsommation et mises à jour de l’hyperviseur
NAS Synology/QNAP/TrueNASDéjà allumé, conteneurs ou VM selon le modèleNe pas exposer l’administration du NAS
Raspberry Pi / SBC ARM64Compact et sobre pour un petit réseauSSD recommandé plutôt qu’une microSD
Serveur Proxmox/ESXiIsolation, snapshots, supervisionSurdimensionné pour un seul service domestique
VPS publicIP publique et disponibilité simplesLe chemin relayé n’est plus physiquement chez vous

Le duo utile pour la domotique : vigie privée + passerelle LAN

La vigie apporte un rendez-vous maîtrisé ; la passerelle LAN rend accessibles uniquement les hôtes cochés dans la console. Depuis un téléphone ou un ordinateur enrôlé, vous pouvez alors joindre Home Assistant, Jeedom, un NAS ou une caméra comme à la maison, sans publier leurs interfaces sur le Web. Les ACL séparent administration, habitants, invités et prestataires.

Sources et vérifications

Questions fréquentes

Quelles Freebox peuvent héberger une machine virtuelle ?
La fonction VM est documentée pour les Freebox Delta et Delta S et existe dans Freebox OS sur Freebox Ultra. Les images invitées doivent être ARM64. Vérifiez toujours l’application Machines virtuelles sur votre Server et son firmware avant de préparer le déploiement.
La Freebox Pop peut-elle héberger directement la vigie ?
Aucune fonction de VM utilisateur n’est documentée pour la Freebox Pop. Branchez un mini-PC, un NAS ou un Raspberry Pi derrière la Pop : la vigie fonctionnera de la même façon après redirection des trois ports requis.
Faut-il une IPv4 full-stack chez Free ?
Oui si votre IPv4 est partagée et que les ports 443 ou 4433 ne figurent pas dans la plage qui vous est attribuée. L’option full-stack donne accès à l’ensemble des ports ; vérifiez ensuite les redirections depuis un réseau extérieur.
Une vigie privée permet-elle de naviguer sur Internet avec l’adresse IP de la maison ?
Non, pas à elle seule. Une vigie relaie le trafic du mesh et une passerelle LAN donne accès à des hôtes locaux. La documentation VIGIL-MESH ne présente pas encore de fonction exit node pour router toute la navigation Internet par le domicile.
Puis-je héberger Home Assistant et la vigie dans la même VM ?
C’est techniquement possible avec des services isolés, mais séparer les rôles facilite les mises à jour et limite l’impact d’une panne. Sur une box aux ressources contraintes, mesurez surtout la mémoire, le débit relayé et les redémarrages.
Lire ensuiteDomotique et maison connectée avec un VPN privé