docs: review networking documentation in all seven translations

web/messages/fr/docs/network/backup-restore.json

@@ -0,0 +1,110 @@
+{
+  "meta": {
+    "title": "Sauvegarde et redémarrage des interfaces | Documentation ProxMenux",
+    "description": "Capture manuelle, navigation et restauration des sauvegardes /etc/network/interfaces stockées sous /var/backups/proxmenux/. Comprend un redémarrage du service réseau avec confirmation et une vue rapide de la configuration en direct.",
+    "ogTitle": "Sauvegarde et redémarrage des interfaces | Documentation ProxMenux",
+    "ogDescription": "Créez un instantané de la configuration réseau Proxmox et restaurez-la ; redémarrez le service réseau avec confirmation."
+  },
+  "header": {
+    "title": "Sauvegarde et redémarrage des interfaces",
+    "description": "Quatre utilitaires qui tournent autour de /etc/network/interfaces: prennent un instantané manuel, visualisent la configuration en direct, restaurent une sauvegarde précédente avec prévisualisation optionnelle et redémarrent le service de réseautage avec un consentement explicite. Même répertoire de sauvegarde utilisé par les flux de réparation guidés.",
+    "section": "Réseau"
+  },
+  "intro": {
+    "title": "Ce que ça fait",
+    "body": "Gère le même répertoire de sauvegarde utilisé par les flux de réparation guidés (<code>/var/backups/proxmenux/</code>). Permet de prendre un instantané supplémentaire avant tout changement manuel, de parcourir toutes les sauvegardes existantes, et de revenir à l'une d'entre elles — toujours avec une nouvelle sauvegarde pré-restauration prise automatiquement comme deuxième filet de sécurité."
+  },
+  "shared": {
+    "heading": "Le répertoire de sauvegarde partagé",
+    "intro": "Chaque sauvegarde prise n'importe où dans le menu Réseau atterrit au même endroit :",
+    "outro": "Les noms de fichiers sont horodatés, triés par date et jamais écrasés. Le répertoire est créé lors de la première utilisation."
+  },
+  "show": {
+    "heading": "Afficher le fichier de configuration réseau",
+    "body": "Affiche le contenu exact de <code>/etc/network/interfaces</code> dans le terminal. En lecture seule. Utile pour vérifier la configuration avant une sauvegarde ou après une restauration. Il n’existe pas d’outil distinct pour comparer avec la sauvegarde précédente ; examiner le fichier actuel est donc le moyen le plus simple de confirmer son contenu."
+  },
+  "create": {
+    "heading": "Créer une sauvegarde réseau",
+    "body": "Copie le <code>/etc/network/interfaces</code> actuel dans le répertoire de sauvegarde avec un nouvel horodatage. C'est tout — pas d'analyse, pas d'invite, juste un instantané.",
+    "whenTitle": "Quand prendre une sauvegarde manuelle",
+    "whenBody": "Avant de modifier <code>/etc/network/interfaces</code> à la main, d’installer un paquet pouvant toucher la pile réseau (par exemple NetworkManager ou Open vSwitch), ou de changer le matériel. Les réparations guidées créent déjà automatiquement un instantané — cette option sert aux opérations <em>manuelles</em>."
+  },
+  "restore": {
+    "heading": "Restaurer la sauvegarde réseau",
+    "intro": "Liste les sauvegardes de <code>/var/backups/proxmenux/</code>, de la plus récente à la plus ancienne, et guide une restauration avec des garde-fous :",
+    "steps": [
+      {
+        "title": "1. Choisir une sauvegarde",
+        "body": "Un menu liste chaque sauvegarde par son horodatage. S'il n'y a pas de sauvegardes, le flux sort avec un message clair.",
+        "tone": "blue"
+      },
+      {
+        "title": "2. Aperçu facultatif",
+        "body": "Offre d'ouvrir la sauvegarde sélectionnée dans une vue défilante avant de s'engager. Oui par défaut — ne le sautez pas sur un hôte distant.",
+        "tone": "blue"
+      },
+      {
+        "title": "3. Sauvegarde avant restauration",
+        "body": "Avant d'écraser <code>/etc/network/interfaces</code>, prend <strong> une autre sauvegarde </strong> de l'état actuel. La restauration d'une sauvegarde est elle-même une action destructrice, de sorte que le nouvel instantané pré-restauration vous permet de revenir si la sauvegarde choisie s'avère être la mauvaise.",
+        "tone": "amber"
+      },
+      {
+        "title": "4. Appliquer la restauration",
+        "body": "Copie la sauvegarde choisie sur <code>/etc/network/interfaces</code>. Le changement de fichier est sur disque; l'état du noyau en direct reflète toujours la configuration précédente.",
+        "tone": "amber"
+      },
+      {
+        "title": "5. Redémarrage facultatif",
+        "body": "Demande s’il faut exécuter <code>systemctl restart networking</code> maintenant. Refusez pour reporter l’application au prochain redémarrage.",
+        "tone": "emerald"
+      }
+    ],
+    "autoBackupTitle": "Une restauration prend sa propre sauvegarde automatiquement",
+    "autoBackupBody": "Sélectionner <em>Restaurer la sauvegarde réseau</em> crée toujours un nouvel instantané de la configuration <em>actuelle</em> avant de l’écraser. Si vous restaurez la mauvaise sauvegarde, le fichier le plus récent dans <code>/var/backups/proxmenux/</code> contient l’état précédent."
+  },
+  "restart": {
+    "heading": "Redémarrer le service réseau",
+    "body": "Exécute <code>systemctl restart networking</code> après confirmation oui/non. Affiche le résultat avec <code>msg_ok</code> / <code>msg_error</code>. La plupart des procédures de ce menu proposent déjà un redémarrage à la fin ; cette option sert après une modification manuelle ou si vous avez refusé le redémarrage proposé auparavant.",
+    "warnTitle": "Brève déconnexion garantie; possibilité de déconnexion permanente",
+    "warnBody": "Redémarrer <code>networking</code> désactive puis reconfigure chaque interface déclarée dans <code>/etc/network/interfaces</code>. Les sessions SSH passant par ces interfaces sont interrompues. Si la nouvelle configuration est invalide, le réseau ne revient pas. N’exécutez cette opération que si :",
+    "warnItems": [
+      "Vous avez la console / IPMI / accès iKVM prêt, <em>ou</em>",
+      "Vous êtes physiquement à côté de la machine, <em> ou</em>",
+      "Vous venez de restaurer avec succès une configuration dont le bon fonctionnement est connu et souhaitez l’appliquer."
+    ]
+  },
+  "manualRollback": {
+    "heading": "Retour manuel depuis une console",
+    "intro": "Si vous ne pouvez pas accéder au menu (pas de SSH, plantage de dialog, …) mais disposez d’une console, deux commandes suffisent pour revenir en arrière :",
+    "outro": "C’est la <em>même</em> opération que celle du menu, simplement saisie à la main. Si <code>networking</code> ne démarre toujours pas, consultez <code>journalctl -u networking -b</code> pour identifier l’erreur de syntaxe ou de pilote."
+  },
+  "troubleshoot": {
+    "heading": "Dépannage",
+    "noneTitle": "« Aucune sauvegarde trouvée » lors de la restauration",
+    "noneBody": "Le répertoire <code>/var/backups/proxmenux/</code> n’existe pas ou ne contient aucun fichier <code>interfaces_backup_*</code>. Exécutez <em>Créer une sauvegarde réseau</em> au moins une fois ou lancez une réparation guidée, qui crée automatiquement une sauvegarde. Vérifiez avec <code>ls /var/backups/proxmenux/</code>.",
+    "unreachTitle": "Le redémarrage du réseau réussit, mais l’hôte reste inaccessible",
+    "unreachBody": "La nouvelle configuration est incorrecte ou n’attribue pas votre adresse IP de gestion. Revenez en arrière depuis la console (voir ci-dessus). Utilisez ensuite <bridgeLink>l’analyse des ponts</bridgeLink> et <configLink>l’analyse de configuration</configLink> pour comprendre le problème avant de réappliquer la configuration.",
+    "emptyTitle": "L’aperçu de restauration affiche un fichier vide",
+    "emptyBody": "Le fichier de sauvegarde est vide (0 octet). Cela arrive si une copie a échoué silencieusement lors d’une exécution précédente. Choisissez une sauvegarde plus ancienne ou relancez <em>Créer une sauvegarde réseau</em> maintenant si la configuration actuelle fonctionne."
+  },
+  "related": {
+    "heading": "Voir aussi",
+    "items": [
+      {
+        "label": "Analyse des ponts et réparation guidée",
+        "href": "/docs/network/bridge-analysis",
+        "tail": "— la raison la plus courante pour laquelle une sauvegarde se termine ici."
+      },
+      {
+        "label": "Analyse de configuration et nettoyage guidé",
+        "href": "/docs/network/config-analysis",
+        "tailRich": "— écrit également à <code>/var/backups/proxmenux/</code> automatiquement."
+      },
+      {
+        "label": "Diagnostic",
+        "href": "/docs/network/diagnostics",
+        "tail": " — pour vérifier l’état actuel après une restauration."
+      }
+    ]
+  }
+}

web/messages/fr/docs/network/bridge-analysis.json

@@ -0,0 +1,132 @@
+{
+  "meta": {
+    "title": "Analyse des ponts et réparation guidée | Documentation ProxMenux",
+    "description": "Détecte les ponts vmbrX dont les ports physiques sont absents ou invalides, généralement après une réénumération PCI. Les signale avec des commandes shell proposées et offre une réparation guidée en 5 étapes avec sauvegarde obligatoire.",
+    "ogTitle": "Analyse des ponts et réparation guidée | Documentation ProxMenux",
+    "ogDescription": "Vérifiez et réparez les ports des ponts Proxmox après des changements matériels, avec une procédure guidée permettant un retour en arrière sûr."
+  },
+  "header": {
+    "title": "Analyse des ponts et réparation guidée",
+    "description": "Examine chaque pont vmbrX déclaré dans /etc/network/interfaces, vérifie l’existence de ses ports physiques et propose une réparation étape par étape s’ils sont absents. L’analyse est en lecture seule ; la réparation nécessite un accord, présente un aperçu et crée une sauvegarde.",
+    "section": "Réseau"
+  },
+  "intro": {
+    "title": "Ce que ça fait",
+    "body": "Lit chaque pont dans <code>/etc/network/interfaces</code>, examine sa ligne <code>bridge-ports</code> et vérifie l’existence de chaque port déclaré, par exemple <code>enp3s0</code>, sur l’hôte. Si un port manque, propose un remplacement et applique la modification avec un consentement explicite selon la procédure <strong>sauvegarder, prévisualiser, appliquer, vérifier</strong>."
+  },
+  "when": {
+    "heading": "Quand vous en avez besoin",
+    "intro": "Linux attribue des noms d'interface prévisibles à partir de la topologie PCI et de l'ordre des fentes. Plusieurs événements les mélangent et laissent <code>/etc/network/interfaces</code> se référant à des noms qui n'existent plus :",
+    "items": [
+      "Ajouter ou retirer une carte PCIe (une carte NIC, un GPU, un HBA, un support NVMe).",
+      "Déplacement d'une carte existante vers une autre fente PCIe.",
+      "Mises à jour du BIOS / UEFI qui réénumèrent les périphériques PCI.",
+      "Migrer le disque de démarrage vers différents matériels."
+    ],
+    "outro": "Après le prochain démarrage, le pont tente de se fixer à un port qui n'existe plus, ne parvient pas à monter, et l'hôte perd son réseau. <link>Les noms d'interface persistants</link> empêchent cela de se reproduire — mais si vous êtes déjà verrouillé, cette page est le chemin de récupération."
+  },
+  "bigPicture": {
+    "heading": "La situation générale",
+    "diagram1": {
+      "arrowLabel": "étape 1",
+      "nodes": {
+        "sourceLabel": "/etc/network/interfaces",
+        "sourceDetail": "auto vmbr0\niface vmbr0 inet static\n  bridge-ports enp3s0",
+        "bridgeLabel": "Analyser (lecture seule)",
+        "bridgeDetail": "ip link show enp3s0\n→ n’existe pas",
+        "targetLabel": "Rapport + suggestion",
+        "targetDetail": "❌ enp3s0 : INTROUVABLE\nRemplacer par : eno1\n(pas encore de modification)"
+      }
+    },
+    "diagram2": {
+      "arrowLabel": "appliquer avec sauvegarde",
+      "nodes": {
+        "sourceLabel": "Réparation guidée",
+        "sourceDetail": "1. Sauvegarder\n2. Afficher l’état actuel\n3. Prévisualiser les modifications\n4. Appliquer\n5. Vérifier",
+        "targetLabel": "/etc/network/interfaces (nouveau)",
+        "targetDetail": "auto vmbr0\niface vmbr0 inet static\n  bridge-ports eno1"
+      }
+    }
+  },
+  "step1": {
+    "heading": "Étape 1: analyse (lecture seule)",
+    "intro": "Sélectionner <strong>Analyser la configuration des ponts</strong> arrête immédiatement l’outil si l’hôte n’utilise pas la pile classique Debian/Proxmox. Sinon, il examine chaque pont et indique :",
+    "items": [
+      "Nom du pont, état actuel (UP / DOWN), IP assigné.",
+      "Chaque port déclaré et s'il existe actuellement (<code>ip link show &lt;port&gt;</code>).",
+      "Pour chaque port invalide : un remplacement proposé (la première interface physique disponible) plus la commande exacte <code>sed</code> pour l'appliquer manuellement.",
+      "Ponts sans <code>bridge-ports</code> du tout et entrées orphelines <code>auto</code> (pas de bloc correspondant <code>iface</code>)."
+    ],
+    "readonlyTitle": "Garantie en lecture seule",
+    "readonlyBody": "Jusqu'à ce point, le script n'a pas exécuté une seule commande de modification. Vous pouvez laisser l'analyse ouverte, copier les commandes <code>sed</code> suggérées et les appliquer manuellement si vous préférez — ou accepter l'invite suivante pour entrer dans la réparation guidée."
+  },
+  "step2": {
+    "heading": "Étape 2 : réparation guidée (5 étapes)",
+    "intro": "Accessible uniquement si vous acceptez la proposition à la fin de l’analyse. Chaque étape présente l’action prévue et demande une confirmation avant de continuer.",
+    "steps": [
+      {
+        "title": "1. Sauvegarde de sécurité",
+        "body": "Copie <code>/etc/network/interfaces</code> vers <code>/var/backups/proxmenux/interfaces_backup_&lt;TIMESTAMP&gt;</code>. Le chemin exact de sauvegarde est affiché avant la copie et à nouveau après, avec la commande rollback.",
+        "tone": "blue"
+      },
+      {
+        "title": "2. Examiner la configuration actuelle",
+        "body": "Ouvre le fichier actuel <code>/etc/network/interfaces</code> dans une boîte de dialogue avec défilement pour voir exactement ce qui va être modifié.",
+        "tone": "blue"
+      },
+      {
+        "title": "3. Aperçu des modifications proposées",
+        "body": "Liste précisément les ponts concernés et les remplacements de ports prévus. Si aucune réparation n’est plus nécessaire parce que le port est réapparu entre les vérifications, la procédure se termine avec <em>« Aucune modification nécessaire. »</em>",
+        "tone": "blue"
+      },
+      {
+        "title": "4. Appliquer les modifications",
+        "body": "Pour chaque pont touché, exécute <code>sed -i \"/iface $bridge/,/bridge-ports/ s/bridge-ports.*/bridge-ports $new_ports/\"</code> contre <code>/etc/network/interfaces</code>. Si un pont n'avait pas de remplacement valide disponible, la substitution est ignorée et signalée à l'étape 5.",
+        "tone": "amber"
+      },
+      {
+        "title": "5. Vérification",
+        "body": "Relit le fichier et confirme l’existence du nouveau port de chaque pont. Affiche la commande de retour en arrière (<code>cp &lt;backup&gt; /etc/network/interfaces</code>). Propose enfin <strong>Redémarrer le réseau</strong> : n’acceptez que si vous disposez d’un accès de secours à la console.",
+        "tone": "emerald"
+      }
+    ],
+    "restartTitle": "Redémarrer le réseau ≠ annuler sans risque",
+    "restartBody": "La réparation est écrite sur le disque, même si vous ne redémarrez pas le service. <code>systemctl restart networking</code> applique la modification <em>maintenant</em>, ce qui peut interrompre votre session SSH si le nouveau port est incorrect. En cas de refus, la modification prendra quand même effet au prochain redémarrage : vérifiez d’abord la configuration ou revenez en arrière avec la commande affichée."
+  },
+  "edits": {
+    "heading": "Ce qui est édité (exactement)",
+    "body": "Uniquement la ligne <code>bridge-ports</code> de chaque pont concerné. Les autres directives (<code>address</code>, <code>netmask</code>, <code>gateway</code>, <code>bridge-stp</code>, …) restent intactes. Le script ne crée ni ne supprime de blocs <code>iface</code> dans cette procédure : c’est le rôle de <link>l’analyse de configuration &amp; du nettoyage</link>."
+  },
+  "troubleshoot": {
+    "heading": "Dépannage",
+    "unsupportedTitle": "L’analyse s’arrête avec « Pile réseau non prise en charge »",
+    "unsupportedBody": "L'hôte exécute netplan, systemd-networkd ou NetworkManager. L'outil ne prend en charge que <code>/etc/network/interfaces</code>. Passez d'abord l'hôte à la pile classique ou modifiez la configuration avec l'outil natif du gestionnaire (p. ex. <code>netplan apply</code>).",
+    "noSuggestTitle": "Aucune suggestion n'est imprimée pour un port invalide",
+    "noSuggestBody": "L'hôte a zéro interfaces physiques libres (tout est déjà dans un autre pont ou n'existe pas). L'analyse revient à suggérer <code>bridge-ports none</code> afin que le pont puisse au moins monter sans port. Ajouter un NIC ou migrer les ports entre les ponts manuellement avant de recommencer.",
+    "stillDownTitle": "La réparation s'achève mais le pont est toujours DOWN",
+    "stillDownBody": "<code>sed</code> a mis à jour le fichier, mais <code>systemctl restart networking</code> a été refusé. Exécutez-le manuellement une fois que la nouvelle configuration est vérifiée, ou redémarrez. Si le redémarrage a été accepté et que le pont est toujours DOWN, exécutez <code>ip link show</code> pour confirmer l'existence du nouveau port, puis vérifiez <code>journalctl -u networking</code> pour l'erreur réelle (câble débranché, lien non négocié, port déjà membre d'un autre pont).",
+    "lostSshTitle": "J'ai perdu l'accès SSH juste après le redémarrage du réseau",
+    "lostSshIntro": "Utilisez console / IPMI / iKVM pour atteindre l'hôte. Restaurer la sauvegarde :",
+    "lostSshOutro": "Relancez ensuite l’analyse depuis la console pour comprendre pourquoi la suggestion n’a pas fonctionné, généralement parce que le port de remplacement n’est pas branché."
+  },
+  "related": {
+    "heading": "Voir aussi",
+    "items": [
+      {
+        "label": "Noms d'interface persistants",
+        "href": "/docs/network/persistent-names",
+        "tail": "— épingler les noms aux adresses MAC afin que ce scénario cesse de se produire."
+      },
+      {
+        "label": "Analyse de configuration et nettoyage guidé",
+        "href": "/docs/network/config-analysis",
+        "tailRich": "— pour les blocs orphelins de <code>iface</code> (l'autre moitié du même problème)."
+      },
+      {
+        "label": "Sauvegarde et redémarrage des interfaces",
+        "href": "/docs/network/backup-restore",
+        "tail": "— les instantanés manuels et le navigateur de restauration."
+      }
+    ]
+  }
+}

web/messages/fr/docs/network/config-analysis.json

@@ -0,0 +1,122 @@
+{
+  "meta": {
+    "title": "Analyse de configuration et nettoyage guidé | Documentation ProxMenux",
+    "description": "Détecte les blocs iface de /etc/network/interfaces qui font référence à des cartes réseau physiques absentes de l’hôte. Les signale et propose une suppression guidée en 5 étapes avec sauvegarde obligatoire et aperçu de chaque bloc.",
+    "ogTitle": "Analyse de configuration et nettoyage guidé | Documentation ProxMenux",
+    "ogDescription": "Trouver et supprimer les blocs d'interface orphelins laissés derrière par les changements matériels, avec prévisualisation complète et retour."
+  },
+  "header": {
+    "title": "Analyse de configuration et nettoyage guidé",
+    "description": "Examine chaque bloc iface de /etc/network/interfaces et vérifie que la carte réseau physique correspondante existe toujours. Signale les blocs orphelins laissés par des changements matériels et propose une suppression guidée avec sauvegarde, aperçu et confirmation de chaque bloc.",
+    "section": "Réseau"
+  },
+  "intro": {
+    "title": "Ce que ça fait",
+    "body": "Identifie les déclarations <code>iface</code> dont le support NIC n'est plus présent sur l'hôte (typique après le remplacement ou la suppression d'une carte réseau). Ensuite, offre un nettoyage guidé qui supprime <em>seulement</em> les blocs orphelins, avec une sauvegarde, un aperçu par section et une confirmation finale explicite."
+  },
+  "differs": {
+    "heading": "Comment il diffère de l'analyse de pont",
+    "headerAspect": "Aspect",
+    "headerBridge": "Analyse des ponts",
+    "headerConfig": "Analyse de la configuration",
+    "rows": [
+      {
+        "aspect": "Regarde",
+        "bridge": "Ponts (<code>vmbrX</code>) et leur ligne <code>bridge-ports</code>",
+        "config": "Chaque bloc <code>iface</code>, sauf loopback, ponts et agrégations"
+      },
+      {
+        "aspect": "Détecte",
+        "bridge": "Ponts faisant référence à un port inexistant",
+        "config": "Blocs d'interface autonomes pour les NIC qui n'existent pas"
+      },
+      {
+        "aspect": "Action de réparation",
+        "bridge": "Remplace le nom du port dans <code>bridge-ports</code>",
+        "config": "Supprime tout le bloc <code>iface</code>"
+      },
+      {
+        "aspect": "Non compris",
+        "bridge": "Rien — chaque pont est analysé",
+        "config": "Les ponts (<code>vmbrX</code>) et agrégations (<code>bondX</code>) sont toujours conservés : ils sont virtuels et leur absence peut être normale au démarrage"
+      }
+    ],
+    "outro": "En pratique, on utilise souvent les deux dans cet ordre : <strong>analyse de configuration</strong> pour supprimer les blocs orphelins, puis <link>analyse des ponts</link> pour réaffecter tout pont qui dépendait de l’interface supprimée."
+  },
+  "step1": {
+    "heading": "Étape 1: analyse (lecture seule)",
+    "intro": "Avorte immédiatement si l'hôte n'est pas sur la pile classique. Sinon, liste toutes les interfaces non loopback configurées et indique son état :",
+    "virtTitle": "Les interfaces virtuelles sont protégées",
+    "virtBody": "Les ponts (<code>vmbrX</code>) et agrégations (<code>bondX</code>) sont virtuels. Leur absence peut être normale au moment de l’inspection, par exemple pour un pont sans port. L’analyse ne propose donc jamais de les supprimer, seulement les cartes réseau physiques."
+  },
+  "step2": {
+    "heading": "Étape 2 : nettoyage guidé (5 étapes)",
+    "intro": "Accessible uniquement si vous acceptez la proposition à la fin de l’analyse. Chaque étape exige une confirmation ; annuler à tout moment quitte sans écrire.",
+    "steps": [
+      {
+        "title": "1. Sauvegarde de sécurité",
+        "body": "Copie <code>/etc/network/interfaces</code> vers <code>/var/backups/proxmenux/interfaces_backup_&lt;TIMESTAMP&gt;</code>. Chemin montré avant et après.",
+        "tone": "blue"
+      },
+      {
+        "title": "2. Confirmer la liste de suppression",
+        "body": "Liste précisément les blocs d’interface physique à supprimer. Si les cartes réseau réapparaissent entre l’analyse et le nettoyage, par exemple après avoir réinséré une carte, la procédure se termine avec <em>« Aucun nettoyage nécessaire. »</em>",
+        "tone": "blue"
+      },
+      {
+        "title": "3. Aperçu du ou des blocs exacts",
+        "body": "Ouvre une vue défilante de chaque bloc <code>iface</code> qui serait supprimé, mot à mot du fichier. C'est le moment de repérer par exemple un crochet <code>up</code> intéressant que vous voulez préserver.",
+        "tone": "blue"
+      },
+      {
+        "title": "4. Appliquer la suppression",
+        "body": "Pour chaque interface orpheline, exécute <code>sed -i \"/^iface $iface/,/^$/d\" /etc/network/interfaces</code>. Cela supprime de la ligne correspondante <code>iface</code> jusqu'à la ligne blanche suivante.",
+        "tone": "amber"
+      },
+      {
+        "title": "5. Vérification",
+        "body": "Relit le fichier, répertorie ce qui a été supprimé et revérifie les interfaces restantes. Imprime la commande de restauration. <strong>ne redémarre pas</strong> automatiquement le réseau : la suppression d'un bloc inutilisé peut être appliquée en toute sécurité au prochain redémarrage et évite de toucher à l'état actif.",
+        "tone": "emerald"
+      }
+    ],
+    "noRestartTitle": "Ne redémarre pas automatiquement le réseau",
+    "noRestartBody": "Contrairement à la réparation de pont, le flux de nettoyage n'offre pas de redémarrer le service. L'élimination d'un bloc d'interface inutilisé n'a aucun effet immédiat sur la configuration en cours d'exécution, de sorte qu'un redémarrage est inutile et serait un risque inutile de connectivité. Le changement prend effet sur le prochain manuel <code>systemctl restart networking</code> ou au prochain redémarrage."
+  },
+  "caveats": {
+    "heading": "Mises en garde importantes",
+    "boundaryTitle": "La limite du bloc est la première ligne vide",
+    "boundaryBody": "Le motif <code>sed</code> supprime de <code>iface &lt;name&gt;</code> jusqu’à la ligne vide suivante. Si <code>/etc/network/interfaces</code> ne contient pas de ligne vide entre les blocs, ce qui est rare mais possible après une modification manuelle, le bloc suivant peut aussi être supprimé. C’est pourquoi <strong>l’étape 3 est obligatoire</strong> : examinez l’aperçu avant de confirmer.",
+    "tandemTitle": "Un bloc iface orphelin utilisé par un pont est détecté ici, pas dans l’analyse des ponts",
+    "tandemBody": "Si <code>vmbr0</code> déclare <code>bridge-ports enp3s0</code> et qu’<code>enp3s0</code> a aussi son propre bloc <code>iface enp3s0 inet manual</code>, supprimer <code>enp3s0</code> ici laisse une référence invalide dans <code>vmbr0</code>. Après le nettoyage, lancez <link>l’analyse des ponts</link> pour réaffecter ou retirer le port du pont. Les deux procédures sont conçues pour être utilisées ensemble."
+  },
+  "troubleshoot": {
+    "heading": "Dépannage",
+    "notFoundTitle": "L’analyse indique « INTROUVABLE » pour ma nouvelle carte réseau",
+    "notFoundBody": "Le noyau voit le périphérique sous un autre nom que celui du fichier. Lancez <code>ip link show</code> pour connaître son nom réel. C’est précisément un cas où les <link>noms d’interface persistants</link> éviteraient le problème à l’avenir.",
+    "tooMuchTitle": "Le nettoyage a trop supprimé, dont un bloc que je voulais garder",
+    "tooMuchBody": "Restaurer à partir de la sauvegarde imprimée dans l'étape 5:",
+    "tooMuchOutro": "Modifier le fichier à la main pour ajouter une ligne blanche claire entre les blocs avant de ré-exécuter le nettoyage, ou supprimer le bloc problématique manuellement.",
+    "bridgeBreakTitle": "Un pont s'arrête après le nettoyage",
+    "bridgeBreakBody": "Le pont utilisait un port dont le bloc <code>iface</code> vient d’être supprimé. Lancez <link>l’analyse des ponts</link> ; la suggestion associera le pont à une interface physique existante."
+  },
+  "related": {
+    "heading": "Voir aussi",
+    "items": [
+      {
+        "label": "Analyse des ponts et réparation guidée",
+        "href": "/docs/network/bridge-analysis",
+        "tail": "— le suivi naturel après un nettoyage."
+      },
+      {
+        "label": "Noms d'interface persistants",
+        "href": "/docs/network/persistent-names",
+        "tail": "— empêche les blocs orphelins de s'accumuler après chaque changement matériel."
+      },
+      {
+        "label": "Sauvegarde et redémarrage des interfaces",
+        "href": "/docs/network/backup-restore",
+        "tail": "— les instantanés manuels et le navigateur de restauration."
+      }
+    ]
+  }
+}

web/messages/fr/docs/network/diagnostics.json

@@ -0,0 +1,94 @@
+{
+  "meta": {
+    "title": "Diagnostic | Documentation ProxMenux",
+    "description": "Trois diagnostics ponctuels en lecture seule : Afficher la table de routage, Tester la connectivité et Diagnostic avancé. Inspection uniquement — n’écrit jamais dans /etc/network/interfaces et n’exécute aucune commande de modification, à une exception explicite près : la purge de NetworkManager, s’il est détecté, nécessite votre accord.",
+    "ogTitle": "Diagnostic | Documentation ProxMenux",
+    "ogDescription": "Diagnostic réseau en lecture seule pour l'hôte Proxmox : routage, accessibilité, statistiques avancées."
+  },
+  "header": {
+    "title": "Diagnostic",
+    "description": "Trois contrôles ponctuels en lecture seule de l’état actuel du réseau : table de routage, test de connectivité et statistiques avancées. Aucun n’écrit dans /etc/network/interfaces — utilisables en toute sécurité à tout moment, y compris via SSH. Pour la surveillance interactive en direct, consultez Outils de surveillance en direct.",
+    "section": "Réseau"
+  },
+  "intro": {
+    "title": "Ce que ça fait",
+    "body": "Présente le routage, l’accessibilité et les statistiques agrégées <strong>sans rien modifier</strong>. Permet de vérifier le bon fonctionnement du réseau ou de repérer des adresses IP en double. Pour observer le trafic en continu, voir <monitoringLink>Outils de surveillance en direct</monitoringLink> ; pour consulter le fichier de configuration brut, voir <backupLink>Sauvegarde et redémarrage des interfaces</backupLink>."
+  },
+  "routing": {
+    "heading": "Afficher la table de routage",
+    "body": "Liste chaque route que le noyau utilise actuellement (<code>ip route show</code>) et souligne la passerelle par défaut. Utile pour confirmer que le trafic vers Internet passe par l'interface prévue et qu'aucune route restante n'a priorité."
+  },
+  "connectivity": {
+    "heading": "Tester la connectivité",
+    "intro": "Envoie deux sondes ICMP à trois cibles dans l'ordre et signale chacune. Ensuite, exécute un <code>nslookup google.com</code> pour vérifier la résolution DNS indépendamment de ICMP.",
+    "headerTest": "Essai",
+    "headerTarget": "Cible",
+    "headerConfirms": "Ce qu'il confirme",
+    "rows": [
+      {
+        "test": "Google DNS",
+        "target": "8.8.8.8",
+        "confirms": "Accessibilité externe via une adresse IP anycast connue"
+      },
+      {
+        "test": "Cloudflare DNS",
+        "target": "1.1.1.1",
+        "confirms": "Deuxième avis indépendant si Google bloque ICMP"
+      },
+      {
+        "test": "Passerelle",
+        "target": "(route par défaut)",
+        "confirms": "Connectivité L2 / L3 au routeur local"
+      },
+      {
+        "test": "Résolution DNS",
+        "target": "google.com",
+        "confirms": "Le serveur DNS est accessible et répond"
+      }
+    ],
+    "readingTitle": "Lecture du résultat",
+    "readingBody": "Si le test de la passerelle réussit mais que les cibles DNS publiques ne répondent pas, vous avez une connectivité locale mais pas d’accès Internet : vérifiez la connexion en amont de la passerelle. Si la résolution DNS échoue mais que les pings vers <code>8.8.8.8</code> réussissent, le problème vient du résolveur, pas du réseau : vérifiez <code>/etc/resolv.conf</code>."
+  },
+  "advanced": {
+    "heading": "Diagnostic avancé",
+    "intro": "Agrège les statistiques du réseau et effectue une série de vérifications des problèmes courants. Affiche le nombre de connexions actives, les ports en écoute et le nombre total d’interfaces, et signale explicitement deux configurations problématiques :",
+    "items": [
+      "<strong>NetworkManager fonctionne sur un hôte Proxmox.</strong> NetworkManager et <code>ifupdown</code> de Proxmox entrent en conflit : tous deux tentent de gérer les interfaces, ce qui rend les ponts instables ou les empêche de s’activer. Si NetworkManager est détecté, l’outil propose une confirmation interactive pour l’arrêter, le désactiver et le purger (c’est le <em>seul</em> diagnostic pouvant modifier le système, et uniquement après consentement explicite).",
+      "<strong>Adresses IP en double sur différentes interfaces.</strong> Deux interfaces utilisant la même adresse IPv4 provoquent des problèmes de connexion intermittents très difficiles à diagnostiquer depuis la VM. Détection via <code>ip -4 addr show | sort | uniq -d</code>."
+    ],
+    "nmTitle": "L'invite NetworkManager est la seule action de modification ici",
+    "nmBody": "Toutes les autres vérifications du diagnostic avancé sont en lecture seule. La suppression de NetworkManager nécessite une confirmation oui/non et exécute <code>systemctl stop / disable</code> + <code>apt-get purge -y network-manager</code>. Si vous refusez, rien ne change."
+  },
+  "troubleshoot": {
+    "heading": "Dépannage",
+    "gwTitle": "Tester la connectivité signale un échec de la passerelle, mais l’hôte a accès à Internet",
+    "gwBody": "Certains routeurs ne répondent pas aux requêtes ICMP sur leur interface interne même s’ils acheminent correctement le trafic. Testez avec <code>traceroute 8.8.8.8</code> depuis une console : si le deuxième saut correspond à votre FAI et que le test DNS public a réussi, la passerelle fonctionne malgré l’échec du ping.",
+    "dupTitle": "Le diagnostic avancé signale toujours des adresses IP en double après que j’en ai supprimé une",
+    "dupBody": "La vérification examine l'état du noyau en direct, et non le fichier de configuration. Exécutez <code>ip -4 addr show</code> pour confirmer ; si le duplicata est toujours présent, une interface le tient toujours. Utilisez <code>ip addr del &lt;IP&gt;/&lt;mask&gt; dev &lt;iface&gt;</code> pour le supprimer de l'état en direct, puis modifiez <code>/etc/network/interfaces</code> si elle est aussi persistante."
+  },
+  "related": {
+    "heading": "Voir aussi",
+    "items": [
+      {
+        "label": "Outils de surveillance en direct",
+        "href": "/docs/network/monitoring",
+        "tail": "— les lanceurs interactifs iftop / iptraf-ng / iperf3."
+      },
+      {
+        "label": "Analyse des ponts et réparation guidée",
+        "href": "/docs/network/bridge-analysis",
+        "tail": " — lorsqu’un vmbrX n’a plus de port physique."
+      },
+      {
+        "label": "Analyse de configuration et nettoyage guidé",
+        "href": "/docs/network/config-analysis",
+        "tail": " — lorsqu’une ancienne carte réseau est toujours déclarée mais n’est plus présente."
+      },
+      {
+        "label": "Sauvegarde et redémarrage des interfaces",
+        "href": "/docs/network/backup-restore",
+        "tail": " — pour créer un instantané de la configuration avant toute modification."
+      }
+    ]
+  }
+}

web/messages/fr/docs/network/index.json

@@ -0,0 +1,107 @@
+{
+  "meta": {
+    "title": "Gestion réseau Proxmox — Ponts, agrégations, diagnostic, réparation | ProxMenux",
+    "description": "Diagnostics en lecture seule, analyses suivies de suggestions et réparations guidées pour la pile réseau Debian / Proxmox (/etc/network/interfaces). Inspectez les ponts et les agrégations, lancez des outils de surveillance en direct, rendez les noms d’interface persistants, sauvegardez et redémarrez le réseau en toute sécurité — avec sauvegardes obligatoires et aperçus étape par étape.",
+    "ogTitle": "Gestion réseau Proxmox — Ponts, agrégations, diagnostic, réparation",
+    "ogDescription": "Diagnostics, analyses et réparations guidées pour la pile réseau Proxmox avec sauvegardes obligatoires et prévisualisations étape par étape.",
+    "twitterTitle": "Gestion réseau Proxmox | ProxMenux",
+    "twitterDescription": "Ponts, agrégations, diagnostics et réparations guidées pour la pile réseau Proxmox avec sauvegardes obligatoires."
+  },
+  "header": {
+    "title": "Gestion du réseau",
+    "description": "Diagnostics en lecture seule, rapports d’analyse suivis de suggestions et réparations guidées pour la pile réseau classique Debian/Proxmox. Toute opération destructive crée d’abord une sauvegarde et affiche les modifications exactes avant de les appliquer.",
+    "section": "Réseau"
+  },
+  "intro": {
+    "title": "À quoi sert ce menu",
+    "body": "Inspectez, diagnostiquez et, au besoin, réparez la configuration réseau de l’hôte Proxmox sans perdre l’accès à distance. Les outils suivent un principe : <strong>lire d’abord, proposer, puis appliquer uniquement avec un consentement explicite et une sauvegarde de sécurité</strong>. Il n’existe pas de bouton « Tout réparer automatiquement »."
+  },
+  "openingMenu": {
+    "heading": "Ouverture du menu",
+    "intro": "Dans le menu principal de ProxMenux, sélectionnez <strong>Réseau</strong>. Vous verrez ceci :",
+    "imageAlt": "Menu de gestion de réseau avec diagnostic, suivi, analyse, réparation, noms persistants et options de sauvegarde"
+  },
+  "safety": {
+    "heading": "Le modèle de sécurité",
+    "body": "Modifier la configuration réseau d’un hôte Proxmox distant est l’un des moyens les plus faciles de perdre son accès. ProxMenux en tient compte pour chaque action. Les outils se répartissent en trois niveaux de comportement : choisissez la carte correspondant à votre objectif :"
+  },
+  "tiers": {
+    "readOnly": {
+      "title": "Lecture seule",
+      "body": "Contrôle pur. Impossible de modifier le système en aucune circonstance.",
+      "items": [
+        "Tableau d'acheminement, tests de connectivité, statistiques avancées",
+        "Surveillance du trafic en temps réel (iftop, iptraf-ng)",
+        "Test de bande passante (iperf3)"
+      ]
+    },
+    "analyze": {
+      "title": "Analysez, puis suggérez",
+      "body": "Détecte les problèmes, affiche un rapport avec les commandes shell proposées, puis s’arrête. Vous décidez ensuite de lancer ou non la réparation guidée.",
+      "items": [
+        "Analyse de la configuration des ponts",
+        "Analyse de la configuration du réseau"
+      ]
+    },
+    "apply": {
+      "title": "Appliquer avec sauvegarde",
+      "body": "Modifie le système. Crée toujours d’abord une sauvegarde horodatée du fichier concerné et affiche un aperçu avant l’écriture.",
+      "items": [
+        "Noms d’interface persistants (fichiers .link)",
+        "Sauvegarde manuelle, restauration et redémarrage du service"
+      ]
+    }
+  },
+  "classicTitle": "Pile classique seulement",
+  "classicBody": "Chaque fonction d'analyse et de réparation vérifie le gestionnaire de réseau actif avant de toucher quoi que ce soit. Si l'hôte exécute <strong>netplan</strong>, <strong>systemd-networkd</strong> ou <strong>NetworkManager</strong>, l'outil avorte immédiatement avec un message clair — le menu ne prend en charge que la pile classique Debian/Proxmox à <code>/etc/network/interfaces</code>. Ceci est intentionnel : l'édition d'un fichier netplan avec des règles écrites pour <code>ifupdown</code> corromprait silencieusement la configuration.",
+  "backups": {
+    "heading": "Où vont les sauvegardes",
+    "intro": "Chaque réparation guidée, restauration ou sauvegarde manuelle écrit une copie horodatée de <code>/etc/network/interfaces</code> à <code>/var/backups/proxmenux/</code> :",
+    "rollbackIntro": "Pour revenir manuellement à la configuration précédente depuis une console :"
+  },
+  "readOnlySection": {
+    "heading": "Contrôle en lecture seule",
+    "body": "Le point de départ lorsque quelque chose semble anormal. Inspection uniquement — n’écrit jamais dans <code>/etc/network/interfaces</code> et n’exécute aucune commande de modification, à une exception explicite près : la purge de NetworkManager, s’il est détecté, nécessite votre accord. Utilisable en toute sécurité via SSH à tout moment.",
+    "options": [
+      {
+        "title": "Diagnostic",
+        "description": "Trois vérifications en lecture seule : Afficher la table d'acheminement, tester la connectivité et les diagnostics avancés. L'inspection pure n'écrit jamais au système."
+      },
+      {
+        "title": "Outils de surveillance en direct",
+        "description": "Trois lanceurs interactifs : iftop (bande passante en temps réel par paire d'hôtes), iptraf-ng (moniteur de trafic multimode) et iperf3 (test de bande passante, serveur / mode client)."
+      }
+    ]
+  },
+  "analyzeSection": {
+    "heading": "Analysez, puis suggérez",
+    "body": "À utiliser lorsqu’une inspection ou une panne réelle révèle un problème de configuration. Chaque outil examine la partie concernée de <code>/etc/network/interfaces</code>, affiche un rapport détaillé avec la commande shell exacte qui corrigerait chaque problème, puis <strong>s’arrête</strong>. Si vous acceptez ensuite la réparation guidée facultative, chaque modification est sauvegardée et prévisualisée avant d’être écrite.",
+    "options": [
+      {
+        "title": "Analyse des ponts et réparation guidée",
+        "description": "Détecte les ponts vmbrX dont les ports sont absents ou invalides, par exemple après une réénumération PCI. Affiche d’abord un rapport et ne répare que si vous acceptez la procédure guidée en 5 étapes."
+      },
+      {
+        "title": "Analyse de configuration et nettoyage guidé",
+        "description": "Repère les interfaces physiques déclarées dans /etc/network/interfaces qui n’existent plus, c’est-à-dire les configurations orphelines laissées par des changements matériels. Les signale et propose une suppression guidée."
+      }
+    ]
+  },
+  "applySection": {
+    "heading": "Appliquer avec sauvegarde",
+    "body": "Ces outils écrivent sur le disque par leur fonctionnement même. Chacun crée une sauvegarde horodatée du fichier concerné avant l’écriture, et les options destructives, comme la restauration et le redémarrage, exigent une confirmation explicite oui/non. Les <em>noms d’interface persistants</em> prennent effet au prochain redémarrage, pas immédiatement ; leur mise en place peut donc être planifiée en toute sécurité même sur un hôte distant.",
+    "options": [
+      {
+        "title": "Noms d'interface persistants",
+        "description": "Associe les noms d’interface (eno1, enp3s0, …) aux adresses MAC au moyen de fichiers .link de systemd. Les noms restent stables après un changement d’emplacement PCI, une mise à niveau du noyau ou l’ajout ou le retrait d’autres cartes réseau."
+      },
+      {
+        "title": "Sauvegarde et redémarrage des interfaces",
+        "description": "Un instantané manuel de /etc/network/interfaces, parcourir et restaurer les sauvegardes précédentes, afficher la configuration en direct et redémarrer le service de réseautage au besoin."
+      }
+    ]
+  },
+  "consoleTitle": "Préparez l'accès à la console",
+  "consoleSubTitle": "Avant toute réparation sur un hôte distant",
+  "consoleBody": "Si vous êtes connecté via SSH et ne disposez que d’un seul accès à l’hôte, prévoyez une solution de secours avant toute modification réseau : console physique / IPMI / iKVM ou autre machine sur le même réseau local. Les réparations guidées sont sûres et proposent toujours une commande de retour en arrière, mais un pont mal configuré ou une liaison interrompue peut tout de même vous priver d’accès jusqu’à ce que vous puissiez atteindre la console."
+}

web/messages/fr/docs/network/monitoring.json

@@ -0,0 +1,136 @@
+{
+  "meta": {
+    "title": "Outils de surveillance en direct | Documentation ProxMenux",
+    "description": "Trois lanceurs interactifs de surveillance du réseau : iftop (bande passante en temps réel par paire d'hôtes), iptraf-ng (moniteur de trafic multimode) et iperf3 (test de bande passante, serveur / mode client). Chacun est installé lors de la première utilisation.",
+    "ogTitle": "Outils de surveillance en direct | Documentation ProxMenux",
+    "ogDescription": "Surveillance réseau interactive et test de bande passante pour l'hôte Proxmox : iftop, iptraf-ng, iperf3."
+  },
+  "header": {
+    "title": "Outils de surveillance en direct",
+    "description": "Trois lanceurs interactifs pour observer le réseau en temps réel et mesurer la bande passante : iftop, iptraf-ng et iperf3. Chaque outil est installé automatiquement via apt au premier usage, fonctionne au premier plan et se quitte avec la touche indiquée. Ils ne modifient pas la configuration réseau de l’hôte ; iperf3 génère du trafic de test.",
+    "section": "Réseau"
+  },
+  "intro": {
+    "title": "Ce que ça fait",
+    "body": "Trois outils de suivi interactifs, chacun derrière sa propre entrée de menu. La première fois que vous en lancez un, le paquet est installé silencieusement via <code>apt-get</code>. Les lancements suivants commencent instantanément. Aucun de ces outils ne modifie la configuration du réseau hôte."
+  },
+  "when": {
+    "heading": "Quel outil utiliser selon le besoin",
+    "headerQuestion": "Question",
+    "headerUse": "Utiliser",
+    "rows": [
+      {
+        "question": "Qui sature le lien <em> maintenant</em> ?",
+        "use": "iftop"
+      },
+      {
+        "question": "Quelle est la répartition par protocole, quelles tailles de paquets et quels flux TCP circulent ?",
+        "use": "iptraf-ng"
+      },
+      {
+        "question": "Combien de bande passante est disponible entre deux hôtes ?",
+        "use": "iperf3"
+      }
+    ]
+  },
+  "iftop": {
+    "heading": "Utilisation du réseau en temps réel (iftop)",
+    "body": "Bande passante en direct par paire d’hôtes (source ↔ destination) — comme <code>top</code> pour le trafic. Affiche les flux les plus importants en haut, avec des moyennes glissantes sur 2/10/40 secondes. L’outil idéal pour savoir <em>« pourquoi ma liaison montante est saturée »</em>.",
+    "exit": "<strong>Quitter :</strong> appuyez sur <kbd>q</kbd>. ProxMenux affiche un rappel avant le lancement.",
+    "keysTitle": "Touches utiles dans iftop",
+    "keysBody": "<kbd>n</kbd> active ou désactive les recherches DNS, <kbd>p</kbd> affiche les numéros de port, <kbd>P</kbd> fige l’affichage, <kbd>t</kbd> change le sens des lignes (envoi / réception / les deux), <kbd>1</kbd>/<kbd>2</kbd>/<kbd>3</kbd> trie par moyenne sur 2 s / 10 s / 40 s. Liste complète dans <code>man iftop</code>."
+  },
+  "iptraf": {
+    "heading": "Outil de surveillance du réseau (iptraf-ng)",
+    "intro": "Un outil de surveillance du trafic à plusieurs modes, piloté par menu. iftop répond à <em>« qui »</em>, tandis qu’iptraf-ng répond à <em>« quoi »</em> : compteurs d’octets et de paquets par protocole, suivi de l’état des connexions TCP, histogrammes de taille des paquets et activité LAN par station.",
+    "menuIntro": "Au lancement, vous obtenez un menu à cinq options :",
+    "headerMode": "Mode",
+    "headerUseFor": "Utilisez-le pour",
+    "rows": [
+      {
+        "mode": "Surveillance du trafic IP",
+        "useFor": "Liste de flux en direct TCP / UDP / ICMP / autre-IP avec compteurs d'octets et état de connexion"
+      },
+      {
+        "mode": "Statistiques générales de l'interface",
+        "useFor": "Nombre total de paquets IPv4 / IPv6 / TCP / UDP / ICMP / non IP par carte réseau"
+      },
+      {
+        "mode": "Statistiques détaillées de l'interface",
+        "useFor": "Comme ci-dessus, mais pour une interface, avec la taille du paquet et le détail du taux"
+      },
+      {
+        "mode": "Ventilations statistiques",
+        "useFor": "Histogramme de distribution de la taille du paquet, par port TCP / UDP"
+      },
+      {
+        "mode": "Moniteur de station LAN",
+        "useFor": "Statistiques du trafic par adresse MAC pour le domaine de diffusion local"
+      }
+    ],
+    "exit": "<strong>Quitter :</strong> appuyez sur <kbd>x</kbd> depuis n’importe quelle vue ou sur <kbd>Q</kbd> depuis le menu principal. ProxMenux affiche un rappel avant le lancement.",
+    "logTitle": "Enregistrer les captures dans un fichier",
+    "logBody": "Chaque mode propose d’enregistrer les statistiques capturées dans <code>/var/log/iptraf-ng/</code>. Pour conserver une trace d’un pic de trafic, laissez l’outil tourner, enregistrez dans un fichier et examinez-le ensuite plutôt que d’essayer de suivre l’écran en direct."
+  },
+  "iperf3": {
+    "heading": "Test de bande passante (iperf3)",
+    "intro1": "Mesure le débit TCP réel entre deux hôtes. Contrairement à iftop / iptraf-ng, qui observent le trafic existant, iperf3 génère du trafic synthétique pour tester la liaison en charge. Indispensable pour répondre à <em>« Ma liaison 10 GbE atteint-elle vraiment 10 GbE ? »</em> ou <em>« Le goulot d’étranglement vient-il de la carte réseau, du commutateur ou du stockage ? »</em>.",
+    "intro2": "iperf3 est un <strong>outil à deux hôtes</strong> : l’un est le serveur, en écoute sur le port TCP 5201 ; l’autre est le client, qui se connecte, envoie les données et affiche le débit. Le lanceur ProxMenux demande le mode souhaité :",
+    "headerMode": "Mode",
+    "headerBehaviour": "Comportement",
+    "headerCli": "Commande CLI équivalente",
+    "rows": [
+      {
+        "mode": "Serveur",
+        "behaviour": "Écoute sur TCP 5201 et imprime les résultats pour chaque test entrant. Arrête sur Ctrl+C.",
+        "cli": "iperf3 -s"
+      },
+      {
+        "mode": "Client",
+        "behaviour": "Demande l’adresse IP ou le nom d’hôte du serveur, se connecte, lance le test par défaut de 10 secondes et affiche le rapport.",
+        "cli": "iperf3 -c <target>"
+      }
+    ],
+    "workflowIntro": "Typiquement pour tester un lien 10 GbE entre deux hôtes Proxmox :",
+    "workflow": [
+      "Sur l’hôte A, ouvrez le menu Réseau → <em>Test de bande passante (iperf3)</em> → choisissez <strong>Serveur</strong>.",
+      "Sur l'hôte B, ouvrez la même entrée de menu → choisissez <strong>Client</strong> → saisissez l'IP de l'hôte A.",
+      "Attendez 10 secondes. Comparez le taux déclaré au maximum théorique du lien."
+    ],
+    "sample": "Exemple de sortie client :",
+    "flagsTitle": "Options utiles à utiliser manuellement depuis un shell",
+    "flagsBody": "<code>-t 60</code> test plus long (60 s au lieu de 10 s), <code>-P 4</code> 4 flux parallèles (saturation plus rapide), <code>-R</code> sens inverse (serveur → client), <code>-u -b 100M</code> test UDP à 100 Mbit/s (mesure de la gigue et des pertes de paquets), <code>-p 5202</code> autre port (plusieurs tests en parallèle). Liste complète dans <code>man iperf3</code>.",
+    "firewallTitle": "Ouvrez le port pare-feu sur le serveur",
+    "firewallBody": "Le serveur écoute sur TCP <strong>5201</strong> par défaut. Si vous exécutez le serveur à l'intérieur d'un hôte Proxmox avec un pare-feu strict (datacenter ou niveau hôte), autorisez TCP 5201 entrant à partir de l'IP du client pour la durée du test, puis fermez-le à nouveau. Il en va de même pour <code>nftables</code> / <code>iptables</code> sur les hôtes nus."
+  },
+  "install": {
+    "heading": "Le premier lancement installe le paquet",
+    "body": "Les trois lanceurs vérifient le binaire et exécutent <code>apt-get update -qq &amp;&amp; apt-get install -y &lt;pkg&gt;</code> s'il manque. L'installation est silencieuse : le menu peut apparaître gelé pour 10–30 secondes la première fois. Les lancements suivants commencent instantanément."
+  },
+  "troubleshoot": {
+    "heading": "Dépannage",
+    "hangTitle": "L’installation reste bloquée au premier lancement",
+    "hangBody": "L'hôte n'a pas d'internet ou les repos apt sont inaccessibles. Annuler avec <kbd>Ctrl</kbd>+<kbd>C</kbd>, exécuter <code>apt-get update</code> manuellement pour voir l'erreur réelle (DNS, repo signature, proxy ...), puis revenir au menu.",
+    "refusedTitle": "Client iperf3 : « unable to connect to server: Connection refused »",
+    "refusedBody": "Soit le serveur ne fonctionne pas, soit son pare-feu bloque TCP 5201. Confirmer sur le serveur: <code>ss -tlnp | grep 5201</code> — doit afficher l'écoute iperf3. Si l'écoute, mais que le client échoue, vérifiez le chemin du pare-feu entre les deux hôtes.",
+    "slowTitle": "iperf3 indique un débit bien inférieur à la vitesse attendue de la liaison",
+    "slowBody": "Causes courantes par ordre de probabilité : (1) le processeur d’un hôte limite le débit — essayez <code>iperf3 -c &lt;target&gt; -P 4</code> pour utiliser plusieurs cœurs ; (2) le trajet passe par une liaison plus lente, par exemple un commutateur gigabit entre deux cartes 10 GbE ; (3) MTU différents — vérifiez <code>ip link show</code> aux deux extrémités ; (4) offloading de la carte réseau désactivé — voir le script communautaire <em>Disable NIC Offloading</em> pour une carte Intel e1000e.",
+    "noTrafficTitle": "iftop / iptraf-ng ne montre aucun trafic pour un hôte occupé",
+    "noTrafficBody": "La capture par défaut est sur la première interface détectée. Spécifiez le bon explicitement depuis le shell : <code>iftop -i vmbr0</code> ou <code>iptraf-ng -i vmbr0</code>. Le lanceur de menu utilise la valeur par défaut; pour les interfaces non par défaut, exécuter à partir d'une console."
+  },
+  "related": {
+    "heading": "Voir aussi",
+    "items": [
+      {
+        "label": "Diagnostic",
+        "href": "/docs/network/diagnostics",
+        "tail": "— les contrôles en lecture seule (routage, connectivité, statistiques avancées)."
+      },
+      {
+        "label": "Analyse des ponts et réparation guidée",
+        "href": "/docs/network/bridge-analysis",
+        "tail": "— lorsque la surveillance révèle qu'une interface ou un pont ne fait pas ce qu'il faut."
+      }
+    ]
+  }
+}

web/messages/fr/docs/network/persistent-names.json

@@ -0,0 +1,130 @@
+{
+  "meta": {
+    "title": "Noms d’interface persistants | Documentation ProxMenux",
+    "description": "Associez les noms d’interface Proxmox (eno1, enp3s0, …) aux adresses MAC via des fichiers .link de systemd pour les conserver après une réénumération PCI, une mise à niveau du noyau ou l’ajout ou le retrait d’autres cartes réseau.",
+    "ogTitle": "Noms d’interface persistants | Documentation ProxMenux",
+    "ogDescription": "Empêchez les noms d’interface Proxmox de changer lors des modifications matérielles. Utilise des fichiers .link de systemd associés aux adresses MAC."
+  },
+  "header": {
+    "title": "Noms d'interface persistants",
+    "description": "Génère un fichier .link de systemd par carte réseau physique pour associer le nom attribué par le noyau à son adresse MAC. Après application au prochain redémarrage, les noms d’interface restent stables lorsque vous ajoutez, retirez ou déplacez des cartes PCIe.",
+    "section": "Réseau"
+  },
+  "intro": {
+    "title": "Ce que ça fait",
+    "body": "Pour chaque NIC physique sur l'hôte, écrit un petit fichier sous <code>/etc/systemd/network/10-&lt;iface&gt;.link</code> qui dit : <em>\"le périphérique avec ce MAC doit toujours être appelé ce nom\"</em>. systemd-udevd applique la règle à chaque démarrage, avant que <code>ifupdown</code> ne lise <code>/etc/network/interfaces</code>."
+  },
+  "problem": {
+    "heading": "Le problème que cela résout",
+    "intro": "Linux déduit les noms d’interface par défaut de la topologie PCI — <code>eno1</code> = intégrée à la carte mère, <code>enp3s0</code> = carte sur le bus PCI 3, emplacement 0, etc. Le nommage est déterministe <em>pour une même disposition matérielle</em>. Si cette disposition change, les noms changent :",
+    "items": [
+      "Ajoutez un GPU devant un NIC existant → le numéro de bus NIC peut changer → changement de nom.",
+      "Déplacer une carte vers une autre fente PCIe → nom change.",
+      "BIOS / UEFI mise à jour qui réénumère les appareils → noms peuvent changer.",
+      "Remplacer une carte défectueuse par le même modèle dans une autre fente → nom change."
+    ],
+    "outro": "Après un tel changement, <code>/etc/network/interfaces</code> fait toujours référence à l’<em>ancien</em> nom ; le pont ne s’active pas et l’hôte perd le réseau. Les noms persistants évitent que cette situation se reproduise."
+  },
+  "howWorks": {
+    "heading": "Comment ça marche",
+    "arrowLabel": "par NIC",
+    "nodes": {
+      "detectLabel": "Détecter les cartes réseau physiques",
+      "detectDetail": "ls /sys/class/net/\nexclure vmbr / bond /\ndocker / veth / wireguard …",
+      "readLabel": "Lire chaque MAC",
+      "readDetail": "cat /sys/class/net/\n  '<'iface'>'/address",
+      "writeLabel": "Écrivez le fichier .link",
+      "writeDetail": "/etc/systemd/network/\n  10-'<'iface'>'.link"
+    },
+    "minimalIntro": "Chaque fichier généré est volontairement minimal :",
+    "minimalOutro": "Au démarrage, systemd-udevd identifie le périphérique par son adresse MAC et lui attribue le nom demandé <em>avant</em> l’intervention d’autres composants (ifupdown, nommage par défaut du noyau). Le préfixe <code>10-</code> garantit le chargement précoce de ces règles, avant le fichier par défaut <code>99-default.link</code>."
+  },
+  "scope": {
+    "heading": "Ce qui est écrit, ce qui est ignoré",
+    "headerType": "Type",
+    "headerBehaviour": "Comportement",
+    "headerWhy": "Pourquoi",
+    "rows": [
+      {
+        "type": "Carte réseau intégrée / PCIe",
+        "behaviour": "fichier <code>.link</code> écrit",
+        "why": "Repose sur un véritable périphérique PCI — le cas auquel l’outil est destiné"
+      },
+      {
+        "type": "Wi-Fi (phy80211)",
+        "behaviour": "fichier <code>.link</code> écrit",
+        "why": "A une vraie MAC et bénéficie de la stabilité des noms"
+      },
+      {
+        "type": "Ponts (vmbrX)",
+        "behaviour": "Ignoré",
+        "why": "Virtuel; le nom vient de <code>/etc/network/interfaces</code>"
+      },
+      {
+        "type": "Agrégations (bondX)",
+        "behaviour": "Ignoré",
+        "why": "Virtuel ; le nom de l’agrégation est défini par ifupdown"
+      },
+      {
+        "type": "veth / docker0 / br-XXXX",
+        "behaviour": "Ignoré",
+        "why": "Créé sur demande par Docker / LXC — matériel non persistant"
+      },
+      {
+        "type": "tap / fwpr / fwln",
+        "behaviour": "Ignoré",
+        "why": "Créé sur demande par Proxmox par VM/CT"
+      },
+      {
+        "type": "WireGuard / Cilium / Tailscale",
+        "behaviour": "Ignoré",
+        "why": "Interfaces logicielles gérées par leurs propres démons"
+      }
+    ]
+  },
+  "safety": {
+    "heading": "Filet de sécurité : les fichiers .link précédents sont sauvegardés",
+    "intro": "Si <code>/etc/systemd/network/</code> contient déjà des fichiers <code>.link</code> (à partir d'une exécution précédente ou d'un autre outil), ils sont copiés dans un répertoire de sauvegarde horodaté avant que les nouveaux fichiers ne soient générés :",
+    "outro": "Pour revenir en arrière : copiez les fichiers à partir du répertoire de sauvegarde et redémarrez.",
+    "rebootTitle": "Prend effet sur le prochain redémarrage, pas immédiatement",
+    "rebootBody": "Les modifications des fichiers <code>.link</code> ne s’appliquent qu’au démarrage, lorsque udev réénumère les périphériques. L’outil indique donc <em>« Les modifications s’appliqueront après le redémarrage »</em>. Renommer une interface en cours de fonctionnement est risqué et n’est pas tenté : un <code>vmbr0</code> actif avec des interfaces membres devrait être reconfiguré de manière atomique. L’opération est donc reportée au prochain démarrage propre."
+  },
+  "afterReboot": {
+    "heading": "Après le redémarrage",
+    "intro": "Une fois les noms épinglés, le flux de travail des futurs changements matériels est simple :",
+    "items": [
+      "Éteignez, modifiez le matériel (ajout de carte, changement d’emplacement, …), puis démarrez.",
+      "Chaque NIC conserve son nom précédent car son MAC correspond à un fichier <code>.link</code>.",
+      "Si un NIC est remplacé (différent MAC), il obtient un nom de noyau par défaut (<code>enp&lt;bus&gt;s&lt;slot&gt;</code>); ré-exécutez ce menu pour ajouter une entrée <code>.link</code> pour le MAC de la nouvelle carte."
+    ]
+  },
+  "troubleshoot": {
+    "heading": "Dépannage",
+    "emptyTitle": "\"Aucune interface physique trouvée\" après avoir lancé l'outil",
+    "emptyBody": "Aucune interface reposant sur PCI ou phy80211 n’est visible par le noyau sur l’hôte. Vérifiez avec <code>ls -l /sys/class/net/</code> : chaque entrée doit avoir soit un lien symbolique <code>device</code> (PCI), soit une entrée <code>phy80211</code> (Wi-Fi). Si les deux sont absents pour une véritable carte réseau, le pilote n’est pas chargé.",
+    "noChangeTitle": "Après le redémarrage, les noms n'ont pas changé comme prévu",
+    "noChangeBody": "Vérifiez que le fichier est présent et correctement formé : <code>cat /etc/systemd/network/10-&lt;iface&gt;.link</code>. Consultez ensuite les journaux udev : <code>journalctl -u systemd-udevd -b | grep -i link</code>. Un ancien paramètre du noyau <code>net.ifnames=0</code> désactive entièrement le nommage prévisible : supprimez-le de <code>/etc/default/grub</code>, exécutez <code>update-grub</code>, puis redémarrez.",
+    "undoTitle": "Je veux annuler les noms persistants",
+    "undoBody": "Supprimez les fichiers <code>.link</code> (<code>rm /etc/systemd/network/10-*.link</code>) ou restaurez-les depuis le répertoire de sauvegarde créé lors de l’exécution précédente. Redémarrez pour appliquer les modifications."
+  },
+  "related": {
+    "heading": "Voir aussi",
+    "items": [
+      {
+        "label": "Analyse des ponts et réparation guidée",
+        "href": "/docs/network/bridge-analysis",
+        "tailRich": " — la solution de récupération lorsque les noms ont <em>déjà</em> changé."
+      },
+      {
+        "label": "Analyse de configuration et nettoyage guidé",
+        "href": "/docs/network/config-analysis",
+        "tail": " — pour supprimer les blocs orphelins laissés par les changements de noms."
+      },
+      {
+        "label": "Diagnostic",
+        "href": "/docs/network/diagnostics",
+        "tailRich": "— confirmer les nouveaux noms avec <em>Afficher la table d'acheminement</em> après le redémarrage."
+      }
+    ]
+  }
+}