{ "meta": { "title": "Trvalé názvy rozhraní | Dokumentácia ProxMenux", "description": "Priraďte názvy rozhraní Proxmox (eno1, enp3s0, …) k MAC adresám pomocou súborov .link služby systemd, aby zostali zachované pri opätovnom číslovaní PCI, aktualizáciách jadra a pridávaní či odoberaní iných sieťových kariet.", "ogTitle": "Trvalé názvy rozhraní | Dokumentácia ProxMenux", "ogDescription": "Zabráňte zmene názvov rozhraní Proxmox pri zmene hardvéru. Používa súbory .link služby systemd s priradením podľa MAC adresy." }, "header": { "title": "Trvalé názvy rozhraní", "description": "Pre každú fyzickú sieťovú kartu vytvorí súbor .link služby systemd, ktorý priradí názov pridelený jadrom k MAC adrese karty. Po použití pri ďalšom reštarte sa názvy rozhraní prestanú meniť pri pridávaní, odoberaní alebo presúvaní kariet PCIe.", "section": "Sieť" }, "intro": { "title": "Čo to robí?", "body": "Pre každú fyzickú sieťovú kartu hostiteľa zapíše malý súbor /etc/systemd/network/10-<iface>.link s pravidlom: „Zariadenie s touto MAC adresou sa musí vždy volať týmto názvom.“ systemd-udevd použije pravidlo pri každom štarte skôr, než ifupdown prečíta /etc/network/interfaces." }, "problem": { "heading": "Problém, ktorý rieši", "intro": "Linux odvodzuje predvolené názvy rozhraní z topológie PCI — eno1 = integrovaná karta, enp3s0 = karta na zbernici PCI 3, slot 0 atď. Schéma názvov je deterministická pri rovnakom rozložení hardvéru. Ak sa rozloženie zmení, zmenia sa aj názvy:", "items": [ "Pridanie GPU pred existujúcu sieťovú kartu → číslo zbernice sieťovej karty sa môže zmeniť → zmení sa názov.", "Presunutie karty do iného slotu PCIe → zmení sa názov.", "Aktualizácia BIOS / UEFI s opätovným číslovaním zariadení → názvy sa môžu zmeniť.", "Nahradenie chybnej karty rovnakým modelom v inom slote → zmení sa názov." ], "outro": "Po takejto zmene /etc/network/interfaces stále odkazuje na starý názov; most sa neaktivuje a hostiteľ stratí sieťové pripojenie. Nastavenie trvalých názvov zabráni opakovaniu tejto situácie." }, "howWorks": { "heading": "Ako to funguje", "arrowLabel": "na NIC", "nodes": { "detectLabel": "Zistiť fyzické sieťové karty", "detectDetail": "ls /sys/class/net/\nvylúčiť vmbr / bond /\ndocker / veth / wireguard …", "readLabel": "Prečítať každú MAC adresu", "readDetail": "cat /sys/class/net/\n '<'iface'>'/address", "writeLabel": "Zapísať súbor .link", "writeDetail": "/etc/systemd/network/\n 10-'<'iface'>'.link" }, "minimalIntro": "Každý vygenerovaný súbor je zámerne minimálny:", "minimalOutro": "Pri štarte systemd-udevd identifikuje zariadenie podľa MAC adresy a pridelí požadovaný názov skôr, než zasiahnu iné komponenty (ifupdown, predvolené pomenovanie jadra). Predpona 10- zabezpečuje skoré načítanie pravidiel pred predvoleným súborom 99-default.link." }, "scope": { "heading": "Čo sa napíše, čo sa preskočí", "headerType": "Typ", "headerBehaviour": "Správanie", "headerWhy": "Prečo?", "rows": [ { "type": "Integrovaná / PCIe sieťová karta", "behaviour": "Zapíše sa súbor .link", "why": "Zodpovedá skutočnému zariadeniu PCI — prípad, pre ktorý je nástroj určený" }, { "type": "Wi-Fi (phy80211)", "behaviour": "Zapíše sa súbor .link", "why": "Má skutočnú MAC adresu a využije stabilný názov" }, { "type": "Mosty (vmbrX)", "behaviour": "Preskočené", "why": "Virtuálne; meno pochádza z /etc/network/interfaces" }, { "type": "Bondy (bondX)", "behaviour": "Preskočené", "why": "Virtuálne; názov bondu nastavuje ifupdown" }, { "type": "veth / docker0 / br-XXXX", "behaviour": "Preskočené", "why": "Vytvárané podľa potreby systémom Docker / LXC — nejde o trvalý hardvér" }, { "type": "tap / fwpr / fwln", "behaviour": "Preskočené", "why": "Vytvárané podľa potreby systémom Proxmox pre každú VM/CT" }, { "type": "WireGuard / Cilium / Tailscale", "behaviour": "Preskočené", "why": "Softvérové rozhrania spravované vlastnými démonmi" } ] }, "safety": { "heading": "Ochrana: predchádzajúce súbory .link sa zálohujú", "intro": "Ak /etc/systemd/network/ už obsahuje .link súbory (z predchádzajúceho spustenia alebo iného nástroja), skopírujú sa do záložného adresára s časovou značkou pred generovaním nových:", "outro": "Ak chcete vrátiť späť: skopírujte súbory späť zo záložného adresára a reštartujte.", "rebootTitle": "Prejaví sa pri ďalšom reštarte, nie okamžite", "rebootBody": "Zmeny súborov .link sa použijú iba pri štarte, keď udev znovu enumeruje zariadenia. Preto nástroj hlási „Zmeny sa použijú po reštarte“. Premenovanie rozhrania za behu je riskantné a nástroj sa oň nepokúša: aktívny vmbr0 s členskými rozhraniami by sa musel prekonfigurovať atómovo. Operácia sa preto odkladá na ďalší čistý štart." }, "afterReboot": { "heading": "Po reštarte", "intro": "Keď sú názvy napevno priradené, postup pri budúcich zmenách hardvéru je jednoduchý:", "items": [ "Vypnite počítač, zmeňte hardvér (pridajte kartu, zmeňte slot, …) a spustite ho.", "Každý NIC si ponechá svoje predchádzajúce meno, pretože jeho MAC zodpovedá súboru .link.", "Ak je NIC nahradený (iný MAC), dostane predvolený názov jadra (enp<bus>s<slot>); znovu spustite toto menu pre pridanie položky .link pre MAC novej karty." ] }, "troubleshoot": { "heading": "Riešenie problémov", "emptyTitle": "\"Nenájdené žiadne fyzické rozhrania\" po spustení nástroja", "emptyBody": "Jadro na hostiteľovi nevidí žiadne rozhrania založené na PCI / phy80211. Overte to cez ls -l /sys/class/net/ — každá položka by mala obsahovať symbolický odkaz device (PCI) alebo položku phy80211 (Wi-Fi). Ak pri skutočnej sieťovej karte chýbajú obe, ovládač nie je načítaný.", "noChangeTitle": "Po reštarte sa mená nezmenili podľa očakávania.", "noChangeBody": "Skontrolujte, či súbor existuje a má správny formát: cat /etc/systemd/network/10-<iface>.link. Potom skontrolujte záznamy udev: journalctl -u systemd-udevd -b | grep -i link. Bežnou príčinou je starý parameter jadra net.ifnames=0, ktorý úplne vypína predvídateľné názvy — odstráňte ho z /etc/default/grub, spustite update-grub a reštartujte.", "undoTitle": "Chcem zrušiť trvalé pomenovanie.", "undoBody": "Buď odstráňte súbory .link (rm /etc/systemd/network/10-*.link), alebo ich obnovte z adresára záloh vytvoreného pri predchádzajúcom spustení. Zmenu použijete reštartom." }, "related": { "heading": "Súvisiace", "items": [ { "label": "Analýza mostov a oprava so sprievodcom", "href": "/docs/network/bridge-analysis", "tailRich": " — postup obnovy, keď sa názvy už zmenili." }, { "label": "Analýza konfigurácie a čistenie so sprievodcom", "href": "/docs/network/config-analysis", "tail": " — na odstránenie osirelých blokov, ktoré zostali po zmenách názvov." }, { "label": "Diagnostika", "href": "/docs/network/diagnostics", "tailRich": " — po reštarte overte nové názvy cez Zobraziť smerovaciu tabuľku." } ] } }