docs: review networking documentation in all seven translations

This commit is contained in:
Jonatan
2026-10-17 15:08:53 +02:00
parent ce1a3de719
commit 427c3dc2b9
51 changed files with 5056 additions and 60 deletions
@@ -0,0 +1,110 @@
{
"meta": {
"title": "Záloha a reštart rozhraní | Dokumentácia ProxMenux",
"description": "Ručné vytváranie snímok, prehliadanie a obnova záloh /etc/network/interfaces uložených v /var/backups/proxmenux/. Zahŕňa reštart sieťovej služby s potvrdením a rýchle zobrazenie aktuálnej konfigurácie.",
"ogTitle": "Záloha a reštart rozhraní | Dokumentácia ProxMenux",
"ogDescription": "Vytvorte snímku a obnovte sieťovú konfiguráciu Proxmox; reštartujte sieťovú službu s potvrdením."
},
"header": {
"title": "Záloha a reštart rozhraní",
"description": "Štyri nástroje pre /etc/network/interfaces: ručne vytvoriť snímku, zobraziť aktuálnu konfiguráciu, obnoviť predchádzajúcu zálohu s voliteľným náhľadom a reštartovať sieťovú službu s výslovným súhlasom. Používajú rovnaký záložný adresár ako opravy so sprievodcom.",
"section": "Sieť"
},
"intro": {
"title": "Čo to robí?",
"body": "Spravuje rovnaký adresár záloh ako opravy so sprievodcom (<code>/var/backups/proxmenux/</code>). Umožňuje vytvoriť ďalšiu snímku pred každou ručnou zmenou, prehliadať všetky existujúce zálohy a obnoviť ktorúkoľvek z nich — vždy s automaticky vytvorenou novou zálohou stavu pred obnovou ako druhou ochranou."
},
"shared": {
"heading": "Zdieľaný adresár zálohovania",
"intro": "Každá záloha vytvorená kdekoľvek v menu Sieť sa uloží na rovnaké miesto:",
"outro": "Názvy súborov sú časovo označené, zoradené podľa dátumu a nikdy neprepísané. Adresár je vytvorený pri prvom použití."
},
"show": {
"heading": "Zobraziť konfiguračný súbor siete",
"body": "Vypíše presný obsah <code>/etc/network/interfaces</code> do terminálu. Iba na čítanie. Užitočné na kontrolu pred zálohovaním alebo po obnove. Samostatný nástroj na porovnanie s predchádzajúcou zálohou neexistuje, takže najjednoduchšie je skontrolovať obsah aktuálneho súboru pohľadom."
},
"create": {
"heading": "Vytvoriť zálohu siete",
"body": "Skopíruje aktuálny <code>/etc/network/interfaces</code> do adresára záloh s novou časovou pečiatkou. To je všetko — bez analýzy, bez výziev, iba snímka.",
"whenTitle": "Kedy vytvoriť ručnú zálohu",
"whenBody": "Pred ručnou úpravou <code>/etc/network/interfaces</code>, pred inštaláciou balíka, ktorý môže meniť sieťový stack (napríklad NetworkManager alebo Open vSwitch), alebo pred zmenami hardvéru. Opravy so sprievodcom už vytvárajú snímky automaticky — táto možnosť je určená na <em>ručné</em> zásahy."
},
"restore": {
"heading": "Obnoviť sieť zo zálohy",
"intro": "Zobrazí všetky zálohy v <code>/var/backups/proxmenux/</code> od najnovšej po najstaršiu a prevedie vás obnovou s bezpečnostnými opatreniami:",
"steps": [
{
"title": "1. Vybrať zálohu",
"body": "Menu zobrazí každú zálohu podľa jej časovej pečiatky. Ak neexistujú žiadne zálohy, postup sa ukončí s jasným hlásením.",
"tone": "blue"
},
{
"title": "2. Nepovinný náhľad",
"body": "Ponúkne otvorenie vybranej zálohy v posúvateľnom zobrazení pred potvrdením obnovy. Predvolená odpoveď je Áno — na vzdialenom hostiteľovi tento krok nevynechávajte.",
"tone": "blue"
},
{
"title": "3. Záloha pred obnovou",
"body": "Pred prepísaním <code>/etc/network/interfaces</code> vytvorí <strong>ďalšiu</strong> zálohu aktuálneho stavu. Obnova je sama osebe deštruktívna akcia, preto nová snímka pred obnovou umožní návrat, ak bola vybraná záloha nesprávna.",
"tone": "amber"
},
{
"title": "4. Použiť obnovenie",
"body": "Kopíruje vybranú zálohu cez <code>/etc/network/interfaces</code>. Zmena súboru je na disku; stav živého jadra stále odráža predchádzajúcu konfiguráciu.",
"tone": "amber"
},
{
"title": "5. Nepovinný reštart",
"body": "Pýta sa, či má teraz spustiť <code>systemctl restart networking</code>. Odmietnutím odložíte použitie zmeny na ďalší reštart.",
"tone": "emerald"
}
],
"autoBackupTitle": "Obnova automaticky vytvorí vlastnú zálohu",
"autoBackupBody": "Výber <em>Obnoviť sieť zo zálohy</em> vždy vytvorí novú snímku <em>aktuálnej</em> konfigurácie pred jej prepísaním. Ak obnovíte nesprávnu zálohu, najnovší súbor v <code>/var/backups/proxmenux/</code> obsahuje predchádzajúci stav."
},
"restart": {
"heading": "Reštartovať sieťovú službu",
"body": "Po potvrdení áno/nie spustí <code>systemctl restart networking</code>. Výsledok oznámi cez <code>msg_ok</code> / <code>msg_error</code>. Väčšina postupov v tomto menu ponúka vlastný reštart na konci. Táto možnosť slúži na reštart po ručnej úprave alebo po odmietnutí skôr ponúknutého reštartu.",
"warnTitle": "Zaručené krátke odpojenie; možné trvalé odpojenie",
"warnBody": "Reštart <code>networking</code> deaktivuje a znovu nastaví každé rozhranie deklarované v <code>/etc/network/interfaces</code>. Relácie SSH cez tieto rozhrania sa prerušia. Ak je nová konfigurácia neplatná, sieť sa neobnoví. Spustite to iba vtedy, keď:",
"warnItems": [
"Máte konzolu / IPMI / iKVM prístup pripravený, <em>alebo</em>",
"Ste fyzicky vedľa stroja, <em>alebo</em>",
"Práve ste úspešne obnovili overenú funkčnú konfiguráciu a chcete ju použiť."
]
},
"manualRollback": {
"heading": "Ručné vrátenie zmien z konzoly",
"intro": "Ak nemôžete dosiahnuť menu (žiadne SSH, dialógové zrútenie, ...), ale môžete dosiahnuť konzolu, rollback je dva príkazy:",
"outro": "Ide o <em>rovnakú</em> operáciu, akú vykonáva menu, iba zadanú ručne. Ak sa <code>networking</code> stále nespustí, skontrolujte <code>journalctl -u networking -b</code> a zistite príčinu v syntaxi alebo ovládači."
},
"troubleshoot": {
"heading": "Riešenie problémov",
"noneTitle": "„Nenašli sa žiadne zálohy“ pri obnove",
"noneBody": "Adresár <code>/var/backups/proxmenux/</code> neexistuje alebo neobsahuje súbory <code>interfaces_backup_*</code>. Aspoň raz spustite <em>Vytvoriť zálohu siete</em> alebo opravu so sprievodcom, ktorá vytvorí zálohu automaticky. Overte to cez <code>ls /var/backups/proxmenux/</code>.",
"unreachTitle": "Reštart siete prejde, ale hostiteľ je stále nedosiahnuteľný",
"unreachBody": "Nová konfigurácia je nesprávna alebo nepriraďuje vašu IP adresu na správu. Obnovte predchádzajúci stav z konzoly (pozri vyššie). Potom použite <bridgeLink>analýzu mostov</bridgeLink> a <configLink>analýzu konfigurácie</configLink>, aby ste pred opätovným použitím pochopili príčinu.",
"emptyTitle": "Náhľad obnovy zobrazuje prázdny súbor",
"emptyBody": "Záložný súbor je prázdny (0 bajtov). Stane sa to, ak kopírovanie počas predchádzajúceho spustenia nepozorovane zlyhalo. Vyberte staršiu zálohu alebo znovu spustite <em>Vytvoriť zálohu siete</em>, ak je aktuálna konfigurácia funkčná."
},
"related": {
"heading": "Súvisiace",
"items": [
{
"label": "Analýza mostov a oprava so sprievodcom",
"href": "/docs/network/bridge-analysis",
"tail": " — Najbežnejší dôvod, prečo tu končí záloha."
},
{
"label": "Analýza konfigurácie a čistenie so sprievodcom",
"href": "/docs/network/config-analysis",
"tailRich": " — tiež automaticky zapisuje do <code>/var/backups/proxmenux/</code>."
},
{
"label": "Diagnostika",
"href": "/docs/network/diagnostics",
"tail": " — na overenie aktuálneho stavu po obnove."
}
]
}
}
@@ -0,0 +1,132 @@
{
"meta": {
"title": "Analýza mostov a oprava so sprievodcom | Dokumentácia ProxMenux",
"description": "Zistí mosty vmbrX s chýbajúcimi alebo neplatnými fyzickými portmi, typicky po opätovnom číslovaní PCI. Nahlási ich s návrhmi príkazov shellu a ponúkne opravu so sprievodcom v 5 krokoch s povinnou zálohou.",
"ogTitle": "Analýza mostov a oprava so sprievodcom | Dokumentácia ProxMenux",
"ogDescription": "Skontrolujte a opravte porty mostov Proxmox po zmenách hardvéru pomocou postupu so sprievodcom a bezpečným vrátením zmien."
},
"header": {
"title": "Analýza mostov a oprava so sprievodcom",
"description": "Skontroluje každý most vmbrX deklarovaný v /etc/network/interfaces, overí existenciu fyzických portov a pri chýbajúcich ponúkne opravu krok za krokom. Analýza je iba na čítanie; oprava vyžaduje súhlas, zobrazí náhľad a vytvorí zálohu.",
"section": "Sieť"
},
"intro": {
"title": "Čo to robí?",
"body": "Prečíta každý most v <code>/etc/network/interfaces</code>, skontroluje jeho riadok <code>bridge-ports</code> a overí, či každý deklarovaný port, napríklad <code>enp3s0</code>, existuje na hostiteľovi. Ak port chýba, navrhne náhradu a s výslovným súhlasom použije zmenu postupom <strong>záloha, náhľad, použitie, overenie</strong>."
},
"when": {
"heading": "Keď to potrebujete",
"intro": "Linux prideľuje predvídateľné názvy rozhraní podľa topológie PCI a poradia slotov. Viaceré udalosti ich môžu zmeniť, takže <code>/etc/network/interfaces</code> odkazuje na názvy, ktoré už neexistujú:",
"items": [
"Pridanie alebo odstránenie PCIe karty (NIC, GPU, a HBA, nosič NVMe).",
"Presun existujúcej karty na iný PCIe slot.",
"Aktualizácie BIOS / UEFI, ktoré znovu číslujú zariadenia PCI.",
"Migrácia zavádzacieho disku na iný hardvér."
],
"outro": "Po ďalšom štarte sa most pokúsi pripojiť k portu, ktorý už neexistuje, neaktivuje sa a hostiteľ stratí sieťové pripojenie. <link>Trvalé názvy rozhraní</link> zabránia opakovaniu tohto problému. Ak ste už stratili prístup, táto stránka opisuje postup obnovy."
},
"bigPicture": {
"heading": "Celkový prehľad",
"diagram1": {
"arrowLabel": "krok 1",
"nodes": {
"sourceLabel": "/etc/network/interfaces",
"sourceDetail": "auto vmbr0\niface vmbr0 inet static\n bridge-ports enp3s0",
"bridgeLabel": "Analyzovať (iba na čítanie)",
"bridgeDetail": "ip link show enp3s0\n→ neexistuje",
"targetLabel": "Správa + návrh",
"targetDetail": "❌ enp3s0: NENÁJDENÉ\nNahradiť za: eno1\n(zatiaľ bez zmien)"
}
},
"diagram2": {
"arrowLabel": "aplikovať so zálohou",
"nodes": {
"sourceLabel": "Oprava so sprievodcom",
"sourceDetail": "1. Záloha\n2. Zobraziť aktuálny stav\n3. Náhľad zmien\n4. Použiť\n5. Overiť",
"targetLabel": "/etc/network/interfaces (nový)",
"targetDetail": "auto vmbr0\niface vmbr0 inet static\n bridge-ports eno1"
}
}
},
"step1": {
"heading": "Krok 1: analýza (iba na čítanie)",
"intro": "Po výbere <strong>Analyzovať konfiguráciu mostov</strong> sa nástroj okamžite zastaví, ak hostiteľ nepoužíva klasický stack Debian/Proxmox. Inak prejde každý most a nahlási:",
"items": [
"Názov mosta, aktuálny stav (UP / DOWN) a pridelená IP adresa.",
"Každý deklarovaný port a či v súčasnosti existuje (<code>ip link show &lt;port&gt;</code>).",
"Pre každý neplatný port: navrhovaná náhrada (prvé dostupné fyzické rozhranie) plus presný <code>sed</code> príkaz na manuálne použitie.",
"Mosty bez riadka <code>bridge-ports</code> a osirelé položky <code>auto</code> bez zodpovedajúceho bloku <code>iface</code>."
],
"readonlyTitle": "Záruka režimu iba na čítanie",
"readonlyBody": "Až do tohto bodu skript nespustil žiadny príkaz meniaci systém. Analýzu môžete nechať otvorenú, skopírovať navrhnuté príkazy <code>sed</code> a použiť ich ručne, ak to uprednostňujete. Alebo prijmite nasledujúcu výzvu na spustenie opravy so sprievodcom."
},
"step2": {
"heading": "Krok 2: oprava so sprievodcom (5 krokov)",
"intro": "Spustí sa iba po prijatí výzvy na konci analýzy. Každý krok zobrazí plánovanú akciu a pred pokračovaním vyžiada potvrdenie.",
"steps": [
{
"title": "1. Bezpečnostná záloha",
"body": "Skopíruje <code>/etc/network/interfaces</code> do <code>/var/backups/proxmenux/interfaces_backup_&lt;TIMESTAMP&gt;</code>. Presnú cestu zálohy zobrazí pred kopírovaním aj po ňom spolu s príkazom na vrátenie zmien.",
"tone": "blue"
},
{
"title": "2. Preskúmanie aktuálnej konfigurácie",
"body": "Otvorí aktuálny <code>/etc/network/interfaces</code> v posúvateľnom dialógu, aby ste presne videli, čo sa zmení.",
"tone": "blue"
},
{
"title": "3. Náhľad navrhovaných zmien",
"body": "Presne vypíše dotknuté mosty a plánované náhrady portov. Ak už oprava nie je potrebná, pretože sa port medzi kontrolami znovu objavil, postup sa ukončí hlásením <em>„Nie sú potrebné žiadne zmeny.“</em>",
"tone": "blue"
},
{
"title": "4. Použiť zmeny",
"body": "Pre každý postihnutý most beží <code>sed -i \"/iface $bridge/,/bridge-ports/ s/bridge-ports.*/bridge-ports $new_ports/\"</code> proti <code>/etc/network/interfaces</code>. Ak most nemal k dispozícii platnú náhradu, substitúcia sa preskočí a zaznamená v kroku 5.",
"tone": "amber"
},
{
"title": "5. Overovanie",
"body": "Znovu prečíta súbor a potvrdí, že nový port každého mosta existuje. Vypíše príkaz na vrátenie zmien (<code>cp &lt;backup&gt; /etc/network/interfaces</code>). Nakoniec ponúkne <strong>Reštartovať sieť</strong> — prijmite iba vtedy, ak máte náhradný prístup cez konzolu.",
"tone": "emerald"
}
],
"restartTitle": "Reštart siete ≠ bezpečné vrátenie zmien",
"restartBody": "Oprava sa zapíše na disk bez ohľadu na reštart služby. <code>systemctl restart networking</code> použije zmenu <em>teraz</em>, čo môže prerušiť reláciu SSH, ak je nový port nesprávny. Ak reštart odmietnete, zmena sa aj tak prejaví pri ďalšom štarte. Najprv overte novú konfiguráciu alebo ju vráťte zobrazeným príkazom."
},
"edits": {
"heading": "Čo sa edituje (presne)",
"body": "Iba riadok <code>bridge-ports</code> každého dotknutého mosta. Ostatné direktívy (<code>address</code>, <code>netmask</code>, <code>gateway</code>, <code>bridge-stp</code>, …) zostávajú nezmenené. Skript v tomto postupe nevytvára ani neodstraňuje bloky <code>iface</code> — to je úloha <link>analýzy konfigurácie &amp; čistenia</link>."
},
"troubleshoot": {
"heading": "Riešenie problémov",
"unsupportedTitle": "Analýza sa zastaví s hlásením „Nepodporovaný sieťový stack“",
"unsupportedBody": "Hostiteľ používa netplan, systemd-networkd alebo NetworkManager. Nástroj podporuje iba <code>/etc/network/interfaces</code>. Najprv prepnite hostiteľa na klasický stack alebo upravte konfiguráciu natívnymi nástrojmi správcu (napríklad <code>netplan apply</code>).",
"noSuggestTitle": "Pre neplatný port sa nevypíše žiadny návrh",
"noSuggestBody": "Hostiteľ nemá žiadne voľné fyzické rozhrania: všetky sú už v inom moste alebo neexistujú. Analýza preto navrhne <code>bridge-ports none</code>, aby sa most mohol aspoň aktivovať bez portu. Pred opätovným spustením pridajte sieťovú kartu alebo ručne presuňte porty medzi mostmi.",
"stillDownTitle": "Oprava sa skončila, ale most je stále dole",
"stillDownBody": "<code>sed</code> aktualizoval súbor, ale <code>systemctl restart networking</code> bol odmietnutý. Po overení novej konfigurácie ho spustite ručne alebo reštartujte systém. Ak bol reštart prijatý a most je stále DOWN, overte existenciu nového portu cez <code>ip link show</code> a skontrolujte <code>journalctl -u networking</code> pre skutočnú chybu: odpojený kábel, nevyjednané spojenie alebo port už patriaci do iného mosta.",
"lostSshTitle": "Stratila som prístup SSH hneď po reštarte siete",
"lostSshIntro": "Použite konzolu / IPMI / iKVM na dosiahnutie hostiteľa. Obnoviť zálohu:",
"lostSshOutro": "Potom znovu spustite analýzu z konzoly a zistite, prečo návrh nefungoval, typicky preto, že náhradný port nie je zapojený."
},
"related": {
"heading": "Súvisiace",
"items": [
{
"label": "Trvalé názvy rozhraní",
"href": "/docs/network/persistent-names",
"tail": " — priradí názvy k MAC adresám, aby sa problém neopakoval."
},
{
"label": "Analýza konfigurácie a čistenie so sprievodcom",
"href": "/docs/network/config-analysis",
"tailRich": " — Pre osirotené <code>iface</code> bloky (druhá polovica rovnakého problému)."
},
{
"label": "Záloha a reštart rozhraní",
"href": "/docs/network/backup-restore",
"tail": " — ručné snímky a prehliadanie záloh na obnovu."
}
]
}
}
@@ -0,0 +1,122 @@
{
"meta": {
"title": "Analýza konfigurácie a čistenie so sprievodcom | Dokumentácia ProxMenux",
"description": "Zistí bloky iface v /etc/network/interfaces odkazujúce na fyzické sieťové karty, ktoré už nie sú na hostiteľovi. Nahlási ich a ponúkne odstránenie so sprievodcom v 5 krokoch s povinnou zálohou a náhľadom každého bloku.",
"ogTitle": "Analýza konfigurácie a čistenie so sprievodcom | Dokumentácia ProxMenux",
"ogDescription": "Nájdite a odstráňte osirelé bloky rozhraní, ktoré zostali po zmenách hardvéru, s úplným náhľadom a možnosťou vrátenia zmien."
},
"header": {
"title": "Analýza konfigurácie a čistenie so sprievodcom",
"description": "Prejde každý blok iface v /etc/network/interfaces a overí, či príslušná fyzická sieťová karta stále existuje. Nahlási osirelé bloky po zmenách hardvéru a ponúkne odstránenie so sprievodcom, zálohou, náhľadom a potvrdením každého bloku.",
"section": "Sieť"
},
"intro": {
"title": "Čo to robí?",
"body": "Identifikuje deklarácie <code>iface</code>, ktorých sieťová karta už nie je na hostiteľovi, typicky po výmene alebo odobratí karty. Potom ponúkne čistenie so sprievodcom, ktoré odstráni <em>iba</em> osirelé bloky, so zálohou, náhľadom každej sekcie a výslovným záverečným potvrdením."
},
"differs": {
"heading": "Ako sa líši od analýzy mosta",
"headerAspect": "Aspekt",
"headerBridge": "Analýza mosta",
"headerConfig": "Analýza konfigurácie",
"rows": [
{
"aspect": "Pozerá sa na",
"bridge": "Mosty (<code>vmbrX</code>) a ich riadok <code>bridge-ports</code>",
"config": "Každý blok <code>iface</code> okrem loopbacku, mostov a bondov"
},
{
"aspect": "Zisťuje",
"bridge": "Mosty odkazujúce na neexistujúci port",
"config": "Samostatné bloky rozhrania pre NIC, ktoré neexistujú"
},
{
"aspect": "Oprava",
"bridge": "Nahrádza názov portu v <code>bridge-ports</code>",
"config": "Odstráni celý blok <code>iface</code>"
},
{
"aspect": "Nezahŕňa",
"bridge": "Nič, každý most je analyzovaný",
"config": "Mosty (<code>vmbrX</code>) a bondy (<code>bondX</code>) sa vždy zachovajú, pretože sú virtuálne a ich neprítomnosť počas štartu môže byť normálna"
}
],
"outro": "V praxi často použijete oba nástroje v tomto poradí: najprv <strong>analýzu konfigurácie</strong> na odstránenie osirelých blokov, potom <link>analýzu mostov</link> na nové priradenie mostov, ktoré používali odstránené rozhranie."
},
"step1": {
"heading": "Krok 1: analýza (iba na čítanie)",
"intro": "Okamžite sa zastaví, ak hostiteľ nepoužíva klasický sieťový stack. Inak zobrazí všetky nakonfigurované rozhrania okrem loopbacku a ich stav:",
"virtTitle": "Virtuálne rozhrania sú chránené",
"virtBody": "Mosty (<code>vmbrX</code>) a bondy (<code>bondX</code>) sú virtuálne konštrukcie. Pri kontrole môžu oprávnene chýbať, napríklad most bez portov. Analýza preto nikdy nenavrhuje ich odstránenie, iba odstránenie fyzických sieťových kariet."
},
"step2": {
"heading": "Krok 2: čistenie so sprievodcom (5 krokov)",
"intro": "Spustí sa iba po prijatí výzvy na konci analýzy. Každý krok vyžaduje potvrdenie; zrušením v ktoromkoľvek bode sa postup ukončí bez zápisu.",
"steps": [
{
"title": "1. Bezpečnostná záloha",
"body": "Skopíruje <code>/etc/network/interfaces</code> do <code>/var/backups/proxmenux/interfaces_backup_&lt;TIMESTAMP&gt;</code>. Cestu zobrazí pred kopírovaním aj po ňom.",
"tone": "blue"
},
{
"title": "2. Potvrdenie zoznamu odstránenia",
"body": "Presne vypíše bloky fyzických rozhraní určené na odstránenie. Ak sa karty medzi analýzou a čistením znovu objavia, napríklad po opätovnom zasunutí, postup sa ukončí hlásením <em>„Čistenie nie je potrebné.“</em>",
"tone": "blue"
},
{
"title": "3. Náhľad presných blokov",
"body": "Otvorí rolovací pohľad na každý blok <code>iface</code>, ktorý by bol vymazaný, doslovne zo súboru. Toto je chvíľa, kedy si môžete všimnúť napríklad zaujímavý <code>up</code> hák, ktorý chcete zachovať.",
"tone": "blue"
},
{
"title": "4. Použiť odstránenie",
"body": "Pre každé sirotské rozhranie beží <code>sed -i \"/^iface $iface/,/^$/d\" /etc/network/interfaces</code>. To odstráni zo zodpovedajúcej línie <code>iface</code> až do ďalšieho prázdneho riadku.",
"tone": "amber"
},
{
"title": "5. Overovanie",
"body": "Opätovne načíta súbor, vypíše, čo bolo odstránené, a znova skontroluje zostávajúce rozhrania. Vytlačí príkaz na vrátenie. <strong>nereštartuje</strong> automaticky sieť – odstránenie nepoužívaného bloku je bezpečné použiť pri ďalšom reštarte a nedotýka sa aktívneho stavu.",
"tone": "emerald"
}
],
"noRestartTitle": "Nereštartuje sieť automaticky",
"noRestartBody": "Na rozdiel od opravy mostov čistenie neponúka reštart služby. Odstránenie nepoužívaného bloku rozhrania okamžite neovplyvní bežiacu konfiguráciu, takže reštart nie je potrebný a zbytočne by ohrozil pripojenie. Zmena sa prejaví pri ďalšom ručnom <code>systemctl restart networking</code> alebo pri ďalšom reštarte systému."
},
"caveats": {
"heading": "Dôležité upozornenia",
"boundaryTitle": "Hranica bloku je prvý prázdny riadok",
"boundaryBody": "Vzor <code>sed</code> odstráni obsah od <code>iface &lt;name&gt;</code> po ďalší prázdny riadok. Ak v <code>/etc/network/interfaces</code> chýbajú prázdne riadky medzi blokmi, čo je zriedkavé, ale možné po ručných úpravách, môže sa odstrániť aj nasledujúci blok. Preto je <strong>krok 3 povinný</strong>: pred potvrdením skontrolujte náhľad.",
"tandemTitle": "Osirelý blok iface používaný mostom sa zistí tu, nie pri analýze mostov",
"tandemBody": "Ak <code>vmbr0</code> deklaruje <code>bridge-ports enp3s0</code> a <code>enp3s0</code> má aj vlastný blok <code>iface enp3s0 inet manual</code>, odstránenie <code>enp3s0</code> tu ponechá neplatný odkaz v <code>vmbr0</code>. Po čistení spustite <link>analýzu mostov</link> na zmenu priradenia alebo odstránenie portu mosta. Oba postupy sú navrhnuté na spoločné použitie."
},
"troubleshoot": {
"heading": "Riešenie problémov",
"notFoundTitle": "Analýza zobrazuje moju novú sieťovú kartu ako „NENÁJDENÁ“",
"notFoundBody": "Jadro vidí zariadenie pod iným názvom, než je v súbore. Spustite <code>ip link show</code> a zistite skutočný názov. Presne v takomto prípade by <link>trvalé názvy rozhraní</link> zabránili problému v budúcnosti.",
"tooMuchTitle": "Čistenie odstránilo príliš veľa, aj blok, ktorý som chcel zachovať",
"tooMuchBody": "Obnovte stav zo zálohy uvedenej v kroku 5:",
"tooMuchOutro": "Pred opätovným spustením čistenia ručne upravte súbor a pridajte prázdny riadok medzi bloky alebo problematický blok odstráňte ručne.",
"bridgeBreakTitle": "Most prestane pracovať po vyčistení.",
"bridgeBreakBody": "Most používal port, ktorého blok <code>iface</code> sa práve odstránil. Spustite <link>analýzu mostov</link> a návrh priradí most k existujúcemu fyzickému rozhraniu."
},
"related": {
"heading": "Súvisiace",
"items": [
{
"label": "Analýza mostov a oprava so sprievodcom",
"href": "/docs/network/bridge-analysis",
"tail": " — prirodzený ďalší krok po čistení."
},
{
"label": "Trvalé názvy rozhraní",
"href": "/docs/network/persistent-names",
"tail": " — zabraňuje hromadeniu osirelých blokov po každej zmene hardvéru."
},
{
"label": "Záloha a reštart rozhraní",
"href": "/docs/network/backup-restore",
"tail": " — ručné snímky a prehliadanie záloh na obnovu."
}
]
}
}
@@ -0,0 +1,94 @@
{
"meta": {
"title": "Diagnostika | Dokumentácia ProxMenux",
"description": "Tri jednorazové diagnostické kontroly iba na čítanie: Zobraziť smerovaciu tabuľku, Test pripojenia a Pokročilá diagnostika. Iba kontrola — nikdy nezapisuje do /etc/network/interfaces ani nespúšťa príkazy meniace systém, s jedinou výslovnou výnimkou: úplné odstránenie zisteného NetworkManager vyžaduje váš súhlas.",
"ogTitle": "Diagnostika | Dokumentácia ProxMenux",
"ogDescription": "Sieťová diagnostika iba na čítanie pre hostiteľa Proxmoxu: smerovanie, dosiahnuteľnosť, pokročilé štatistiky."
},
"header": {
"title": "Diagnostika",
"description": "Tri jednorazové kontroly aktuálneho stavu siete iba na čítanie: smerovacia tabuľka, test pripojenia a pokročilé štatistiky. Žiadna nezapisuje do /etc/network/interfaces — bezpečné použitie kedykoľvek, aj cez SSH. Pre interaktívne sledovanie v reálnom čase pozrite Nástroje na sledovanie v reálnom čase.",
"section": "Sieť"
},
"intro": {
"title": "Čo to robí?",
"body": "Zobrazuje informácie o smerovaní, dosiahnuteľnosti a súhrnných štatistikách <strong>bez akýchkoľvek zmien</strong>. Overte ním správne fungovanie siete alebo odhaľte duplicitné IP adresy. Na nepretržité sledovanie prevádzky pozrite <monitoringLink>Nástroje na sledovanie v reálnom čase</monitoringLink>; na zobrazenie nespracovaného konfiguračného súboru pozrite <backupLink>Záloha a reštart rozhraní</backupLink>."
},
"routing": {
"heading": "Zobraziť smerovaciu tabuľku",
"body": "Zobrazí všetky trasy aktuálne používané jadrom (<code>ip route show</code>) a zvýrazní predvolenú bránu. Umožňuje overiť, že prevádzka do internetu odchádza očakávaným rozhraním a žiadne zvyšné trasy nemajú prednosť."
},
"connectivity": {
"heading": "Otestovať pripojenie",
"intro": "Postupne odošle na každý z troch cieľov dve sondy ICMP a vypíše výsledky. Potom spustí <code>nslookup google.com</code> na overenie prekladu DNS nezávisle od ICMP.",
"headerTest": "Skúška",
"headerTarget": "Cieľ",
"headerConfirms": "Čo potvrdzuje",
"rows": [
{
"test": "Google DNS",
"target": "8.8.8.8",
"confirms": "Externá dosiahnuteľnosť cez známu IP adresu anycast"
},
{
"test": "Cloudflare DNS",
"target": "1.1.1.1",
"confirms": "Nezávislé druhé stanovisko, ak Google blokuje ICMP"
},
{
"test": "Brána",
"target": "(štandardná trasa)",
"confirms": "L2 / L3 pripojenie k miestnemu routeru"
},
{
"test": "Preklad DNS",
"target": "google.com",
"confirms": "DNS server je dosiahnuteľný a odpovedá"
}
],
"readingTitle": "Čítanie výsledku",
"readingBody": "Ak test brány prejde, ale verejné servery DNS neodpovedajú, máte lokálne pripojenie, no nemáte internet — skontrolujte pripojenie brány smerom k poskytovateľovi. Ak preklad DNS zlyhá, ale ping na <code>8.8.8.8</code> funguje, problém je v resolveri, nie v sieti: skontrolujte <code>/etc/resolv.conf</code>."
},
"advanced": {
"heading": "Pokročilá diagnostika",
"intro": "Zhromažďuje štatistiky celej siete a vykonáva sériu kontrol bežných problémov. Hlási počet aktívnych pripojení, načúvajúce porty a celkový počet rozhraní a výslovne upozorňuje na dve nevhodné konfigurácie:",
"items": [
"<strong>NetworkManager beží na hostiteľovi Proxmox.</strong> NetworkManager a <code>ifupdown</code> systému Proxmox sú v konflikte: oba sa pokúšajú spravovať rozhrania, takže mosty opakovane menia stav alebo sa nedajú aktivovať. Ak sa zistí NetworkManager, nástroj ponúkne interaktívne potvrdenie jeho zastavenia, zakázania a úplného odstránenia (ide o <em>jedinú</em> diagnostiku, ktorá môže meniť systém, a to iba po výslovnom súhlase).",
"<strong>Duplicitné IP adresy na rôznych rozhraniach.</strong> Dve rozhrania s rovnakou IPv4 adresou spôsobujú občasné výpadky pripojenia, ktoré sa zvnútra VM veľmi ťažko diagnostikujú. Zisťujú sa cez <code>ip -4 addr show | sort | uniq -d</code>."
],
"nmTitle": "Výzva pre NetworkManager je tu jedinou akciou, ktorá môže meniť systém",
"nmBody": "Všetky ostatné kontroly pokročilej diagnostiky sú iba na čítanie. Odstránenie NetworkManager vyžaduje potvrdenie áno/nie a spustí <code>systemctl stop / disable</code> + <code>apt-get purge -y network-manager</code>. Ak odmietnete, nič sa nezmení."
},
"troubleshoot": {
"heading": "Riešenie problémov",
"gwTitle": "Test pripojenia hlási zlyhanie brány, ale hostiteľ má prístup na internet",
"gwBody": "Niektoré smerovače neodpovedajú na ICMP na internom rozhraní, aj keď správne preposielajú prevádzku. V konzole skúste <code>traceroute 8.8.8.8</code>: ak je druhým skokom váš poskytovateľ a test verejného DNS prešiel, brána funguje aj napriek neúspešnému pingu.",
"dupTitle": "Pokročilá diagnostika stále hlási duplicitné IP adresy aj po odstránení jednej z nich",
"dupBody": "Kontrola skúma aktuálny stav jadra, nie konfiguračný súbor. Overte ho príkazom <code>ip -4 addr show</code>; ak je duplicitná adresa stále prítomná, niektoré rozhranie ju stále používa. Pomocou <code>ip addr del &lt;IP&gt;/&lt;mask&gt; dev &lt;iface&gt;</code> ju odstráňte z aktuálneho stavu a potom upravte <code>/etc/network/interfaces</code>, ak je nastavená aj natrvalo."
},
"related": {
"heading": "Súvisiace",
"items": [
{
"label": "Nástroje na sledovanie v reálnom čase",
"href": "/docs/network/monitoring",
"tail": " — Interaktívne iftop / iptraf-ng / iperf3 spúšťače."
},
{
"label": "Analýza mostov a oprava so sprievodcom",
"href": "/docs/network/bridge-analysis",
"tail": " — Keď vmbrX chýba fyzický port."
},
{
"label": "Analýza konfigurácie a čistenie so sprievodcom",
"href": "/docs/network/config-analysis",
"tail": " — keď je stará sieťová karta stále deklarovaná, ale už nie je prítomná."
},
{
"label": "Záloha a reštart rozhraní",
"href": "/docs/network/backup-restore",
"tail": " — na vytvorenie snímky konfigurácie pred každou zmenou."
}
]
}
}
+107
View File
@@ -0,0 +1,107 @@
{
"meta": {
"title": "Správa siete Proxmox — Mosty, bondy, diagnostika, oprava | ProxMenux",
"description": "Diagnostika iba na čítanie, analýzy s následnými návrhmi a opravy so sprievodcom pre sieťový stack Debian / Proxmox (/etc/network/interfaces). Skontrolujte mosty a bondy, spustite nástroje na sledovanie v reálnom čase, nastavte trvalé názvy rozhraní, zálohujte konfiguráciu a bezpečne reštartujte sieť — s povinnými zálohami a náhľadmi jednotlivých krokov.",
"ogTitle": "Správa siete Proxmox — Mosty, bondy, diagnostika, oprava",
"ogDescription": "Diagnostika, analýza a opravy sieťového stacku Proxmox so sprievodcom, povinnými zálohami a náhľadmi jednotlivých krokov.",
"twitterTitle": "Správa siete Proxmox | ProxMenux",
"twitterDescription": "Mosty, bondy, diagnostika a opravy sieťového stacku Proxmox so sprievodcom a povinnými zálohami."
},
"header": {
"title": "Správa siete",
"description": "Diagnostika iba na čítanie, analytické správy s následnými návrhmi a opravy so sprievodcom pre klasický sieťový stack Debian/Proxmox. Každý deštruktívny postup najprv vytvorí zálohu a pred použitím zobrazí presné zmeny.",
"section": "Sieť"
},
"intro": {
"title": "Na čo je toto menu",
"body": "Skontrolujte, diagnostikujte a v prípade potreby opravte sieťovú konfiguráciu hostiteľa Proxmox bez straty vzdialeného prístupu. Nástroje sa riadia jednou zásadou: <strong>najprv prečítať, potom navrhnúť a zmeny použiť iba s výslovným súhlasom a bezpečnostnou zálohou</strong>. Tlačidlo „Automaticky opraviť všetko“ neexistuje."
},
"openingMenu": {
"heading": "Otvorenie menu",
"intro": "V hlavnom menu ProxMenux vyberte <strong>Sieť</strong>. Zobrazí sa toto:",
"imageAlt": "Menu Správa siete s možnosťami diagnostiky, sledovania, analýzy, opráv, trvalých názvov a zálohovania"
},
"safety": {
"heading": "Bezpečnostný model",
"body": "Úprava sieťovej konfigurácie vzdialeného hostiteľa Proxmox je jedným z najjednoduchších spôsobov, ako stratiť prístup. ProxMenux to zohľadňuje pri každej akcii. Nástroje sú rozdelené do troch úrovní správania — vyberte kartu, ktorá zodpovedá vášmu zámeru:"
},
"tiers": {
"readOnly": {
"title": "Iba na čítanie",
"body": "Iba kontrola. Za žiadnych okolností nemôže meniť systém.",
"items": [
"Smerovacia tabuľka, testy pripojenia, pokročilé štatistiky",
"Sledovanie sieťovej prevádzky v reálnom čase (iftop, iptraf-ng)",
"Test priepustnosti (iperf3)"
]
},
"analyze": {
"title": "Analyzovať, potom navrhnúť",
"body": "Zistí problémy, vypíše správu s navrhovanými príkazmi shellu a zastaví sa. Sami sa rozhodnete, či potom spustíte opravu so sprievodcom.",
"items": [
"Analýza konfigurácie mosta",
"Analýza konfigurácie siete"
]
},
"apply": {
"title": "Aplikovať so zálohou",
"body": "Mení systém. Vždy najprv vytvorí zálohu dotknutého súboru s časovou pečiatkou a pred zápisom zobrazí náhľad.",
"items": [
"Trvalé názvy rozhraní (súbory .link)",
"Ručné zálohovanie, obnovenie a reštart služby"
]
}
},
"classicTitle": "Iba klasický sieťový stack",
"classicBody": "Každá funkcia analýzy a opravy pred zásahom skontroluje aktívneho správcu siete. Ak hostiteľ používa <strong>netplan</strong>, <strong>systemd-networkd</strong> alebo <strong>NetworkManager</strong>, nástroj sa ihneď zastaví s jasným hlásením. Menu podporuje iba klasickú sieťovú konfiguráciu Debian/Proxmox v <code>/etc/network/interfaces</code>. Je to zámerné: úprava súboru netplan podľa pravidiel pre <code>ifupdown</code> by mohla konfiguráciu nepozorovane poškodiť.",
"backups": {
"heading": "Kam sa ukladajú zálohy",
"intro": "Každá oprava so sprievodcom, obnova alebo ručné zálohovanie zapíše kópiu <code>/etc/network/interfaces</code> s časovou pečiatkou do <code>/var/backups/proxmenux/</code>:",
"rollbackIntro": "Na ručné obnovenie predchádzajúceho stavu z konzoly:"
},
"readOnlySection": {
"heading": "Kontrola len na čítanie",
"body": "Východiskový bod, keď niečo nefunguje správne. Iba kontrola — nikdy nezapisuje do <code>/etc/network/interfaces</code> ani nespúšťa príkazy meniace systém, s jedinou výslovnou výnimkou: úplné odstránenie zisteného NetworkManager vyžaduje váš súhlas. Bezpečné použitie cez SSH kedykoľvek.",
"options": [
{
"title": "Diagnostika",
"description": "Tri jednorazové kontroly iba na čítanie: Zobraziť smerovaciu tabuľku, Test pripojenia a Pokročilá diagnostika. Iba kontrola — nikdy nezapisuje do systému."
},
{
"title": "Nástroje na sledovanie v reálnom čase",
"description": "Tri interaktívne spúšťače: iftop (šírka pásma v reálnom čase pre každú dvojicu hostiteľov), iptraf-ng (sledovanie prevádzky vo viacerých režimoch) a iperf3 (test šírky pásma, režim server / klient)."
}
]
},
"analyzeSection": {
"heading": "Analyzovať, potom navrhnúť",
"body": "Používajú sa, keď kontrola alebo skutočný výpadok poukazuje na problém konfigurácie. Každý nástroj prejde príslušnú časť <code>/etc/network/interfaces</code>, vypíše podrobnú správu s presným príkazom shellu na opravu každého zistenia a <strong>zastaví sa</strong>. Ak potom prijmete voliteľnú opravu so sprievodcom, pred každou zmenou sa vytvorí záloha a zmena sa zobrazí pred zápisom.",
"options": [
{
"title": "Analýza mostov a oprava so sprievodcom",
"description": "Zistí mosty vmbrX s chýbajúcimi alebo neplatnými portmi, typicky po opätovnom číslovaní zariadení PCI. Najprv zobrazí správu a opravu vykoná iba po prijatí postupu so sprievodcom v 5 krokoch."
},
{
"title": "Analýza konfigurácie a čistenie so sprievodcom",
"description": "Nájde fyzické rozhrania deklarované v /etc/network/interfaces, ktoré už neexistujú — osirelé konfigurácie po zmenách hardvéru. Nahlási ich a ponúkne odstránenie so sprievodcom."
}
]
},
"applySection": {
"heading": "Aplikovať so zálohou",
"body": "Tieto nástroje zo svojej podstaty zapisujú na disk. Každý pred zápisom vytvorí zálohu dotknutého súboru s časovou pečiatkou. Deštruktívne možnosti, ako obnova a reštart, vyžadujú výslovné potvrdenie áno/nie. <em>Trvalé názvy rozhraní</em> sa prejavia až pri ďalšom reštarte, nie okamžite, takže ich nastavenie možno bezpečne naplánovať aj na vzdialenom hostiteľovi.",
"options": [
{
"title": "Trvalé názvy rozhraní",
"description": "Priradí názvy rozhraní (eno1, enp3s0, …) k MAC adresám pomocou súborov .link služby systemd. Názvy zostanú zachované pri zmene slotov PCI, aktualizáciách jadra aj pridávaní alebo odoberaní iných sieťových kariet."
},
{
"title": "Záloha a reštart rozhraní",
"description": "Ručné vytvorenie snímky /etc/network/interfaces, prehliadanie a obnova predchádzajúcich záloh, zobrazenie aktuálnej konfigurácie a reštart sieťovej služby podľa potreby."
}
]
},
"consoleTitle": "Pripravte si prístup ku konzole",
"consoleSubTitle": "Pred akoukoľvek opravou na vzdialenom hostiteľovi",
"consoleBody": "Ak ste pripojení cez SSH a máte iba jednu cestu k hostiteľovi, pred zmenami siete si pripravte náhradný prístup: fyzickú konzolu / IPMI / iKVM alebo iný počítač v rovnakej LAN. Opravy so sprievodcom sú bezpečné a vždy ponúkajú príkaz na vrátenie zmien, ale nesprávne nakonfigurovaný most alebo prerušené spojenie vás aj tak môže pripraviť o prístup, kým sa nedostanete ku konzole."
}
@@ -0,0 +1,136 @@
{
"meta": {
"title": "Nástroje na sledovanie v reálnom čase | Dokumentácia ProxMenux",
"description": "Tri interaktívne spúšťače nástrojov na sledovanie siete: iftop (šírka pásma v reálnom čase pre každú dvojicu hostiteľov), iptraf-ng (sledovanie prevádzky vo viacerých režimoch) a iperf3 (test šírky pásma, režim server / klient). Každý sa nainštaluje pri prvom použití.",
"ogTitle": "Nástroje na sledovanie v reálnom čase | Dokumentácia ProxMenux",
"ogDescription": "Interaktívne monitorovanie siete a testovanie šírky pásma pre Proxmox host: iftop, iptraf-ng, iperf3."
},
"header": {
"title": "Nástroje na sledovanie v reálnom čase",
"description": "Tri interaktívne spúšťače na sledovanie siete v reálnom čase a meranie šírky pásma: iftop, iptraf-ng a iperf3. Každý nástroj sa pri prvom použití automaticky nainštaluje cez apt, beží v popredí a ukončuje sa uvedeným klávesom. Nemenia sieťovú konfiguráciu hostiteľa; iperf3 generuje testovaciu prevádzku.",
"section": "Sieť"
},
"intro": {
"title": "Čo to robí?",
"body": "Tri interaktívne monitorovacie nástroje, každý za vlastným vstupom do menu. Pri prvom spustení jedného sa balík inštaluje ticho cez <code>apt-get</code>. Následné štarty začínajú okamžite. Žiadny z týchto nástrojov nemení konfiguráciu hostiteľskej siete."
},
"when": {
"heading": "Kedy použiť ktorý",
"headerQuestion": "Otázka",
"headerUse": "Použitie",
"rows": [
{
"question": "Kto vyťažuje spojenie <em>práve teraz</em>?",
"use": "iftop"
},
{
"question": "Aké členenie protokolu / veľkosti paketov / toky TCP prúdia?",
"use": "iptraf-ng"
},
{
"question": "Koľko šírky pásma je skutočne k dispozícii medzi dvoma hostiteľmi?",
"use": "iperf3"
}
]
},
"iftop": {
"heading": "Sieťová prevádzka v reálnom čase (iftop)",
"body": "Šírka pásma v reálnom čase pre dvojice hostiteľov (zdroj ↔ cieľ) — ako <code>top</code> pre sieťovú prevádzku. Najväčšie toky zobrazuje navrchu s kĺzavými priemermi za 2/10/40 sekúnd. Najlepší nástroj na otázku <em>„Prečo je moje odchádzajúce spojenie vyťažené?“</em>.",
"exit": "<strong>Ukončenie:</strong> stlačte <kbd>q</kbd>. ProxMenux pred spustením zobrazí pripomenutie.",
"keysTitle": "Užitočné klávesy v iftop",
"keysBody": "<kbd>n</kbd> prepína vyhľadávanie DNS, <kbd>p</kbd> zobrazuje čísla portov, <kbd>P</kbd> pozastaví zobrazenie, <kbd>t</kbd> prepína smer riadku (odoslané / prijaté / oboje), <kbd>1</kbd>/<kbd>2</kbd>/<kbd>3</kbd> zoradí podľa priemeru za 2 s / 10 s / 40 s. Úplný zoznam nájdete v <code>man iftop</code>."
},
"iptraf": {
"heading": "Nástroj na sledovanie siete (iptraf-ng)",
"intro": "Nástroj na sledovanie prevádzky vo viacerých režimoch, ovládaný cez menu. iftop odpovedá na <em>„kto“</em>, iptraf-ng na <em>„čo“</em>: počty bajtov a paketov podľa protokolu, sledovanie stavu spojení TCP, histogramy veľkosti paketov a aktivita LAN podľa stanice.",
"menuIntro": "Pri spustení dostanete ponuku piatich možností:",
"headerMode": "Režim",
"headerUseFor": "Použiť pre",
"rows": [
{
"mode": "Monitor prevádzky IP",
"useFor": "Zoznam tokov TCP / UDP / ICMP / iných protokolov IP v reálnom čase s počítadlami bajtov a stavom pripojenia"
},
{
"mode": "Všeobecné štatistiky rozhraní",
"useFor": "Súhrnný počet paketov IPv4 / IPv6 / TCP / UDP / ICMP / non-IP paketov na sieťovú kartu"
},
{
"mode": "Podrobné štatistiky rozhrania",
"useFor": "Rovnaké ako vyššie, ale pre jedno rozhranie, s podrobnosťami o veľkosti a rýchlosti paketov"
},
{
"mode": "Štatistické členenia",
"useFor": "Histogram rozdelenia veľkosti paketov podľa portu TCP / UDP"
},
{
"mode": "Monitor stanice LAN",
"useFor": "Štatistiky prevádzky podľa MAC adresy pre lokálnu broadcastovú doménu"
}
],
"exit": "<strong>Ukončenie:</strong> stlačte <kbd>x</kbd> v ľubovoľnom zobrazení alebo <kbd>Q</kbd> v hlavnom menu. ProxMenux pred spustením zobrazí pripomenutie.",
"logTitle": "Zaznamenávanie zachytených údajov do súboru",
"logBody": "Každý režim ponúka zápis zachytených štatistík do <code>/var/log/iptraf-ng/</code>. Ak potrebujete záznam špičky prevádzky, nechajte nástroj bežať, zapisujte do súboru a skontrolujte ho neskôr namiesto sledovania obrazovky v reálnom čase."
},
"iperf3": {
"heading": "Test priepustnosti (iperf3)",
"intro1": "Meria skutočnú priepustnosť TCP medzi dvoma hostiteľmi. Na rozdiel od iftop / iptraf-ng, ktoré sledujú existujúcu prevádzku, iperf3 generuje syntetickú prevádzku na záťažový test spojenia. Nevyhnutné pri otázkach ako <em>„Dosahuje moje 10 GbE skutočne 10 GbE?“</em> alebo <em>„Je úzkym miestom sieťová karta, prepínač alebo úložisko?“</em>.",
"intro2": "iperf3 je <strong>nástroj pre dvoch hostiteľov</strong>: jeden beží ako server a načúva na porte TCP 5201, druhý ako klient, ktorý sa pripojí, odošle údaje a vypíše rýchlosť. Spúšťač ProxMenux sa opýta na požadovaný režim:",
"headerMode": "Režim",
"headerBehaviour": "Správanie",
"headerCli": "Ekvivalentný príkaz CLI",
"rows": [
{
"mode": "Server",
"behaviour": "Načúva na porte TCP 5201 a vypíše výsledky každého prichádzajúceho testu. Ukončí sa cez Ctrl+C.",
"cli": "iperf3 -s"
},
{
"mode": "Klient",
"behaviour": "Vyžiada IP adresu alebo názov servera, pripojí sa, spustí predvolený 10-sekundový test a vypíše správu.",
"cli": "iperf3 -c <target>"
}
],
"workflowIntro": "Typický pracovný postup na testovanie 10 GbE spojenia medzi dvoma hostiteľmi Proxmox:",
"workflow": [
"Na hostiteľovi A otvorte menu Sieť → <em>Test priepustnosti (iperf3)</em> → vyberte <strong>Server</strong>.",
"Na hostiteľovi B otvorte rovnakú položku ponuky → vyberte <strong>Klient</strong> → zadajte IP hostiteľa A.",
"Počkajte 10 sekúnd. Porovnajte nameranú rýchlosť s teoretickým maximom spojenia."
],
"sample": "Vzorový výstup klienta:",
"flagsTitle": "Užitočné voľby pri ručnom spustení zo shellu",
"flagsBody": "<code>-t 60</code> dlhší test (60 s namiesto 10 s), <code>-P 4</code> 4 paralelné toky (rýchlejšie vyťažia spojenie), <code>-R</code> opačný smer (server → klient), <code>-u -b 100M</code> test UDP pri 100 Mbit/s (meranie kolísania oneskorenia a straty paketov), <code>-p 5202</code> iný port (viac testov súčasne). Úplný zoznam nájdete v <code>man iperf3</code>.",
"firewallTitle": "Otvoriť firewall port na serveri",
"firewallBody": "Server predvolene načúva na porte TCP <strong>5201</strong>. Ak ho spustíte na hostiteľovi Proxmox s prísnym firewallom na úrovni dátového centra alebo hostiteľa, počas testu povoľte prichádzajúce TCP 5201 z IP adresy klienta a potom port opäť zatvorte. To isté platí pre <code>nftables</code> / <code>iptables</code> na fyzických hostiteľoch."
},
"install": {
"heading": "Prvé spustenie nainštaluje balík",
"body": "Všetky tri spúšťače overia prítomnosť programu a ak chýba, spustia <code>apt-get update -qq &amp;&amp; apt-get install -y &lt;pkg&gt;</code>. Inštalácia prebieha bez výpisu: pri prvom použití môže menu pôsobiť zamrznuto 10–30 sekúnd. Ďalšie spustenia sú okamžité."
},
"troubleshoot": {
"heading": "Riešenie problémov",
"hangTitle": "Inštalácia visí navždy pri prvom spustení",
"hangBody": "Hostiteľ nemá internet alebo apt repo sú nedosiahnuteľné. Zrušiť pomocou <kbd>Ctrl</kbd>+<kbd>C</kbd>, spustiť <code>apt-get update</code> ručne vidieť skutočnú chybu (DNS, repo podpis, proxy ...), potom sa vrátiť do menu.",
"refusedTitle": "Klient iperf3: „unable to connect to server: Connection refused“",
"refusedBody": "Server buď nebeží, alebo jeho firewall blokuje TCP 5201. Na serveri overte cez <code>ss -tlnp | grep 5201</code>, že iperf3 načúva. Ak načúva, ale klient stále zlyháva, skontrolujte firewally na trase medzi hostiteľmi.",
"slowTitle": "iperf3 hlási výrazne nižšiu rýchlosť, než sa od spojenia očakáva",
"slowBody": "Bežné príčiny v poradí pravdepodobnosti: (1) CPU jedného hostiteľa je úzkym miestom — skúste <code>iperf3 -c &lt;target&gt; -P 4</code> na využitie viacerých jadier; (2) prenos prechádza pomalším spojom, napríklad gigabitovým prepínačom medzi dvoma kartami 10 GbE; (3) nezhodné MTU — skontrolujte <code>ip link show</code> na oboch koncoch; (4) vypnutý NIC offloading — pri karte Intel e1000e pozrite komunitný skript <em>Disable NIC Offloading</em>.",
"noTrafficTitle": "iftop / iptraf-ng nevykazujú žiadnu prevádzku pre rušného hostiteľa",
"noTrafficBody": "Predvolené zachytávanie používa prvé zistené rozhranie. Správne rozhranie zadajte výslovne zo shellu: <code>iftop -i vmbr0</code> alebo <code>iptraf-ng -i vmbr0</code>. Spúšťač v menu používa predvolené rozhranie; pre iné rozhrania spustite nástroj z konzoly."
},
"related": {
"heading": "Súvisiace",
"items": [
{
"label": "Diagnostika",
"href": "/docs/network/diagnostics",
"tail": " — jednorazové kontroly iba na čítanie (smerovanie, pripojenie a pokročilé štatistiky)."
},
{
"label": "Analýza mostov a oprava so sprievodcom",
"href": "/docs/network/bridge-analysis",
"tail": " — keď sledovanie odhalí, že rozhranie alebo most nefunguje správne."
}
]
}
}
@@ -0,0 +1,130 @@
{
"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 <code>/etc/systemd/network/10-&lt;iface&gt;.link</code> s pravidlom: <em>„Zariadenie s touto MAC adresou sa musí vždy volať týmto názvom.“</em> systemd-udevd použije pravidlo pri každom štarte skôr, než <code>ifupdown</code> prečíta <code>/etc/network/interfaces</code>."
},
"problem": {
"heading": "Problém, ktorý rieši",
"intro": "Linux odvodzuje predvolené názvy rozhraní z topológie PCI — <code>eno1</code> = integrovaná karta, <code>enp3s0</code> = karta na zbernici PCI 3, slot 0 atď. Schéma názvov je deterministická <em>pri rovnakom rozložení hardvéru</em>. 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 <code>/etc/network/interfaces</code> stále odkazuje na <em>starý</em> 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 <em>skôr</em>, než zasiahnu iné komponenty (ifupdown, predvolené pomenovanie jadra). Predpona <code>10-</code> zabezpečuje skoré načítanie pravidiel pred predvoleným súborom <code>99-default.link</code>."
},
"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 <code>.link</code>",
"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 <code>.link</code>",
"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 <code>/etc/network/interfaces</code>"
},
{
"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 <code>/etc/systemd/network/</code> už obsahuje <code>.link</code> 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 <code>.link</code> sa použijú iba pri štarte, keď udev znovu enumeruje zariadenia. Preto nástroj hlási <em>„Zmeny sa použijú po reštarte“</em>. Premenovanie rozhrania za behu je riskantné a nástroj sa oň nepokúša: aktívny <code>vmbr0</code> 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 <code>.link</code>.",
"Ak je NIC nahradený (iný MAC), dostane predvolený názov jadra (<code>enp&lt;bus&gt;s&lt;slot&gt;</code>); znovu spustite toto menu pre pridanie položky <code>.link</code> 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 <code>ls -l /sys/class/net/</code> — každá položka by mala obsahovať symbolický odkaz <code>device</code> (PCI) alebo položku <code>phy80211</code> (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: <code>cat /etc/systemd/network/10-&lt;iface&gt;.link</code>. Potom skontrolujte záznamy udev: <code>journalctl -u systemd-udevd -b | grep -i link</code>. Bežnou príčinou je starý parameter jadra <code>net.ifnames=0</code>, ktorý úplne vypína predvídateľné názvy — odstráňte ho z <code>/etc/default/grub</code>, spustite <code>update-grub</code> a reštartujte.",
"undoTitle": "Chcem zrušiť trvalé pomenovanie.",
"undoBody": "Buď odstráňte súbory <code>.link</code> (<code>rm /etc/systemd/network/10-*.link</code>), 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 <em>už</em> 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 <em>Zobraziť smerovaciu tabuľku</em>."
}
]
}
}