Bring the web documentation in line with develop in every language

- English pages describe backups, the manifest, ROCm GPUs, OCI host directories and storage as develop does, and say user instead of operator
- New paragraph on host directories mounted with everything the host has mounted inside them, and a new update rule for host directories
- The Proxmox Backup Server section of the post-install page is translated into every language
- Spanish and the other six languages follow the updated English
This commit is contained in:
MacRimi
2026-10-18 19:02:17 +02:00
parent 62ddd7599b
commit a2b96bf6a4
75 changed files with 661 additions and 198 deletions
@@ -76,7 +76,7 @@
},
"sameArchive": {
"heading": "Rozloženie archívu sa nemení s destináciou",
"body": "V každom z troch cieľov sa nachádza rovnaká štruktúra <code>rootfs/</code> + <code>metadata/</code> + <code>manifest.json</code> opísaná v časti <em>Ako to funguje</em>. Rozbalenie lokálneho archívu <code>.tar.zst</code>, obnova <code>.pxar</code> z PBS aj rozbalenie archívu Borg cez <code>borg extract</code> vytvoria rovnaký adresárový strom. Vetva kódu obnovy (<code>_rs_check_layout</code>, <code>_rs_apply</code>, <code>_rs_prepare_pending_restore</code>) číta rovnaké tri bloky údajov bez potreby vedieť, z ktorého cieľa pochádzajú."
"body": "Bez ohľadu na to, kde je záloha uložená, vždy obsahuje rovnaké tri bloky opísané v časti <em>Ako to funguje</em>: súborový systém (<code>rootfs/</code>), metadáta (<code>metadata/</code>) a manifest (<code>manifest.json</code>). Rozbalenie lokálneho archívu <code>.tar.zst</code>, obnova <code>.pxar</code> z PBS aj rozbalenie archívu Borg vytvoria rovnaký adresárový strom. Obnova preto vždy číta rovnaké súbory bez ohľadu na to, z ktorého cieľa záloha pochádza."
},
"extractStandalone": {
"heading": "Rozbalenie zálohy mimo ProxMenux",
@@ -23,7 +23,7 @@
},
"repoSelection": {
"heading": "Výber úložiska",
"intro": "ProxMenux objavuje archív PBS z dvoch zdrojov na každej zálohe. Operátor vyberie jeden z jednotného menu; voľba určuje <code>HB_PBS_REPOSITORY</code>, <code>HB_PBS_SECRET</code> a <code>HB_PBS_FINGERPRINT</code> pre spustenie.",
"intro": "ProxMenux pri každej zálohe vyhľadá repozitáre PBS z dvoch zdrojov. Používateľ jeden z nich vyberie z jednotného menu; pre dané spustenie voľba určuje, na ktorý server a do ktorého dátového skladu sa záloha odošle, akým heslom sa overí a ktorý <em>odtlačok</em> overí certifikát.",
"sourceRows": [
{
"source": "Proxmox storage.cfg (automaticky zistené)",
@@ -46,7 +46,7 @@
"backupIdTitle": "Identifikačné meno zálohy",
"backupIdBody": "Predvolený identifikátor zálohy je <code>hostcfg-HOSTNAME</code>. Pred odoslaním ho operátor potvrdí alebo upraví. Znaky mimo <code>[A-Za-z0-9_-]</code> aj pomlčky na konci sa odstránia. Opakované použitie rovnakého ID je zámerné: PBS ho chápe ako <em>skupinu</em> a každá ďalšia záloha pribudne do tejto skupiny ako nová položka so spoločnou deduplikáciou s predchádzajúcimi zálohami.",
"pxarTitle": "Prečo je zdrojom celý prípravný adresár",
"pxarBody": "Zdrojom archívu <code>.pxar</code> je celý <code>staging_root</code>: spolu <code>rootfs/</code>, <code>metadata/</code> aj <code>manifest.json</code>. Staršie verzie používali ako zdroj <code>$staging_root/rootfs</code>, takže v archíve chýbal adresár <code>metadata/</code>. Kontrola kompatibility pri obnove nemala čo čítať a zobrazovala upozornenia na iného hostiteľa aj pri obnove na pôvodnom hostiteľovi. Staré zálohy obsahujúce iba rootfs sa stále obnovujú správne pomocou tretej vetvy <code>_rs_check_layout</code>, ktorá plochý strom <code>etc/var/root/usr</code> zabalí do hierarchie <code>rootfs/</code>."
"pxarBody": "Archív <code>.pxar</code> obsahuje celý pracovný adresár: súborový systém hostiteľa (<code>rootfs/</code>), metadáta (<code>metadata/</code>) a manifest (<code>manifest.json</code>). Pri obnove ProxMenux porovná manifest s cieľovým hostiteľom, aby zistil, či sú rovnocenné, či sa zmenil hardvér alebo či ide o iný počítač, a podľa toho upraví postup. Staršie zálohy vytvorené staršími verziami ProxMenux, ktoré balili iba súborový systém, sa stále obnovujú správne: obnova tento starší formát rozpozná a automaticky ho preusporiada."
},
"encryption": {
"heading": "Šifrovanie na strane klienta",
@@ -63,7 +63,7 @@
"recoveryTitle": "Odoslanie kľúča na PBS — rozhoduje operátor",
"recoveryBody": "Hneď po výbere súboru kľúča položí ProxMenux výslovnú otázku <em>Odoslať kľúč na PBS?</em> s dvoma odpoveďami. <strong>Kým operátor nezvolí Áno, na PBS sa neodošle žiadny obnovovací artefakt.</strong> Predvolená voľba je <em>Nie, ponechať iba lokálne</em>: kľúč zostane na kanonickej miestnej ceste, ProxMenux neodosiela na PBS žiadne obnovovacie artefakty a externú kópiu zabezpečí operátor. Tlačidlo <em>Stiahnuť súbor kľúča</em> v riadku cieľa PBS v Monitore ju poskytne na požiadanie. Voľba <em>Áno, odoslať</em> vyžiada dvakrát prístupovú frázu na obnovu a overí zhodu. ProxMenux ňou zašifruje súbor kľúča pomocou AES-256-CBC a PBKDF2 (600 000 iterácií, náhodná soľ) a vytvorí <code>pbs-key.recovery.enc</code>. Každá ďalšia šifrovaná záloha odošle túto obálku na PBS ako priradenú skupinu záloh. Pri týchto odoslaniach sa na PBS neposiela prístupová fráza ani súbor kľúča v otvorenom tvare. Voľbu možno kedykoľvek zmeniť v Monitore: ovládací prvok v riadku PBS prepína Áno/Nie a okamžite použije Spustiť odosielanie, Zastaviť odosielanie alebo Aktualizovať prístupovú frázu podľa aktuálneho stavu.",
"blobUploadTitle": "Párovaná záložná skupina na PBS",
"blobUploadBody1": "Keď je režim úschovy <em>Áno, nahrať</em>, ProxMenux odošle obálku na obnovenie do PBS po každej zašifrovanej zálohe ako druhá, spárovaná skupina záloh s rovnakým názvom ako hostiteľská skupina, ale končiaca na <code>-keyrecovery</code>. Tieto dve skupiny sedia vedľa seba v zozname dátového skladu – jedna pre zálohy hostiteľa, druhá pre obálky na obnovenie. <strong>Obálka nikdy neopustí hostiteľa v obyčajnom texte</strong>: šifrovanie prebieha na samotnom hostiteľovi pomocou AES-256-CBC a PBKDF2 predtým, ako prejdú akékoľvek bajty na drôt (<code>openssl enc -aes-256-cbc -pbkdf2 -iter 600000 -salt</code>). PBS prijíma iba už zašifrovanú obálku.",
"blobUploadBody1": "Keď je odpoveď <em>Áno, nahrať</em>, ProxMenux po každej zašifrovanej zálohe odošle obálku na obnovenie do PBS ako druhú, spárovanú skupinu záloh s rovnakým názvom ako skupina hostiteľa, ktorá však končí na <code>-keyrecovery</code>. Obe skupiny sú v zozname dátového skladu vedľa seba: jedna pre zálohy hostiteľa, druhá pre obálky na obnovenie. <strong>Obálka nikdy neopustí hostiteľa v otvorenom texte</strong>: šifrovanie prebieha priamo na hostiteľovi pomocou AES-256-CBC a PBKDF2 ešte pred odoslaním akýchkoľvek bajtov po sieti (<code>openssl enc -aes-256-cbc -pbkdf2 -iter 600000 -salt</code>). PBS prijme iba už zašifrovanú obálku.",
"envelopeSecurityTitle": "Predstavuje odoslanie obnovovacieho súboru na PBS bezpečnostné riziko?",
"envelopeSecurityBody": "Obnovovací súbor je šifrovaný pri prenose aj pri uložení. Prístupová fráza na obnovu neopúšťa hostiteľa: šifrovanie prebehne lokálne pred odoslaním a PBS dostane iba zašifrovaný výsledok. Správca PBS alebo ktokoľvek s prístupom k dátovému úložisku môže obnovovací súbor stiahnuť, ale bez prístupovej frázy nedokáže prečítať súbor kľúča vnútri; ide o nečitateľný šifrovaný text. Na získanie súboru kľúča treba obe časti súčasne: obnovovací súbor aj prístupovú frázu. Obe má iba operátor.",
"blobUploadConstraintTitle": "Prečo dve skupiny namiesto jedného zašifrovaného",
@@ -73,7 +73,7 @@
"recoverTitle": "Obnovenie nového hostiteľa",
"recoverBody": "Ak miestny súbor kľúča chýba na kanonickej ceste, napríklad po preinštalovaní hostiteľa alebo úmyselnom odstránení, obnova vyskúša tri zdroje v poradí a skončí pri prvom použiteľnom kľúči. Najprv sa bez otázok skopíruje zodpovedajúci kľúč spravovaný PVE z <code>/etc/pve/priv/storage/&lt;NAME&gt;.enc</code> na kanonickú cestu, ak existuje pre vybrané úložisko PBS. Ak je na PBS dostupná skupina <code>-keyrecovery</code>, druhý krok stiahne jej najnovšiu snímku a vyžiada prístupovú frázu na dešifrovanie. Ak ani jedna možnosť nefunguje alebo ich operátor odmietne, tretí krok vyžiada absolútnu cestu k súboru kľúča na tomto hostiteľovi a skopíruje ho na kanonickú cestu. Monitor poskytuje rovnaký import v okne podrobností zálohy. Ak Obnoviť, Stiahnuť alebo Zobraziť obsah potrebuje chýbajúci kľúč, hore sa zobrazí jantárový panel. Ak je kľúč nainštalovaný, ale nezodpovedá šifrovaniu zálohy, PBS vráti chybu <code>wrong key — manifest's key XX does not match provided key YY</code>. Rovnaké tri akcie potom zobrazia štruktúrovaný panel so zvýrazneným odtlačkom kľúča požadovaným manifestom, aby operátor vedel, ktorý kľúč má pre túto zálohu importovať.",
"monitorManagementTitle": "Správa súboru kľúčov z monitora",
"monitorManagementBody": "Monitor zobrazuje ovládanie súboru kľúča priamo v každom riadku cieľa PBS na stránke konfigurácie záloh. Sú tam tri akcie: <em>Stiahnuť</em> exportuje aktuálny súbor do prehliadača operátora; <em>Nahrať</em> nahradí nainštalovaný súbor dodaným súborom, pričom pôvodný prepíše až po úspešnom uložení nového na kanonickú cestu; <em>Odstrániť</em> zmaže súbor z hostiteľa. Vedľa je ovládanie obnovovacej kópie: výber Áno/Nie pre <em>Odoslať kľúč na PBS?</em>, pole prístupovej frázy pri voľbe Áno a kontextové tlačidlo na použitie voľby <em>Spustiť odosielanie</em>, <em>Zastaviť odosielanie</em> alebo <em>Aktualizovať prístupovú frázu</em>. Všetky akcie používajú rovnaké koncové body Flask ako terminálové rozhranie, takže účinok na disku a stav na PBS sú z oboch rozhraní rovnaké."
"monitorManagementBody": "Monitor zobrazuje ovládanie súboru kľúča v každom riadku cieľa PBS na stránke konfigurácie záloh. Riadok ponúka tri akcie: <em>Stiahnuť</em> exportuje aktuálny súbor kľúča do prehliadača používateľa, <em>Nahrať</em> nahradí nainštalovaný súbor kľúča súborom, ktorý dodá používateľ (pôvodný súbor sa prepíše až potom, ako nový správne dorazí na svoju cestu), a <em>Odstrániť</em> odstráni súbor kľúča z hostiteľa. Hneď vedľa je prepínač obálky na obnovenie: výber Áno/Nie pre <em>Odoslať kľúč na PBS?</em>, pole prístupovej frázy, ktoré sa zobrazí pri voľbe Áno, a tlačidlo, ktoré sa riadi aktuálnym stavom: <em>Spustiť odosielanie</em>, <em>Zastaviť odosielanie</em> alebo <em>Aktualizovať prístupovú frázu</em>. Ovládacie prvky v Monitore a dialóg v shelli vykonávajú v pozadí to isté, takže výsledok na disku aj na PBS je rovnaký bez ohľadu na to, ktorý z nich sa použije."
},
"restoreAccess": {
"heading": "Získavanie na strane obnovy",
@@ -121,7 +121,7 @@
}
],
"schemaTitle": "Potvrdenie schémy",
"schemaBody": "Manifest sa overuje podľa <code>scripts/backup_restore/schema/manifest.schema.json</code>. Príkaz <code>build_manifest.sh --validate</code> spustí validáciu JSON Schema v Pythone, ktorá vyžaduje <code>python3</code> a <code>jsonschema</code>. Ak modul chýba, kontrola sa bez upozornenia preskočí. Validácia slúži najmä vývojárom, nie je závislosťou potrebnou pri bežnom behu."
"schemaBody": "ProxMenux obsahuje šablónu, ktorá opisuje, ktoré polia musí manifest obsahovať a aký tvar má každé z nich. Pri vytváraní zálohy možno manifest automaticky overiť podľa tejto šablóny, takže zberač, ktorý vytvoril chybný JSON alebo pole s preklepom, sa odhalí okamžite. Kontrola je určená na vývoj samotného ProxMenux: v systéme, kde nie je nainštalovaná, záloha funguje ako zvyčajne a manifest sa vytvorí rovnako."
},
"applications": {
"heading": "Inventár aplikácií",
@@ -105,7 +105,7 @@
[
"AMD ROCm",
"Renderovací uzol, <code>/dev/kfd</code> a generácia, ktorú výpočtový ovládač hlási v <code>/sys/class/kfd/kfd/topology/nodes/*/properties</code>",
"Generácia, pre ktorú obraz ROCm aplikácie obsahuje výpočtové jadrá — uvedené GPU RDNA2 a novšie — sa ponúkne bez úprav. Ostatné GPU týchto rodín, napríklad Radeon 680M a 780M, sa ponúkajú ako experimentálne a nikdy nie sú navrhnutou voľbou: ROCm ich oficiálne nepodporuje, aplikácia ich prezentuje ako generáciu danej rodiny (<code>HSA_OVERRIDE_GFX_VERSION</code>) a inštalátor pred stiahnutím väčšieho obrazu vyžiada potvrdenie. Staršia GPU, napríklad integrovaná grafika Ryzen 5000U, sa neponúkne a Immich ponechá rozpoznávanie na CPU."
"GPU generácie, ktorú obraz ROCm aplikácie podporuje (uvedené GPU RDNA2 a novšie), sa ponúkne bez úprav. Ostatné GPU týchto rodín, napríklad Radeon 680M a 780M, sa ponúkajú ako experimentálne a nikdy nie sú navrhnutou voľbou. ROCm ich oficiálne nepodporuje: aplikácia ich prezentuje ako generáciu danej rodiny (<code>HSA_OVERRIDE_GFX_VERSION</code>) a inštalátor pred stiahnutím väčšieho obrazu vyžiada potvrdenie. Staršia GPU, napríklad integrovaná grafika Ryzen 5000U, sa neponúkne a Immich ponechá rozpoznávanie na CPU"
],
[
"NVIDIA",
@@ -104,6 +104,7 @@
"Nový obraz sa overí vrstvu po vrstve ešte pred zastavením CT. Poškodené stiahnutie sa zopakuje druhýkrát; obraz už uložený vo vyrovnávacej pamäti, ktorý neprejde kontrolou, sa stiahne znova.",
"Nastavenia zmenené v Proxmox VE po inštalácii (pamäť, swap, jadrá, limit CPU, priorita CPU, spustenie spolu s uzlom) sa zachovajú a prenesú do nového kontraktu.",
"Rozhranie LAN, ktoré pridáva súprava Arr a aplikácie s viacerými kontajnermi (<code>net1</code>), aj poradie spúšťania (<code>startup</code>) sa bez zmeny prenesú do nového kontajnera.",
"Adresár hostiteľa sa rozpoznáva podľa svojej cesty a súborového systému, na ktorom sa nachádza, nie podľa názvu zariadenia, ktorý hostiteľ dáva jeho disku, takže disk USB alebo sieťový disk, ktorý sa vráti pod iným názvom, je stále ten istý adresár. Keď jeho disk nie je pripojený, aktualizácia sa zastaví pred zastavením CT a uvedie chýbajúci adresár.",
"Akýkoľvek iný rozdiel medzi CT a jeho zmluvou zastaví aktualizáciu pred zastavením CT."
]
}
@@ -38,7 +38,7 @@
},
{
"title": "Úložisko a veľkosť",
"body": "Na úložisku Proxmox VE sa vytvorí disk kontajnera so zadanou veľkosťou. Predvolená inštalácia používa <code>local-lvm</code>. Rozšírená inštalácia sa pri každej ceste pýta najprv na úložisko a potom na veľkosť; navrhuje úložisko rootfs. Disk sa zobrazuje ako <code>vm-VMID-disk-N</code> a pripája sa ako <code>mpN</code>."
"body": "Na úložisku Proxmox VE sa vytvorí disk kontajnera so zadanou veľkosťou. Predvolená inštalácia sa raz opýta na úložisko kontajnera a jeho údajov, ak má uzol viac ako jedno; rozšírená inštalácia sa pri každej ceste pýta na úložisko tesne pred veľkosťou a navrhuje úložisko rootfs. Disk sa zobrazuje ako <code>vm-VMID-disk-N</code> a pripája sa ako <code>mpN</code>."
},
{
"title": "Adresár hostiteľa",
@@ -109,6 +109,9 @@
},
{
"p": "Rootfs je vyhradený pre binárne súbory a obsah obrazu. Aktualizácia alebo opätovné vytvorenie ho nahradí bez zásahu do ktoréhokoľvek z dvoch typov prípojných bodov."
},
{
"p": "Adresár hostiteľa sa pripojí so všetkým, čo v ňom má hostiteľ pripojené. Adresár ako <code>/mnt/pve</code> zobrazí v kontajneri svoje sieťové zdieľania, disky a datasety a to, čo tam hostiteľ neskôr pripojí alebo odpojí, sa zobrazí alebo zmizne bez reštartu kontajnera. Adresár pridaný iba na čítanie je iba na čítanie spolu s tým, čo je v ňom pripojené pri spustení kontajnera. Súborový systém, ktorý hostiteľ pripojí neskôr, prichádza s oprávneniami, s ktorými ho hostiteľ pripojí, a pri reštarte kontajnera bude tiež iba na čítanie."
}
]
},
@@ -78,6 +78,17 @@
"heading": "Komunitné skripty",
"body": "Menu ponúka aj dva skripty tretích strán z projektu <a>community-scripts</a>: <em>Proxmox VE Post Install</em> a <em>Proxmox VE Microcode</em>. Ide o obaly, ktoré stiahnu a spustia pôvodné autorské skripty cez <code>wget | bash</code>. ProxMenux ich neudržiava. Pred spustením si pozrite podrobnosti a otázky dôvery v časti <link>Externé repozitáre</link>."
},
"pbs": {
"heading": "Na Proxmox Backup Server",
"body": "Na hostiteľovi Proxmox Backup Server sa rovnaká ponuka otvára cez <strong>Nastavenie Proxmoxu po inštalácii</strong> v ponuke PBS. Automatický, Prispôsobiteľný, Nainštalovať dostupné aktualizácie a Odinštalovať optimalizácie fungujú ako na Proxmox VE, s týmito rozdielmi:",
"items": [
"<strong>Repozitáre a aktualizácia:</strong> keď server nemá predplatné a aktívny je iba repozitár Enterprise pre PBS, ProxMenux sa pred prepnutím na repozitár PBS bez predplatného opýta. Prepnutie prebieha cez API repozitárov samotného servera, rovnaké, aké používa <em>Administration > Repositories</em>. Pri aktívnom predplatnom alebo pri už nastavenom repozitári bez predplatného či testovacom repozitári zostanú zdroje bez zmeny.",
"<strong>Prispôsobiteľný zoznam:</strong> možnosti, ktoré platia iba pre Proxmox VE, sa nezobrazujú: hosťovský agent, VFIO IOMMU, Open vSwitch, rýchlosť záloh vzdump, pigz, Appliance Manager, Ceph, vysoká dostupnosť a OVH Real Time Monitoring.",
"<strong>Banner predplatného:</strong> záplata sa vzťahuje na webové rozhranie Proxmox Backup Server a Odinštalovať optimalizácie ho obnoví.",
"<strong>Figurine:</strong> inštaluje sa bez aliasov Proxmox VE.",
"<strong>Komunitné skripty:</strong> sekcia ponúka <em>Proxmox Backup Server Post Install</em> a <em>Proxmox Backup Server Microcode</em> namiesto skriptov pre Proxmox VE."
]
},
"related": {
"heading": "Súvisiace",
"items": [