mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-11-02 19:02:31 +00:00
docs: review storage sharing documentation in all seven translations
This commit is contained in:
Jonatan
@@ -0,0 +1,123 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Hostiteľ: Pridanie cieľa iSCSI ako úložiska Proxmox | Dokumentácia ProxMenux",
|
||||
"description": "Zaregistrujte cieľ iSCSI ako úložisko Proxmox cez ProxMenux. Nástroj nainštaluje open-iscsi, vyhľadá ciele portálu cez sendtargets, umožní výber cieľa a spustí pvesm add iscsi. Poskytuje surové blokové zariadenia pre obrazy diskov VM.",
|
||||
"ogTitle": "Hostiteľ: Pridanie cieľa iSCSI ako úložiska Proxmox | Dokumentácia ProxMenux",
|
||||
"ogDescription": "Zaregistrujte cieľ iSCSI ako úložisko Proxmox so sprievodcom vyhľadávaním. Používa pvesm add iscsi a poskytuje surové blokové zariadenia pre disky VM."
|
||||
},
|
||||
"header": {
|
||||
"title": "Host: Pridať iSCSI cieľ ako Proxmox úložisko",
|
||||
"description": "Zaregistrujte iSCSI cieľ (z SAN, TrueNAS / FreeNAS, Synology, Windows Server cieľ, akékoľvek pole, ktoré hovorí iSCSI) ako Proxmox úložisko. Exportované LUNs sa objavujú ako blokové zariadenia a môžu hostiť VM diskové snímky s takmer lokálnym výkonom v sieti.",
|
||||
"section": "Úložisko a zdieľanie · hostiteľ"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Čo to robí?",
|
||||
"body": "ProxMenux ponúka sprievodcu pre <code>pvesm add iscsi</code>: podľa potreby nainštaluje <code>open-iscsi</code>, vyžiada portál iSCSI (IP:port), spustí proti nemu <code>iscsiadm --mode discovery --type sendtargets</code>, umožní vybrať IQN cieľa a zaregistruje úložisko iSCSI v Proxmoxe. Služba <code>iscsid</code> potom udržiava reláciu iSCSI aj po reštartoch."
|
||||
},
|
||||
"vocab": {
|
||||
"heading": "Pojmy iSCSI (stručný prehľad)",
|
||||
"headerTerm": "Termín",
|
||||
"headerMeaning": "Význam",
|
||||
"rows": [
|
||||
{
|
||||
"term": "Portál",
|
||||
"meaningRich": "Koncový bod služby iSCSI na cieľovom serveri — IP adresa (alebo názov hostiteľa) a port TCP. Predvolený port je <code>3260</code>; ProxMenux ho použije, ak iný nezadáte."
|
||||
},
|
||||
{
|
||||
"term": "Cieľ",
|
||||
"meaningRich": "Jeden exportovaný \"server\" vnútri portálu, identifikovaný jeho IQN (<em>iSCSI Kvalifikovaný názov</em>). Jeden portál môže hostiť veľa cieľov."
|
||||
},
|
||||
{
|
||||
"term": "IQN",
|
||||
"meaningRich": "Kanonická forma je <code>iqn.YYYY-MM.reverse.domain:identifier</code>, napríklad <code>iqn.2024-08.com.truenas:proxmox-pool</code>. Cieľ aj iniciátor majú vlastné IQN."
|
||||
},
|
||||
{
|
||||
"term": "LUN",
|
||||
"meaningRich": "Blokové zariadenie vnútri cieľa (Logické číslo jednotky). Jeden cieľ môže odhaliť niekoľko LUNs; každý LUN sa objaví ako svoj vlastný disk v Proxmox a môže sa stať VM disk."
|
||||
},
|
||||
{
|
||||
"term": "Iniciátor",
|
||||
"meaningRich": "Klient, ktorý sa pripojí k cieľu, v tomto prípade, váš Proxmox hostiteľ. Iniciátor má vlastné IQN uložené v <code>/etc/iscsi/initiatorname.iscsi</code>. Ciele zvyčajne prijímajú iba sedenia od vopred schválených iniciátorov IQN."
|
||||
}
|
||||
]
|
||||
},
|
||||
"opening": {
|
||||
"heading": "Otvorenie nástroja",
|
||||
"body": "Z hlavného menu ProxMenux, otvoriť <strong>Storage & Share Manager → Pridať iSCSI Target ako Proxmox Storage</strong>. Uvidíte toto sub- menu so štyrmi možnosťami:",
|
||||
"imageAlt": "Ponuka správcu iSCSI hostiteľa — Pridať / Zobraziť / Odstrániť / Testovať pripojenie"
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Ako beží skript (Pridať tok)",
|
||||
"body": "Postup má dve fázy: nastavenie iniciátora a vyhľadanie cieľov, potom registráciu úložiska v Proxmoxe. Na rozdiel od NFS a Samba sa nevykonáva automatické vyhľadávanie v podsieti — adresu portálu musíte poznať (iSCSI sa nehodí na vyhľadávanie cez broadcast)."
|
||||
},
|
||||
"add": {
|
||||
"heading": "Pridať iSCSI target ako Proxmox úložisko",
|
||||
"items": [
|
||||
"<strong>Zadanie portálu</strong> — zadajte IP adresu alebo názov hostiteľa cieľového servera iSCSI. Použije sa port <code>3260</code>, ak nezadáte <code>host:port</code>.",
|
||||
"<strong>Vyhľadanie cieľov</strong> — ProxMenux zavolá <code>iscsiadm --mode discovery --type sendtargets --portal <ip:port></code>. Server vráti všetky IQN, ktoré tomuto iniciátorovi sprístupňuje. Pri zlyhaní skript zobrazí presnú chybu z <code>iscsiadm</code> a bežné príčiny (nesprávna IP adresa, firewall, nepovolené IQN iniciátora).",
|
||||
"<strong>Výber cieľa</strong> — jeden cieľ sa vyberie automaticky; viacero cieľov zobrazí ponuku.",
|
||||
"<strong>ID skladu</strong> Predvolená hodnota <code>iscsi-<last IQN segment, 20 chars max></code>. Iba písmená, číslice, <code>-</code> a <code>_</code>.",
|
||||
"<strong>Typ obsahu</strong> — na rozdiel od NFS a Samba je obsah iSCSI <strong>pevne nastavený na <code>images</code></strong>. iSCSI poskytuje surové blokové zariadenia, nie súborový systém, preto na ňom Proxmox povoľuje iba disky VM."
|
||||
],
|
||||
"authTitle": "Povoľte iniciátora Proxmox na cieľ",
|
||||
"authBody1": "Aby pridanie fungovalo od začiatku do konca, cieľ iSCSI musí poznať vášho hostiteľa Proxmox. Zistite IQN svojho iniciátora:",
|
||||
"authBody2": "Pridajte toto IQN do zoznamu prístupu cieľa (TrueNAS: <em>Sharing → Block → Initiators Groups</em>; Synology: <em>SAN Manager → iSCSI → Target → Edit → Initiators</em>; atď.). Ak iniciátor nie je povolený, vyhľadávanie cez <code>iscsiadm</code> vráti prázdny zoznam alebo chybu autentifikácie."
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Ručný ekvivalent",
|
||||
"body": "Celý postup zodpovedá týmto príkazom:"
|
||||
},
|
||||
"view": {
|
||||
"heading": "Zobraziť nakonfigurované úložiská iSCSI",
|
||||
"body": "Zobrazí každú položku iSCSI v Proxmoxe (<code>pvesm status | awk ''$2 == \"iscsi\"''</code>) s portálom, cieľovou IQN, typom obsahu a živým stavom."
|
||||
},
|
||||
"remove": {
|
||||
"heading": "Odstrániť úložisko iSCSI",
|
||||
"body": "Po potvrdení portálu, cieľa a obsahu spustí <code>pvesm remove <storage-id></code>. Odstráni sa iba registrácia v Proxmoxe — <strong>samotný cieľ iSCSI zostane nedotknutý</strong> a existujúce relácie jadra môžu pretrvať až do reštartu.",
|
||||
"warnTitle": "Najprv skontrolujte existujúce disky VM na tomto iSCSI",
|
||||
"warnBody": "Odstránenie úložiska iSCSI, na ktorom VM stále majú disky, ponechá VM odkazovať na chýbajúce úložisko. Proxmox nahlási chybu, ale údaje LUN zostanú v cieli nedotknuté — opätovnou registráciou úložiska môžete disky znovu sprístupniť. Pre istotu však VM najprv presuňte alebo zálohujte."
|
||||
},
|
||||
"test": {
|
||||
"heading": "Test iSCSI konektivita",
|
||||
"body": "Spustí diagnostiku: overí inštaláciu <code>iscsiadm</code>, vypíše IQN iniciátora, skontroluje beh <code>iscsid</code>, vykoná ping každého registrovaného portálu, overí jeho port a zobrazí <code>pvesm status</code> aj stav aktívnej relácie iSCSI (<code>iscsiadm --mode session</code>). Aktívna relácia a dostupný portál pri stave „inactive“ v Proxmoxe zvyčajne znamenajú zastaraný stav — skúste <code>pvesm set <id> --disable 0</code>."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Riešenie problémov",
|
||||
"portalTitle": "\"Nedostať sa k portálu,\" ale server IP reaguje inde",
|
||||
"portalBody": "Ping zlyhal na adrese portálu. Skontrolujte, či sa pripájate k rozhraniu <em>siete úložiska</em> (iSCSI často žije na oddelenej VLAN / podsieti od siete správy). Overte tiež DNS, ak ste zadali názov hostiteľa.",
|
||||
"discoverTitle": "\"iSCSI objav zlyhal\" z iscsiadm",
|
||||
"discoverIntro": "Skript ukazuje presnú chybu. Najčastejšie príčiny:",
|
||||
"discoverItems": [
|
||||
"Portál IP / port zle (dvojitá kontrola, predvolená je 3260).",
|
||||
"Služba iSCSI nebeží na cieľovom serveri.",
|
||||
"Firewall blokuje 3260 medzi Proxmox a cieľ.",
|
||||
"<strong>IQN iniciátora nie je povolené v cieli.</strong> Najčastejšia príčina pri podnikových diskových poliach. Najprv pridajte IQN Proxmox do ACL iniciátorov na cieľovom serveri."
|
||||
],
|
||||
"noTargetTitle": "Neboli nájdené žiadne ciele, ale objav bol úspešný",
|
||||
"noTargetBody": "Server prijal iniciátora, ale nesprístupňuje mu žiadny cieľ. Skontrolujte autentifikáciu a pravidlá prístupu — niektoré diskové polia povoľujú vyhľadávanie všetkým IQN, ale filtrujú ciele viditeľné jednotlivým IQN.",
|
||||
"noLunTitle": "LUNs sa po registrácii v /dev/disk/by-path neobjavujú",
|
||||
"noLunBody": "<code>pvesm add iscsi</code> uspel, ale jadro nevidí blokové zariadenia. Skontrolujte <code>iscsiadm --mode session</code> — ak žiadna relácia nie je aktívna, prihláste sa ručne cez <code>iscsiadm --mode node --login</code>. Ak relácia existuje, ale LUN chýbajú, vynúťte nové vyhľadanie: <code>iscsiadm --mode session --rescan</code>. Ak sa stále nič nezobrazí, cieľ zrejme ešte nemá LUN priradené tomuto IQN (nastavte mapovanie LUN v cieli).",
|
||||
"chapTitle": "Autentifikácia CHAP",
|
||||
"chapBody": "ProxMenux v interaktívnom postupe nemá polia na meno a heslo CHAP. Ak vyhľadávanie zlyhá, skript skončí pred <code>pvesm add</code> a úložisko napriek chybe nezaregistruje. Požiadavky CHAP cieľa nastavte samostatne v <code>open-iscsi</code>, podľa potreby aj autentifikáciu vyhľadávania, a skúste to znova. Konfiguráciu overte cez <code>iscsiadm</code> a aktívne relácie cez <code>iscsiadm --mode session</code>."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/storage-share/host-nfs",
|
||||
"label": "Zdieľanie NFS ako úložisko Proxmox",
|
||||
"tail": " — alternatíva na úrovni súborov: jednoduchšie nastavenie, väčšia flexibilita (backup / ISO / tmpl / images), mierne nižší výkon pre disky spustených VM."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/host-samba",
|
||||
"label": "Samba / CIFS ako úložisko Proxmox",
|
||||
"tail": " — ďalšia možnosť na úrovni súborov; pre disky spustených VM sa neodporúča kvôli sémantike zámkov."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/host-local-disk",
|
||||
"label": "Pridať lokálny disk ako Proxmox úložisko",
|
||||
"tail": " — keď je disk lokálny pre hostiteľa Proxmox a nie na inom zariadení v sieti."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,186 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Host: Pridať lokálny disk ako Proxmox úložisko ProxMenux Dokumentácia",
|
||||
"description": "Naformátujte lokálny disk SATA, SAS alebo NVMe na hostiteľovi Proxmox a zaregistrujte ho ako adresárové úložisko alebo pool ZFS. Postup zahŕňa bezpečný výber disku, potvrdenie deštruktívnych operácií, fstab podľa UUID, vytvorenie poolu ZFS a príkazy pvesm add dir / zfspool.",
|
||||
"ogTitle": "Host: Pridať lokálny disk ako Proxmox úložisko ProxMenux Dokumentácia",
|
||||
"ogDescription": "Naformátujte lokálny disk a zaregistrujte ho ako adresár Proxmox alebo ZFS pool pomocou riadeného, bezpečnostne filtrovaného postupu."
|
||||
},
|
||||
"header": {
|
||||
"title": "Host: Pridať lokálny disk ako úložisko Proxmox",
|
||||
"description": "Vyberte fyzický disk na hostiteľovi Proxmox, prípadne ho naformátujte (ext4 / xfs / btrfs / zfs) a zaregistrujte ako úložisko Proxmox — adresár (pvesm add dir) alebo pool ZFS (pvesm add zfspool). ProxMenux odfiltruje systémový disk aj používané disky a pred vykonaním jasne uvedie každý deštruktívny krok.",
|
||||
"section": "Úložisko a zdieľanie · hostiteľ"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Čo to robí?",
|
||||
"body": "Ostatné nástroje pre <em>hostiteľa</em> v tejto časti pracujú so <strong>sieťovým</strong> úložiskom (NFS / Samba / iSCSI). Tento pracuje s <strong>lokálnymi</strong> diskami, teda voľnými diskami fyzicky pripojenými k hostiteľovi Proxmox, ktoré chcete použiť na disky VM, zálohy, ISO alebo šablóny. ProxMenux disk pripraví (rozdelenie + formátovanie + pripojenie) a zaregistruje v Proxmoxe, aby naň rozhranie mohlo ukladať obsah."
|
||||
},
|
||||
"destructive": {
|
||||
"title": "Deštrukčný nástroj pre \"formátovú\" dráhu",
|
||||
"body": "Postup <em>Formátovať</em> <strong>zničí existujúce oddiely a dáta na vybranom disku</strong>. ProxMenux zobrazí varovanie, odfiltruje používané disky a vyžiada potvrdenie pred spustením <code>wipefs</code> / <code>sgdisk</code> / <code>mkfs</code>. Nejde o bezpečné prepísanie každého bajtu. Pred potvrdením dvakrát overte cestu zariadenia."
|
||||
},
|
||||
"compare": {
|
||||
"heading": "Adresár alebo pool ZFS — čo si vybrať?",
|
||||
"headerDir": "Adresár (ext4 / xfs / btrfs)",
|
||||
"headerZfs": "ZFS pool",
|
||||
"rows": [
|
||||
{
|
||||
"label": "Typ skladovania Proxmoxu",
|
||||
"dirRich": "<code>dir</code>",
|
||||
"zfsRich": "<code>zfspool</code>"
|
||||
},
|
||||
{
|
||||
"label": "Formát disku VM",
|
||||
"dir": "Súbor qcow2 / raw na súborovom systéme",
|
||||
"zfs": "Natívny súbor údajov ZFS (zvol) na disk"
|
||||
},
|
||||
{
|
||||
"label": "Snímky",
|
||||
"dir": "qcow2 snímky; btrfs snímky, ak fs=btrfs",
|
||||
"zfs": "Natívne, okamžité, copy-on-write"
|
||||
},
|
||||
{
|
||||
"label": "Tenké prideľovanie",
|
||||
"dir": "Áno (predvolené pri qcow2)",
|
||||
"zfs": "Áno (predvolená hodnota ZFS)"
|
||||
},
|
||||
{
|
||||
"label": "RAM potreby",
|
||||
"dir": "nízka",
|
||||
"zfs": "Vysoké — ZFS používa voľnú RAM ako vyrovnávaciu pamäť ARC"
|
||||
},
|
||||
{
|
||||
"label": "Podporuje typy obsahu",
|
||||
"dir": "images, backup, iso, vztmpl, snippets, rootdir",
|
||||
"zfs": "iba images a rootdir (blokové úložisko)"
|
||||
},
|
||||
{
|
||||
"label": "Najlepšie pre",
|
||||
"dir": "Univerzálny disk: mix diskov VM, zálohy, ISO",
|
||||
"zfs": "Čistý dátový disk VM / LXC s snapshot + potreba integrity"
|
||||
}
|
||||
]
|
||||
},
|
||||
"opening": {
|
||||
"heading": "Otvorenie nástroja",
|
||||
"body": "V hlavnej ponuke ProxMenux otvorte <strong>Storage & Share Manager → Add Local Disk as Proxmox Storage</strong>. Zobrazí sa podponuka so štyrmi možnosťami:",
|
||||
"imageAlt": "Ponuka lokálnych diskov — Pridať / Zobraziť / Odstrániť / Vypísať dostupné disky"
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Ako beží skript (Pridať tok)",
|
||||
"body": "Postup má dve fázy s trojstupňovým bezpečnostným filtrom. Fáza 1 objavuje bezpečné disky, rozhoduje, čo robiť s vybraným a zbiera parametre úložiska; Fáza 2 robí deštruktívne práce. Až do posledného potvrdenia je disk nedotknutý."
|
||||
},
|
||||
"format": {
|
||||
"heading": "Formátovať prázdny disk",
|
||||
"intro": "Cesta pre čerstvý disk alebo ten, ktorého obsah vás nezaujíma.",
|
||||
"items": [
|
||||
"Vyberte disk (systém / používané disky sú skryté).",
|
||||
"Vyberte \"Format disk (EASE všetky dáta) .\"",
|
||||
"Vyberte súborový systém — porovnanie výhod a nevýhod je v tabuľke vyššie.",
|
||||
"ID úložiska (predvolene <code>disk-<device></code>), cesta pripojenia a predvoľba typu obsahu.",
|
||||
"Potvrďte v dialógu <strong>KONEČNÉ POTVRDENIE — DÁTA SA VYMAŽÚ</strong>.",
|
||||
"ProxMenux vymaže tabuľku oddielov a vytvorí jeden oddiel na celom disku. Spustí <code>mkfs.<fs></code> alebo <code>zpool create</code> a výsledok pripojí. Bežné súborové systémy dostanú položku UUID v <code>/etc/fstab</code> s <code>defaults,nofail</code>; ZFS používa konfiguráciu pripojenia poolu. Registrácia používa <code>pvesm add dir</code> alebo <code>pvesm add zfspool</code>."
|
||||
],
|
||||
"tipTitle": "Prečo UUID + nofail v /etc/fstab",
|
||||
"tipBody": "Skript zapíše <code>UUID=… /mnt/<id> <fs> defaults,nofail 0 2</code>. UUID zostane rovnaké aj pri zmene poradia zariadení po reštarte, takže premenovanie <code>/dev/sdc</code> na <code>/dev/sdd</code> nenaruší štart. S <code>nofail</code> sa Proxmox spustí aj pri chýbajúcom disku (porucha alebo odpojenie); úložisko sa bude zobrazovať ako neaktívne, kým sa disk nevráti."
|
||||
},
|
||||
"reuse": {
|
||||
"heading": "Znovu použiť existujúci súborový systém",
|
||||
"intro": "Cesta k disku, na ktorom si chcete ponechať údaje – možno ste ho presunuli z iného hostiteľa Proxmox alebo disk už obsahuje zálohy / ISO, ktoré chcete ponechať prístupné.",
|
||||
"items": [
|
||||
"Vyber ten disk.",
|
||||
"Vyberte \"Použiť existujúci súborový systém.\"",
|
||||
"ID úložiska, cesta pripojenia a predvoľba typu obsahu.",
|
||||
"ProxMenux dáta <strong>nemení</strong>: vytvorí bod pripojenia, pripojí disk, pridá položku UUID do <code>/etc/fstab</code> a zaregistruje ho ako úložisko Proxmox typu <code>dir</code>."
|
||||
],
|
||||
"warnTitle": "Opätovné použitie cesty nespracúva ZFS pools",
|
||||
"warnBody": "Ak už disk obsahuje ZFS pool, cesta <em>znova použiť</em> sa ho pokúsi pripojiť ako bežný súborový systém – čo zlyhá. Ak chcete importovať existujúci ZFS pool, použite <code>zpool import <name></code> na príkazovom riadku a potom ho manuálne zaregistrujte pomocou <code>pvesm add zfspool</code>."
|
||||
},
|
||||
"presets": {
|
||||
"heading": "Prednastavenia typu obsahu",
|
||||
"intro": "ProxMenux ponúka tri predvoľby a vlastnú možnosť. Vybraný reťazec typov obsahu odovzdá príkazu <code>pvesm add … --content <csv></code>:",
|
||||
"headerPreset": "Predvoľba",
|
||||
"headerContent": "Reťazec typov obsahu",
|
||||
"headerUse": "Prípad použitia",
|
||||
"rows": [
|
||||
{
|
||||
"preset": "Úložisko VM",
|
||||
"content": "images,backup",
|
||||
"use": "Vyhradené úložisko diskov VM, ktoré zároveň uchováva aj zálohy týchto VM."
|
||||
},
|
||||
{
|
||||
"preset": "Štandardné NAS",
|
||||
"content": "backup,iso,vztmpl",
|
||||
"use": "Archívny alebo mediálny disk — zálohy, ISO a šablóny LXC. Bez diskov používaných bežiacimi VM."
|
||||
},
|
||||
{
|
||||
"preset": "Všetky typy",
|
||||
"content": "images,backup,iso,vztmpl,snippets",
|
||||
"use": "Táto široká predvoľba povolí obrazy, zálohy, ISO, šablóny LXC a snippet súbory. Ďalšie podporované typy, napríklad rootdir, podľa potreby pridajte cez vlastnú možnosť."
|
||||
},
|
||||
{
|
||||
"preset": "Vlastné",
|
||||
"content": "(voľný vstup)",
|
||||
"useRich": "Napíšte presné CSV, napr. samotný <code>images</code> alebo <code>rootdir,images</code>."
|
||||
}
|
||||
],
|
||||
"zfsTitle": "ZFS pool obsah je užší",
|
||||
"zfsBody": "Pri <strong>zfs</strong> podporuje <code>zfspool</code> iba <code>images</code> a <code>rootdir</code>, nie súbory ISO či zálohy. Cez vlastnú možnosť zadajte podporované typy. Skript výber odovzdá bez zmien; nepodporované typy môžu spôsobiť zlyhanie registrácie. Potom overte <code>pvesm status</code>."
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Ručný ekvivalent",
|
||||
"extIntro": "Formát + zaregistrovať disk ako úložisko adresára ext4:",
|
||||
"zfsIntro": "Alebo ako ZFS pool:"
|
||||
},
|
||||
"view": {
|
||||
"heading": "Zobraziť diskové úložiská",
|
||||
"body": "Vypisuje všetky diskové úložiská Proxmox (<code>dir</code> aj <code>zfspool</code>, ktoré sú vytvorené používateľom — systémové pooly ako <code>rpool</code> je skrytý). Zobrazuje cestu pripojenia / pool názov, typy obsahu a aktuálny stav."
|
||||
},
|
||||
"remove": {
|
||||
"heading": "Odstrániť diskové úložisko",
|
||||
"body": "Odregistruje úložisko z Proxmoxu (<code>pvesm remove</code>) a ponúkne odstránenie príslušnej položky v <code>/etc/fstab</code>. Skript pool ZFS automaticky <strong>nezničí</strong>; na to slúži samostatný príkaz <code>zpool destroy <name></code>, ktorý vykonáte ručne, keď ste si istí.",
|
||||
"warnTitle": "Údaje a existujúce závislosti VM",
|
||||
"warnBody": "Odstránenie úložiska sa nedotkne súborového systému ani pool — údaje zostanú na disku. Ale virtuálne počítače / CT, ktoré odkazujú na toto úložisko podľa ID, sa po odstránení nespustia. Pred odstránením presuňte tieto VM disky na iné úložisko (alebo vytvorte zálohu)."
|
||||
},
|
||||
"list": {
|
||||
"heading": "Zoznam dostupných diskov",
|
||||
"body": "Diagnostický pohľad iba na čítanie: vytlačí výstup <code>lsblk -o NAME,SIZE,TYPE,FSTYPE,MOUNTPOINT,MODEL</code>, po ktorom nasleduje <code>dir</code> / <code>zfspool</code> úložiská, ktoré Proxmox už pozná. Dobrá prvá zastávka, keď otvoríte nástroj a chcete vidieť \"čo je na tomto hostiteľovi?\" pred pridaním niečoho."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Riešenie problémov",
|
||||
"noDisksTitle": "\"Nenájdené žiadne dostupné disky\"",
|
||||
"noDisksIntro": "Bezpečnostný filter skryl každý disk. Časté dôvody:",
|
||||
"noDisksItems": [
|
||||
"Prítomný je len koreňový disk.",
|
||||
"Každý iný disk je súčasťou aktívneho ZFS / LVM / RAID poľa.",
|
||||
"Každý iný disk je odkazovaný VM alebo LXC config (pass through).",
|
||||
"Disk je v režime iba na čítanie (zlyhanie hardvéru alebo write-blokátor)."
|
||||
],
|
||||
"noDisksOutro": "Použite <em>Zoznam dostupných diskov</em> z ponuky, aby ste videli nespracovaný výstup <code>lsblk</code> a pochopili, čo sa deje.",
|
||||
"mountedTitle": "Formát zlyhá s \"device is mounted\"",
|
||||
"mountedBody": "Niečo auto-montoval disk (udisksd, desktop manažér, pretrvávajúce systemd jednotka). Odpojte ho: <code>umount /dev/sdX?*</code> alebo <code>systemctl stop <whatever-mounts-it></code>, potom sa znovu skúste. Bezpečnostný filter skriptu by mal mať skryté namontované disky, takže ak ste dosiahli túto chybu, pripojiť sa stalo medzi zobrazením menu a potvrdením.",
|
||||
"zpoolTitle": "zpool create zlyhá s hlásením \"invalid vdev specification\"",
|
||||
"zpoolBody": "Zvyčajne to znamená, že disk má stále zastarané GPT / LVM / ZFS podpisy, ktoré <code>zpool</code> odmieta bez vynútenia prepísať. Skript pred formátovaním spustí <code>wipefs</code> a <code>sgdisk --zap-all</code>, ale veľmi tvrdohlavý disk môže mať stále zastaraný štítok. Manuálne vynútenie čistého vymazania: <code>zpool labelclear -f /dev/sdX</code> alebo <code>dd if=/dev/zero of=/dev/sdX bs=1M count=10</code> a skúste to znova.",
|
||||
"inactiveTitle": "Skladovanie ukazuje ako neaktívne po reštarte",
|
||||
"inactiveBody": "Skontrolujte <code>findmnt <mount-path></code>. Ak pripojenie chýba, zlyhalo niečo v <code>/etc/fstab</code>. Výstup <code>dmesg | tail</code> zvyčajne ukáže príčinu, napríklad nesúlad UUID, poškodenie súborového systému alebo vynechanie ďalšieho pokusu v súvislosti s <code>nofail</code>. Po odstránení príčiny príkaz <code>mount -a</code> zvyčajne úložisko znovu pripojí."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/disk-manager/format-disk",
|
||||
"label": "Správca diskov: formátovanie / vymazanie fyzického disku",
|
||||
"tail": "— nízkoúrovňová alternatíva, keď chcete iba pripraviť disk bez toho, aby ste ho registrovali ako úložisko Proxmox."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/host-iscsi",
|
||||
"label": "Pridať iSCSI target ako Proxmox úložisko",
|
||||
"tail": " — sieťový ekvivalent, ak je blokové zariadenie na inom počítači."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/host-local-shared",
|
||||
"label": "Pridať zdieľaný adresár na hostiteľa",
|
||||
"tail": " — príprava adresára na hostiteľovi pre bind mounty LXC (bez registrácie úložiska Proxmox)."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,103 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Hostiteľ: Pridanie zdieľaného adresára | Dokumentácia ProxMenux",
|
||||
"description": "Vytvorte adresár hostiteľa pripravený pre bind mounty LXC s oprávneniami pre privilegované aj neprivilegované kontajnery. Sticky bit, rwx pre všetkých a predvolené ACL pre dedenie.",
|
||||
"ogTitle": "Hostiteľ: Pridanie zdieľaného adresára | Dokumentácia ProxMenux",
|
||||
"ogDescription": "Pripravte si hostiteľský adresár pre bind mounty LXC s oprávneniami kompatibilnými s privilegovanými a neprivilegovanými CT."
|
||||
},
|
||||
"header": {
|
||||
"title": "Hostiteľ: Pridať zdieľaný adresár",
|
||||
"description": "Vytvorte adresár na hostiteľovi určený pre bind mounty v jednom alebo viacerých kontajneroch LXC. ProxMenux použije oprávnenia pre privilegované aj neprivilegované CT bez riešenia posunutých UID alebo zmeny vlastníka pre každý kontajner a zaregistruje adresár na neskoršie použitie v LXC Mount Manager.",
|
||||
"section": "Úložisko a zdieľanie · hostiteľ"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Čo je toto (a NIE)",
|
||||
"body": "Tento nástroj <strong>nič</strong> neregistruje v Proxmoxe (nepoužíva <code>pvesm add</code>). Iba pripraví adresár na hostiteľovi — predvolene <code>/mnt/shared</code> — s oprávneniami na čítanie a zápis pre ľubovoľný LXC bez ohľadu na privilegovaný či neprivilegovaný režim. Ďalším krokom je zvyčajne bind mount do jednotlivých CT cez <mountLink>LXC Mount Manager</mountLink>."
|
||||
},
|
||||
"why": {
|
||||
"heading": "Prečo je to špecializovaný nástroj",
|
||||
"intro": "Keď pripojíte adresár do LXC kontajnera, práva závisia od:",
|
||||
"items": [
|
||||
"Či je CT <strong>privilegovaný</strong> (UID 0 v CT = UID 0 na hostiteľovi) alebo <strong>neprivilegovaný</strong> (UID 0 v CT = UID 100000 na hostiteľovi — všetko je posunuté o +100000).",
|
||||
"Vlastníctvo adresára hostiteľa (súbor s UID 1000 na hostiteľovi sa z pohľadu neprivilegovaného CT riadi oprávneniami „ostatní“, pretože žiadny používateľ CT sa nemapuje na UID 1000 hostiteľa).",
|
||||
"Či viaceré CT zdieľajú rovnaký adresár (rôzne CT môžu mať rôzne UID rozsahy)."
|
||||
],
|
||||
"outro": "ProxMenux používa praktický postup: <strong>poskytnúť prístup všetkým</strong> na úrovni súborového systému pomocou rwx pre všetkých, sticky bitu a ACL na dedenie oprávnení. Každé mapované UID môže čítať a zapisovať; netreba zosúlaďovať UID/GID."
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Ako beží skript",
|
||||
"body": "Skript nemá žiadne hlavné menu – spúšťa jedinú akciu, <strong>Vytvoriť zdieľaný adresár</strong>. Fáza 1 zhromažďuje cieľovú cestu; Fáza 2 vytvorí adresár a použije povolenia."
|
||||
},
|
||||
"bits": {
|
||||
"heading": "Čo robia jednotlivé bity oprávnení",
|
||||
"intro": "Číslo <strong>1777</strong> nie je náhodné — rovnaký režim Linux používa pre <code>/tmp</code>. Kombinuje tri vlastnosti:",
|
||||
"headerBit": "Bit",
|
||||
"headerEffect": "Účinok",
|
||||
"headerWhy": "Prečo na tom záleží tu",
|
||||
"rows": [
|
||||
{
|
||||
"bit": "1 (sticky bit)",
|
||||
"effect": "Súbor môže odstrániť alebo premenovať jeho vlastník, vlastník adresára alebo proces s dostatočnými oprávneniami.",
|
||||
"why": "Pomáha zabrániť používateľom s rôznymi mapovanými UID odstraňovať cudzie súbory. Neizoluje CT s rovnakým mapovaným UID alebo privilegovaným prístupom root."
|
||||
},
|
||||
{
|
||||
"bit": "777 (rwx-rwx-rwx)",
|
||||
"effect": "Každý vie čítať, písať a prechádzať.",
|
||||
"why": "Neprivilegované CT UID (100000+) sa objavujú ako \"ostatné\" z hostiteľa, takže svet-rwx im dáva prístup."
|
||||
},
|
||||
{
|
||||
"bit": "ACL (predvolené)",
|
||||
"effect": "Dedia sa pri vytvorení každého súboru alebo podadresára.",
|
||||
"why": "Nový obsah zdedí predvolené ACL bez opätovného spustenia skriptu. Aplikácie však môžu požadovať obmedzujúce režimy alebo neskôr zmeniť oprávnenia."
|
||||
}
|
||||
],
|
||||
"privTitle": "Privilegované CT vidia to isté, len bez zmeny.",
|
||||
"privBody": "V privilegovanom CT je UID 0 totožné s UID 0 na hostiteľovi, takže <code>root</code> v CT môže priamo čítať a zapisovať do adresára hostiteľa. Režim <code>1777</code> je naďalej vhodný — umožňuje používanie adresára aj používateľom CT mimo root. Rovnaké oprávnenia pokrývajú oba prípady."
|
||||
},
|
||||
"where": {
|
||||
"heading": "Kam dať zdieľaný adresár",
|
||||
"intro": "Výber umiestnenia ponúka štyri možnosti:",
|
||||
"opt1Title": "1. Vytvoriť nový priečinok v /mnt",
|
||||
"opt1Body": "Zvyčajná voľba. ProxMenux auto-navrhuje prvý voľný názov (<code>shared</code>, <code>shared2</code>, <code>shared3</code>, ...). Stačí potvrdiť alebo napísať iný názov.",
|
||||
"opt2Title": "2. Zadajte vlastnú cestu",
|
||||
"opt2Body": "Pre adresáre mimo <code>/mnt</code>. Akákoľvek absolútna cesta funguje (napr. <code>/srv/media</code>, <code>/data/family</code>). Skript uplatňuje rovnaké práva.",
|
||||
"opt3Title": "3. Zobraziť existujúce priečinky v /mnt",
|
||||
"opt3Body": "Diagnostika iba na čítanie: uvádza každý adresár pod <code>/mnt</code> so svojimi oprávneniami, vlastníkom a dostupným priestorom. Užitočné pred vytvorením nového, aby sa zabránilo pomenovaniu kolízie.",
|
||||
"opt4Title": "4. Zrušiť",
|
||||
"opt4Body": "Ukončí postup bez vytvorenia čohokoľvek. Rovnako ako stlačenie <kbd>Esc</kbd>.",
|
||||
"tipTitle": "Kde žije /mnt?",
|
||||
"tipBody": "Predvolene sa <code>/mnt</code> nachádza na koreňovom súborovom systéme Proxmox. Ak má byť zdieľaný adresár na inom disku (dátový disk alebo pool ZFS), najprv ho pripojte pod <code>/mnt/<name></code> cez Disk Manager alebo <diskLink>Pridať lokálny disk ako úložisko Proxmox</diskLink>. Potom vytvorte zdieľaný podadresár v ňom alebo tu vyberte „Zadať vlastnú cestu“ a zadajte cestu pripojeného disku."
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Ručný ekvivalent",
|
||||
"body": "Celý tok sa dá prehrať ručne:"
|
||||
},
|
||||
"next": {
|
||||
"heading": "Ďalší krok: bind mount do kontajnerov",
|
||||
"body": "Vytvorením adresára sa iba pripraví – zatiaľ ho nevidí žiadny kontajner. Aby bolo viditeľné v jednom alebo viacerých LXC, použite <mountLink>LXC Mount Manager</mountLink> na pripojenie <code>/mnt/<name></code> do CT. Pretože oprávnenia sú už otvorené, Mount Manager <strong>neponúkne</strong> ich zmenu – adresár je pripravený na použitie tak, ako je."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Riešenie problémov",
|
||||
"mkdirTitle": "\"Failed to create directory\"",
|
||||
"mkdirBody": "Zvyčajne je problém súborového systému: <code>/mnt</code> je na súborovom systéme iba na čítanie, cesta obsahuje komponent, ktorý nie je adresárom (napr. ste zadali <code>/etc/passwd/sub</code>), alebo disk je plný. Overte si to s <code>df -h /mnt</code> a <code>mount | grep /mnt</code>.",
|
||||
"writeTitle": "Kontajner nemôže písať napriek otvoreným povoleniam",
|
||||
"writeBody": "Overte, či CT skutočne používa bind mount (<code>pct config <ctid> | grep ^mp</code>). V CT spustite <code>touch /mnt/data/test-$(date +%s)</code>. Ak príkaz zlyhá s odmietnutým prístupom, pripojenie môže byť na súborovom systéme hostiteľa bez podpory ACL (niektoré staršie pripojenia <code>ext3</code> alebo <code>vfat</code>). Presuňte zdieľaný adresár na súborový systém ext4, xfs, btrfs alebo zfs.",
|
||||
"aclTitle": "ACL príkazy ticho nedostupné",
|
||||
"aclBody": "Na minimálnej inštalácii Proxmox nemusia byť <code>setfacl</code> / <code>getfacl</code> nainštalované. Skript to overí cez <code>command -v setfacl</code> a použije iba oprávnenia POSIX. Tie často stačia, no nové súbory automaticky nezdedia otvorené oprávnenia. Nainštalujte <code>acl</code> pomocou <code>apt-get install -y acl</code> a spustite skript pre daný adresár znova."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-mount-points",
|
||||
"label": "Správca LXC mountov",
|
||||
"tail": " — ďalší bežný krok: bind mount tohto adresára do jedného alebo viacerých kontajnerov."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/host-local-disk",
|
||||
"label": "Pridať lokálny disk ako Proxmox úložisko",
|
||||
"tailRich": " — Ak chcete zdieľaný adresár na vyhradenom disku, pripravte najprv disk, pripojte ho pod <code>/mnt</code>, potom tu vytvorte zdieľaný podpriečinok."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,174 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Hostiteľ: pripojenie zdieľania NFS | Dokumentácia ProxMenux",
|
||||
"description": "Pripojte externý export NFS na hostiteľovi Proxmox ako úložisko Proxmox cez pvesm add nfs, ako samostatné pripojenie cez fstab neviditeľné v Datacenter > Storage alebo oboma spôsobmi. Metóda fstab je vhodná na sprístupnenie cesty kontajnerom LXC cez bind mount bez registrácie úložiska v Proxmoxe.",
|
||||
"ogTitle": "Hostiteľ: pripojenie zdieľania NFS | Dokumentácia ProxMenux",
|
||||
"ogDescription": "Pripojte externý export NFS na hostiteľovi Proxmox cez pvesm, fstab alebo oboje. Spôsob fstab je vhodný pre bind mounty LXC."
|
||||
},
|
||||
"header": {
|
||||
"title": "Hostiteľ: pripojiť zdieľanie NFS na hostiteľovi",
|
||||
"description": "Pripojte externý export NFS z NAS, iného servera alebo domáceho labu k hostiteľovi Proxmox. Môžete ho zaregistrovať ako úložisko Proxmox viditeľné v Datacenter > Storage, pridať samostatné pripojenie cez /etc/fstab na zvolenú cestu alebo použiť oba spôsoby. Samostatná cesta je vhodná na sprístupnenie zdieľania kontajnerom LXC pomocou bind mountu bez registrácie úložiska v Proxmoxe.",
|
||||
"section": "Úložisko a zdieľanie · hostiteľ"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Čo to robí?",
|
||||
"body": "ProxMenux ponúka dva spôsoby pripojenia exportu NFS: <strong>(1) Úložisko Proxmox</strong> pomocou <code>pvesm add nfs</code>. Zdieľanie sa zobrazí v Datacenter > Storage a Proxmox spravuje pripojenie na <code>/mnt/pve/<id></code>. <strong>(2) Pripojenie cez fstab na hostiteľovi</strong> na zvolenú cestu, trvalo zapísané v <code>/etc/fstab</code>. Nezobrazí sa ako úložisko Proxmox a hodí sa na bind mounty do kontajnerov LXC bez ďalších položiek v rozhraní Proxmoxu. Môžete použiť jeden alebo oba spôsoby."
|
||||
},
|
||||
"opening": {
|
||||
"heading": "Otvorenie nástroja",
|
||||
"body": "V hlavnej ponuke ProxMenux otvorte <strong>Storage & Share Manager → Mount NFS Share on Host</strong>. Zobrazí sa podponuka so štyrmi možnosťami:",
|
||||
"imageAlt": "Ponuka NFS hostiteľa — Pripojiť / Zobraziť / Odstrániť / Testovať pripojenie"
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Ako beží skript",
|
||||
"body": "Postup má dve jasne oddelené fázy: vyhľadanie, overenie a výber, potom samotné pripojenie a zápis konfigurácie. Po výbere exportu zvolíte metódy pripojenia v zozname. Ďalšie dialógy sa pýtajú iba na parametre vybraných metód. Až do záverečného potvrdenia sa nemení ani <code>/etc/pve/storage.cfg</code>, ani <code>/etc/fstab</code>."
|
||||
},
|
||||
"modes": {
|
||||
"heading": "Výber spôsobu pripojenia (označte jednu alebo obe možnosti)",
|
||||
"intro": "Po výbere a overení exportu zobrazí ProxMenux zoznam dvoch spôsobov pripojenia. Môžete označiť jeden alebo oba. Ak stlačíte OK bez výberu, dialóg sa otvorí znovu. Vyberte aspoň jednu možnosť alebo postup ukončite tlačidlom Zrušiť.",
|
||||
"imageAlt": "Výber spôsobov pripojenia s možnosťami pvesm a fstab",
|
||||
"headerMethod": "Metóda",
|
||||
"headerMount": "Cesta pripojenia",
|
||||
"headerUi": "Viditeľné v datacentre > Úložisko",
|
||||
"headerUseCase": "Typický prípad použitia",
|
||||
"rows": [
|
||||
{
|
||||
"method": "<strong>Ako úložisko Proxmox (pvesm)</strong>",
|
||||
"mountRich": "<code>/mnt/pve/<storage-id></code> (manažovaný spoločnosťou Proxmox)",
|
||||
"ui": "Áno",
|
||||
"useCase": "VM obrazy diskov, zálohy, ISO, LXC šablóny — čokoľvek, čo sa musí objaviť v Proxmox UI."
|
||||
},
|
||||
{
|
||||
"method": "<strong>Iba fstab hostiteľa</strong>",
|
||||
"mountRich": "<code>/mnt/<path></code> (vyberiete cestu)",
|
||||
"ui": "Nie",
|
||||
"useCaseRich": "Sprístupnite zdieľanie jednému alebo viacerým LXC cez bind mount <em>bez</em> registrácie úložiska Proxmox. Rozhranie Datacenter zostane prehľadné."
|
||||
},
|
||||
{
|
||||
"method": "<strong>Obe</strong>",
|
||||
"mount": "Obe cesty uvedené vyššie (dva body pripojenia toho istého exportu NFS)",
|
||||
"ui": "Áno",
|
||||
"useCase": "Integrácia s rozhraním a samostatná stabilná cesta hostiteľa s otvorenými oprávneniami pre bind mounty LXC."
|
||||
}
|
||||
],
|
||||
"bothTitle": "Možnosť „Oboje“ vytvorí dve nezávislé pripojenia NFS",
|
||||
"bothBody": "Obe metódy sa vykonajú samostatne: pvesm pripojí export do <code>/mnt/pve/<id></code> a fstab do <code>/mnt/<path></code>. Získate pripojenie spravované Proxmoxom s predvolenými voľbami a samostatné pripojenie hostiteľa pre bind mounty LXC. Dva body pripojenia nezaručujú dve spojenia TCP; klient NFS môže transportné spojenia opätovne použiť."
|
||||
},
|
||||
"pvesmBranch": {
|
||||
"heading": "Metóda A — ako úložisko Proxmox (pvesm)",
|
||||
"intro": "Ak je <em>Ako úložisko Proxmox</em> označený, ProxMenux spustí pôvodný pvesm prietok:",
|
||||
"items": [
|
||||
"<strong>ID úložiska</strong> — názov, pod ktorým Proxmox toto úložisko zaregistruje. Predvolene je to <code>nfs-<server-ip-with-dashes></code>. Povolené sú iba písmená, číslice, <code>-</code> a <code>_</code>.",
|
||||
"<strong>Typy obsahu</strong> Proxmox viaže kategórie obsahu na úložné objemy; vyberte si, čo to NFS je povolené držať:"
|
||||
],
|
||||
"headerType": "Typ obsahu",
|
||||
"headerAllows": "Čo to umožňuje",
|
||||
"rows": [
|
||||
{
|
||||
"type": "import",
|
||||
"allowsRich": "Import obrazu disku (štandardne vybraný). Potrebné pre <em>Import Disk Image na VM</em>."
|
||||
},
|
||||
{
|
||||
"type": "backup",
|
||||
"allowsRich": "VM a CT záložné súbory (<code>vzdump</code>)."
|
||||
},
|
||||
{
|
||||
"type": "iso",
|
||||
"allows": "Inštalačné obrazy ISO."
|
||||
},
|
||||
{
|
||||
"type": "vztmpl",
|
||||
"allows": "Šablóny LXC."
|
||||
},
|
||||
{
|
||||
"type": "images",
|
||||
"allows": "Obrazy diskov používaných VM — NFS tak slúži ako úložisko diskov VM."
|
||||
},
|
||||
{
|
||||
"type": "rootdir",
|
||||
"allows": "Koreňové súborové systémy LXC (pri NFS nezvyčajné — prečítajte si poznámku nižšie)."
|
||||
},
|
||||
{
|
||||
"type": "snippets",
|
||||
"allows": "Hook skripty a snippet súbory cloud-init."
|
||||
}
|
||||
],
|
||||
"warnTitle": "images a rootdir na NFS",
|
||||
"warnBody": "Voľba <code>images</code> umožní ukladať disky VM na NFS. Výkon závisí od siete, servera a záťaže; výpadok môže zablokovať vstupno-výstupné operácie závislé od pripojenia. Voľba <code>rootdir</code> ukladá koreňové súborové systémy LXC na NFS, kde môžu neprivilegované kontajnery naraziť na obmedzenia mapovania UID, overlay a vlastníctva. Zvážte to pred umiestnením <code>images</code> / <code>rootdir</code>; NFS je vhodné aj pre <code>backup</code> / <code>iso</code> / <code>vztmpl</code>.",
|
||||
"result": "Výsledok je <code>pvesm add nfs <id> --server <srv> --export <path> --content <csv></code> a Proxmox auto-mounts na <code>/mnt/pve/<id></code>."
|
||||
},
|
||||
"fstabBranch": {
|
||||
"heading": "Metóda B — iba pripojenie cez fstab hostiteľa",
|
||||
"intro": "Ak <em>Iba pripojenie cez fstab hostiteľa</em> je označený, ProxMenux požiada o cestu pripojenia hostiteľa a trvalé možnosti, potom sa pripojí a napíše položku na <code>/etc/fstab</code>:",
|
||||
"items": [
|
||||
"<strong>Cesta pripojenia k hostiteľovi</strong> Predvolené <code>/mnt/<export-basename></code>. Musí to byť absolútna cesta. Ak je tam niečo už namontované, alebo existuje fstab položka pre tú istú cestu, ProxMenux Varuje vás a ponúka, že ho nahradíte.",
|
||||
"<strong>Voľby pripojenia</strong> — <em>Čítanie/zápis</em> (predvolené: <code>rw,hard,nofail,_netdev,rsize=131072,wsize=131072,timeo=600,retrans=2</code>), <em>Iba na čítanie</em>, <em>Vlastné</em> (zadajte vlastné voľby)."
|
||||
],
|
||||
"appliesIntro": "Keď potvrdíte, skript:",
|
||||
"applies": [
|
||||
"Vytvorí adresár bodu pripojenia pomocou <code>mkdir -p</code>.",
|
||||
"<code>mount -t nfs -o <opts> <srv>:<export> <path></code>.",
|
||||
"Napíše jednoriadkový zápis do <code>/etc/fstab</code>: <code><srv>:<export> <path> nfs <opts> 0 0</code>.",
|
||||
"Spustí <code>systemctl daemon-reload</code> takže systemd zachytí novú fstab položku.",
|
||||
"Pokúsi sa vykonať <code>chmod 1777</code> a <code>setfacl o::rwx</code> na bode pripojenia. Operácia je nezáväzná a nehlási zlyhanie: uspeje iba vtedy, ak ju server NFS povolí. Mnohé exporty NAS už umožňujú zápis všetkým používateľom."
|
||||
],
|
||||
"lxcTitle": "Použitie pripojenia fstab z LXC",
|
||||
"lxcBody": "Skript vypíše príkaz <code>pct set</code> pre bind mount, napríklad <code>pct set <ctid> -mp0 /mnt/<path>,mp=/mnt/<ct-path>,shared=1,backup=0</code>. Alebo použite <mountLink>LXC Mount Manager</mountLink>, ktorý rozpozná pripojenia fstab. <strong>V kontajneri sa nič nemení</strong>. Prístup neprivilegovaného CT závisí od oprávnení servera pre jeho mapované UID/GID. Skript sa len pokúsi upraviť oprávnenia z hostiteľa; nezaručuje zapisovateľné exporty ani predvolené nastavenia výrobcov. Pri problémoch pozrite riešenie problémov.",
|
||||
"noUiTitle": "Pripojenie fstab NIE JE úložiskom Proxmox",
|
||||
"noUiBody": "Hostiteľský fstab mount je neviditeľný pre web Proxmox UI — podľa návrhu. Nezobrazuje sa v <em>Datacenter > Storage</em>, nemôžete ho vybrať v tvorcovi VM / CT a úlohy zálohovania Proxmox sa naň nemôžu zamerať. Je to čisto cesta hostiteľského súborového systému. Ak chcete aj integráciu UI, označte vo výbere <em>obe</em> metódy."
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Ručný ekvivalent",
|
||||
"pvesmIntro": "Metóda A (pvesm) zodpovedá:",
|
||||
"fstabIntro": "Metóda B (fstab) zodpovedá:"
|
||||
},
|
||||
"view": {
|
||||
"heading": "Zobraziť nakonfigurované úložiská NFS",
|
||||
"body": "Vypíše položky NFS v Proxmoxe (<code>pvesm status | awk ''$2 == \"nfs\"''</code>) so serverom, exportom, typmi obsahu, cestou pripojenia a aktuálnym stavom. <strong>Poznámka:</strong> zobrazí iba úložiská registrované cez pvesm, nie samostatné pripojenia fstab. Tie overte pomocou <code>findmnt -t nfs</code> alebo <code>grep nfs /etc/fstab</code>."
|
||||
},
|
||||
"remove": {
|
||||
"heading": "Odstrániť úložisko NFS",
|
||||
"body": "Po potvrdení so serverom, exportom a obsahom spustí <code>pvesm remove <storage-id></code>. Odstráni iba registráciu v Proxmoxe; <strong>vzdialený server NFS nemení</strong> a súbory neodstráni. Samostatné pripojenie fstab odstráňte ručnou úpravou <code>/etc/fstab</code> a príkazom <code>umount <path></code>.",
|
||||
"warnTitle": "Zálohovanie závislostí najprv",
|
||||
"warnBody": "Ak VM, CT alebo úlohy zálohovania odkazujú na ID tohto úložiska, po odstránení budú odkazovať na neexistujúce úložisko. Proxmox ohlási chybu, ale odkazy neodstráni. Najprv ich presuňte alebo odstráňte a až potom odstráňte úložisko."
|
||||
},
|
||||
"test": {
|
||||
"heading": "Test NFS konektivita",
|
||||
"body": "Spustí diagnostický prechod cez každý NFS skladovanie registrované v Proxmoxe: kontroluje, či <code>showmount</code> je k dispozícii, <code>rpcbind</code> beží, pings každý server, sondy port 2049, volá <code>showmount -e</code>, a nakoniec uvádza Proxmox vlastný názor (<code>pvesm status</code>). Dobrá prvá zastávka, keď úložisko ukazuje ako <em>neaktívny</em> v Proxmoxe UI."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Riešenie problémov",
|
||||
"noServersTitle": "\"Žiadne NFS servery nájdené v sieti\"",
|
||||
"noServersBody": "Automatické vyhľadávanie používa <code>nmap -p 2049 --open <subnet>/24</code>. Server nemusí reagovať, ak: je na inom VLAN / subnet, jeho firewall bloky nmap sondy (mnohý robiť) alebo port 2049 je zámerne uzavretý na tomto rozhraní. Použite možnosť <em>Manual</em> s IP alebo meno hostiteľa servera.",
|
||||
"portTitle": "„Port NFS (2049) nie je dostupný“",
|
||||
"portBody": "Ping uspel, ale <code>nc -z -w 3 <server> 2049</code> zlyhal. Skontrolujte, či služba NFS beží na serveri (<code>systemctl status nfs-server</code> na Linuxe, Ovládací panel → Súborové služby na Synology, NFS plugin na OMV / TrueNAS), a že firewall umožňuje 2049 z Proxmox hostiteľa.",
|
||||
"showmountTitle": "„Failed to connect“ z príkazu showmount",
|
||||
"showmountBody": "Server odmietol dotaz exportného zoznamu. Bežné príčiny: server vymáha prísne klientske ACL (vaše Proxmox IP nie je na povolenom zozname), <code>rpcbind</code> nebeží na serveri, alebo server vystaví iba NFSv4 s <code>showmount</code> vypnutým. Exportná cesta môže byť stále pridaná ručne, ak ju poznáte.",
|
||||
"inactiveTitle": "Úložisko ukazuje ako neaktívne v systéme Proxmox UI",
|
||||
"inactiveBody": "Spustite <em>Testovať pripojenie NFS</em> a overte DNS, porty aj prístup. Ak spojenie funguje, ale úložisko zostáva neaktívne, skontrolujte <code>journalctl -u pvestatd</code> a konfiguráciu servera/exportu. Najprv opravte spojenie alebo oprávnenia. Príkaz <code>pvesm set <id> --disable 0</code> zapne vypnuté úložisko; nie je všeobecnou opravou chýb NFS.",
|
||||
"lxcNoWriteTitle": "Pripojenie fstab funguje, ale neprivilegovaný LXC nemôže zapisovať cez bind mount",
|
||||
"lxcNoWriteBody": "Prístup NFS závisí od vlastníkov, ACL a nastavení squash na serveri. Voľby CIFS <code>uid=</code> a <code>file_mode=</code> pre NFS <strong>neplatia</strong>. Pri predvolenom mapovaní LXC má root z CT na hostiteľovi UID 100000, nie vzdialené UID 0. Povoľte prístup skutočnému mapovanému UID/GID alebo anonymnej identite servera. <code>no_root_squash</code> ovplyvňuje iba vzdialené UID 0 a nie je všeobecným riešením pre UID 100000. Skript skúsi <code>chmod 1777</code>, ale oprávnenia servera neobíde.",
|
||||
"fstabBootTitle": "fstab mount nepríde po reštarte",
|
||||
"fstabBootBody": "Skript pridáva <code>nofail,_netdev</code>, aby nedostupné zdieľanie pri štarte neblokovalo spúšťanie systému. Ak sa nepripojí vôbec, overte dostupnosť siete pomocou <code>ping <server></code>, skontrolujte <code>journalctl -u remote-fs.target</code> a platnosť záznamu pomocou <code>mount -fav | grep nfs</code>. Príkaz <code>mount -a</code> po štarte pripojí položky, ktoré zatiaľ chýbajú."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/storage-share/host-samba",
|
||||
"label": "Samba / CIFS ako úložisko Proxmox",
|
||||
"tail": " — Rovnaký vzorec prietoku (Metóda A pvesm + metóda B fstab) pre zdieľania SMB/CIFS."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-mount-points",
|
||||
"label": "Správca LXC mountov",
|
||||
"tailRich": " Pripojiť cestu, ktorá je určená len pre fstab <code>/mnt/<path></code> do jedného alebo viacerých kontajnerov."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-nfs-client",
|
||||
"label": "NFS klient v LXC",
|
||||
"tail": " Alternatíva: pripojte NFS priamo zvnútra privilegovaného kontajnera (obíde hostiteľa)."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,172 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Hostiteľ: pripojenie zdieľania Samba | Dokumentácia ProxMenux",
|
||||
"description": "Pripojte externé zdieľanie Samba / CIFS na hostiteľovi Proxmox: ako úložisko Proxmox (pvesm add cifs), ako bežné pripojenie cez fstab hostiteľa s otvorenými oprávneniami uid/gid/file_mode (NEZOBRAZUJE sa v Datacenter > Storage), alebo oboma spôsobmi. Metóda fstab otvorí oprávnenia, aby neprivilegovaný LXC s bind mountom tejto cesty mohol čítať a zapisovať bez zmien v kontajneri.",
|
||||
"ogTitle": "Hostiteľ: pripojenie zdieľania Samba | Dokumentácia ProxMenux",
|
||||
"ogDescription": "Pripojte externé zdieľanie Samba / CIFS na hostiteľovi Proxmox cez pvesm, fstab s otvorenými oprávneniami pre bind mounty LXC alebo oboje."
|
||||
},
|
||||
"header": {
|
||||
"title": "Hostiteľ: pripojiť zdieľanie Samba na hostiteľovi",
|
||||
"description": "Pripojte externé zdieľanie Samba (SMB / CIFS) z NAS, počítača Windows alebo exportu SMB TrueNAS na hostiteľovi Proxmox. Vyberte jeden alebo oba spôsoby: registráciu úložiska Proxmox viditeľného v Datacenter > Storage a samostatné pripojenie cez /etc/fstab na zvolenú cestu. Otvorené voľby uid/gid/file_mode umožnia neprivilegovaným LXC používať bind mount bez zmien vnútri kontajnera.",
|
||||
"section": "Úložisko a zdieľanie · hostiteľ"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Čo to robí?",
|
||||
"body": "ProxMenux ponúka dva spôsoby pripojenia zdieľania Samba: <strong>(1) Úložisko Proxmox</strong> cez <code>pvesm add cifs</code>, viditeľné v Datacenter > Storage a pripojené do <code>/mnt/pve/<id></code>. Heslo sa uchováva v otvorenom texte v <code>/etc/pve/priv/storage/<id>.pw</code>, chránené súkromným adresárom prístupným iba root. Ide o riadenie prístupu, nie šifrovanie. <strong>(2) Pripojenie fstab na hostiteľovi</strong> do zvolenej cesty, trvalé cez <code>/etc/fstab</code> a s voľbami <code>uid=0,gid=0,file_mode=0777,dir_mode=0777</code>, aby neprivilegované LXC mohli zapisovať cez bind mounty. Prihlasovacie údaje sú v súbore pre root v <code>/etc/samba/credentials/</code>, nikdy priamo vo <code>fstab</code>. Možno použiť jeden spôsob alebo oba."
|
||||
},
|
||||
"opening": {
|
||||
"heading": "Otvorenie nástroja",
|
||||
"body": "V hlavnej ponuke ProxMenux otvorte <strong>Storage & Share Manager → Mount Samba Share on Host</strong>. Zobrazí sa podponuka so štyrmi možnosťami:",
|
||||
"imageAlt": "Ponuka Samba hostiteľa — Pripojiť / Zobraziť / Odstrániť / Testovať pripojenie"
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Ako beží skript",
|
||||
"body": "Postup má dve fázy. Najprv vyhľadá server, overí prihlasovacie údaje, vyberie zdieľanie a spôsoby pripojenia. Potom vykoná iba vybrané metódy. Prihlasovacie údaje potrebuje vopred, pretože <code>smbclient</code> ich používa na výpis zdieľaní. Do záverečného potvrdenia nemení <code>/etc/pve/storage.cfg</code> ani <code>/etc/fstab</code>."
|
||||
},
|
||||
"modes": {
|
||||
"heading": "Výber spôsobu pripojenia (označte jednu alebo obe možnosti)",
|
||||
"intro": "Po výbere zdieľania a overení prihlasovacích údajov zobrazí ProxMenux zoznam dvoch spôsobov pripojenia. Môžete označiť jeden alebo oba. Ak stlačíte OK bez výberu, dialóg sa otvorí znovu. Vyberte aspoň jednu možnosť alebo postup ukončite tlačidlom Zrušiť.",
|
||||
"headerMethod": "Metóda",
|
||||
"headerMount": "Cesta pripojenia",
|
||||
"headerUi": "Viditeľné v datacentre > Úložisko",
|
||||
"headerUseCase": "Typický prípad použitia",
|
||||
"rows": [
|
||||
{
|
||||
"method": "<strong>Ako úložisko Proxmox (pvesm)</strong>",
|
||||
"mountRich": "<code>/mnt/pve/<storage-id></code> (manažovaný spoločnosťou Proxmox)",
|
||||
"ui": "Áno",
|
||||
"useCase": "Zálohy, obrazy ISO a šablóny LXC — všetko, čo má byť viditeľné v rozhraní Proxmox. Aktívne disky VM sú technicky podporované, ale pri CIFS sa neodporúčajú pre odlišné správanie zámkov."
|
||||
},
|
||||
{
|
||||
"method": "<strong>Iba fstab hostiteľa</strong>",
|
||||
"mountRich": "<code>/mnt/<path></code> s otvoreným uidom/gid/file_mode",
|
||||
"ui": "Nie",
|
||||
"useCaseRich": "Sprístupnite zdieľanie LXC cez bind mount <em>bez</em> registrácie úložiska Proxmox. Otvorené lokálne oprávnenia pomôžu neprivilegovaným CT, ale zápis stále musí povoliť server SMB overenému používateľovi."
|
||||
},
|
||||
{
|
||||
"method": "<strong>Obe</strong>",
|
||||
"mount": "Obe cesty uvedené vyššie (dva body pripojenia toho istého exportu CIFS)",
|
||||
"ui": "Áno",
|
||||
"useCase": "Chcete UI integráciu A stabilnú cestu na strane hostiteľa s otvorenými právami pre LXC viazanie-mounts. Pripojenie pvesm používa predvolené nastavenia Proxmox; pripojka fstab aplikuje otvorené uid/gid/file_mode samostatne."
|
||||
}
|
||||
],
|
||||
"bothTitle": "„Oboje“ vytvorí dva body pripojenia CIFS",
|
||||
"bothBody": "pvesm pripojí zdieľanie do <code>/mnt/pve/<id></code> s predvolenými voľbami Proxmoxu. fstab používa <code>/mnt/<path></code> s <code>uid=0,gid=0,file_mode=0777,dir_mode=0777</code> na lokálny prístup cez bind mounty LXC. Server SMB stále vynucuje oprávnenia používateľa pripojenia. Dva body pripojenia nezaručujú dve samostatné spojenia TCP."
|
||||
},
|
||||
"pvesmBranch": {
|
||||
"heading": "Metóda A — ako úložisko Proxmox (pvesm)",
|
||||
"intro": "Ak je <em>Ako úložisko Proxmox</em> označený, ProxMenux spustí pôvodný pvesm prietok:",
|
||||
"items": [
|
||||
"<strong>ID skladu</strong> Predvolené <code>cifs-<server-ip-with-dashes></code>. Iba písmená, číslice, <code>-</code> a <code>_</code>.",
|
||||
"<strong>Typy obsahu</strong> — tento výber ProxMenuxu ponúka <strong>6</strong> možností. Oproti NFS vynecháva <code>rootdir</code>. Ide o rozhodnutie skriptu, nie tvrdenie, že každá verzia backendu CIFS v Proxmoxe zakazuje koreňové súborové systémy LXC:"
|
||||
],
|
||||
"headerType": "Typ obsahu",
|
||||
"headerAllows": "Čo to umožňuje",
|
||||
"rows": [
|
||||
{
|
||||
"type": "import",
|
||||
"allows": "Import obrazu disku (štandardne vybraný)."
|
||||
},
|
||||
{
|
||||
"type": "backup",
|
||||
"allowsRich": "VM a CT záložné súbory (<code>vzdump</code>)."
|
||||
},
|
||||
{
|
||||
"type": "iso",
|
||||
"allows": "Inštalačné obrazy ISO."
|
||||
},
|
||||
{
|
||||
"type": "vztmpl",
|
||||
"allows": "Šablóny LXC."
|
||||
},
|
||||
{
|
||||
"type": "images",
|
||||
"allowsRich": "Obrazy diskov používaných VM — <strong>s varovaním v dialógu</strong>, pozrite nižšie."
|
||||
},
|
||||
{
|
||||
"type": "snippets",
|
||||
"allows": "Hook skripty a snippet súbory cloud-init."
|
||||
}
|
||||
],
|
||||
"warnTitle": "Živé disky VM na CIFS",
|
||||
"warnBody": "Výber <code>images</code> zobrazí varovanie ProxMenuxu: CIFS/SMB môže spôsobovať problémy so zámkami pri operáciách s diskami VM. Skript odporúča NFS, ale umožní pokračovať. Zálohy a ISO sú bežným použitím CIFS. Pred použitím pre <code>images</code> posúďte zámky, snímky, migráciu a záťaž.",
|
||||
"credsTitle": "Kde pvesm ukladá údaje",
|
||||
"credsBody": "Heslo sa nezapisuje do <code>/etc/pve/storage.cfg</code>. Proxmox uloží údaje v otvorenom texte do <code>/etc/pve/priv/storage/<storage-id>.pw</code>, chránené súkromným adresárom klastrového súborového systému prístupným pre <code>root</code>. Nepredpokladajte pevný režim <code>0600</code> ani šifrovanie. Po zmene hesla na serveri použite <code>pvesm set <id> --password <new></code> alebo úložisko odstráňte a pridajte cez ProxMenux."
|
||||
},
|
||||
"fstabBranch": {
|
||||
"heading": "Metóda B — iba pripojenie cez fstab hostiteľa",
|
||||
"intro": "Pri výbere <em>Iba pripojenie cez fstab hostiteľa</em> sa ProxMenux opýta na cestu a trvalé voľby, v režime používateľa vytvorí súbor prihlasovacích údajov iba pre root, pripojí zdieľanie a zapíše položku do <code>/etc/fstab</code>:",
|
||||
"items": [
|
||||
"<strong>Cesta pripojenia k hostiteľovi</strong> Predvolené <code>/mnt/<share-name></code>. Musí to byť absolútna cesta. Ak je tam niečo už namontované, alebo existuje fstab položka, ProxMenux ponúka, že ho nahradí.",
|
||||
"<strong>Voľby pripojenia</strong> — <em>Čítanie/zápis</em> (predvolené: <code>rw,uid=0,gid=0,file_mode=0777,dir_mode=0777,iocharset=utf8,nofail,_netdev</code>), <em>Iba na čítanie</em> (<code>file_mode=0555,dir_mode=0555</code>), <em>Vlastné</em> (zadajte vlastné voľby). Skript odporúča otvorené uid/gid/file_mode pre zápis cez bind mounty LXC."
|
||||
],
|
||||
"credsTitle": "Súbor prihlasovacích údajov (režim používateľa)",
|
||||
"credsBody": "V režime používateľa ProxMenux vytvorí súbor údajov iba pre root v <code>/etc/samba/credentials/<server>_<share>.cred</code> (režim <code>0600</code>) s riadkami <code>username=</code> a <code>password=</code>. Položka fstab naň odkazuje cez <code>credentials=</code>; heslo v otvorenom texte nie je v <code>/etc/fstab</code>. V režime hosťa sa pridá <code>guest</code> a súbor údajov sa nevytvorí.",
|
||||
"appliesIntro": "Keď potvrdíte, skript:",
|
||||
"applies": [
|
||||
"Vytvorí adresár bodu pripojenia pomocou <code>mkdir -p</code>.",
|
||||
"<code>mount -t cifs -o <opts>,credentials=<file></code> (alebo <code>guest</code>) <code>//<srv>/<share> <path></code>.",
|
||||
"Napíše jednoriadkový zápis do <code>/etc/fstab</code>: <code>//<srv>/<share> <path> cifs <opts> 0 0</code>.",
|
||||
"Spustí <code>systemctl daemon-reload</code> takže systemd zachytí novú fstab položku."
|
||||
],
|
||||
"lxcTitle": "Použitie pripojenia fstab z neprivilegovaného LXC",
|
||||
"lxcBody": "Voľby CIFS <code>uid=0,gid=0,file_mode=0777,dir_mode=0777</code> otvoria lokálne kontroly oprávnení pre bind mounty LXC. ACL servera a dohodnutá sémantika Unix/POSIX môžu prístup stále ovplyvniť. <strong>V kontajneri sa nič nemení</strong>: žiadne <code>chown</code> v CT, skupiny ani úpravy <code>/etc/lxc</code>. Riadok <code>mp</code> spravuje Proxmox v konfigurácii CT. Použite vypísaný príkaz <code>pct set</code> alebo <mountLink>LXC Mount Manager</mountLink>.",
|
||||
"noUiTitle": "Pripojenie fstab NIE JE úložiskom Proxmox",
|
||||
"noUiBody": "Hostiteľský fstab mount je neviditeľný pre web Proxmox UI — podľa návrhu. Nezobrazuje sa v <em>Datacenter > Storage</em>, nemôžete ho vybrať v tvorcovi VM / CT a úlohy zálohovania Proxmox sa naň nemôžu zamerať. Je to čisto cesta hostiteľského súborového systému. Ak chcete aj integráciu UI, označte vo výbere <em>obe</em> metódy."
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Ručný ekvivalent",
|
||||
"pvesmIntro": "Metóda A (pvesm) zodpovedá:",
|
||||
"fstabUserIntro": "Metóda B (fstab, overenie používateľa) — súbor prihlasovacích údajov a pripojenie:",
|
||||
"fstabGuestIntro": "Metóda B (fstab, hosť) — bez súboru prihlasovacích údajov:"
|
||||
},
|
||||
"view": {
|
||||
"heading": "Zobraziť úložiská CIFS a pripojenia hostiteľa",
|
||||
"body": "Zobrazí registrované úložiská CIFS (<code>pvesm status | awk ''$2 == \"cifs\"''</code>) so serverom, zdieľaním, obsahom, používateľom alebo <em>hosťom</em>, cestou a stavom. Heslá <strong>nikdy nevypisuje</strong>. <strong>Poznámka:</strong> druhá časť vypíše pripojenia fstab hostiteľa, voľby, cestu súboru údajov a aktívny/neaktívny stav. Ručne overte pomocou <code>findmnt -t cifs</code> alebo <code>grep cifs /etc/fstab</code>."
|
||||
},
|
||||
"remove": {
|
||||
"heading": "Odstrániť úložisko CIFS alebo pripojenie hostiteľa",
|
||||
"body": "Výber ponúka úložiská pvesm aj pripojenia fstab hostiteľa. Pri pvesm spustí <code>pvesm remove <storage-id></code> a Proxmox odstráni príslušné údaje. Pri fstab skúsi <code>umount <path></code>, odstráni položku z <code>/etc/fstab</code>, údaje z <code>/etc/samba/credentials/</code> a podľa možnosti prázdny adresár. Neúspešné odpojenie vyžaduje ručné odpojenie alebo reštart. <strong>Vzdialený server Samba a jeho súbory sa nemenia</strong>.",
|
||||
"warnTitle": "Zálohovanie závislostí najprv",
|
||||
"warnBody": "VM, CT alebo úlohy zálohovania odkazujúce na ID tohto úložiska po odstránení zlyhajú. Pred odstránením úložiska odkazy presuňte alebo odstráňte."
|
||||
},
|
||||
"test": {
|
||||
"heading": "Testovať Samba konektivitu",
|
||||
"body": "Diagnostika každého úložiska CIFS registrovaného v Proxmoxe: overí dostupnosť <code>smbclient</code>, ping, porty 445/139, skúsi výpis zdieľaní ako hosť a zobrazí stav podľa Proxmoxu (<code>pvesm status</code>). „Vyžaduje overenie“ pri výpise hosťa znamená, že server sprístupňuje zdieľania iba overeným používateľom, čo je bežné pre väčšinu NAS."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Riešenie problémov",
|
||||
"noServersTitle": "\"Žiadne Samba servery nájdené v sieti\"",
|
||||
"noServersBody": "Automatické vyhľadávanie používa <code>nmap -p 139,445</code>. Server môže byť na inej podsiete, firewalled, alebo len dosiahnuteľný podľa mena hostiteľa (mDNS / WINS). Použite možnosť <em>Manual</em> s IP alebo názov hostiteľa.",
|
||||
"noSharesTitle": "„Nenašli sa dostupné zdieľania“",
|
||||
"noSharesBody": "<code>smbclient -L</code> pre tieto údaje nič nevrátil. Používateľ nemusí mať právo vypísať zdieľania (skúste raz administrátorské údaje alebo zadajte názov ručne), server môže mať vypnutú viditeľnosť zdieľaní alebo sú údaje nesprávne. V takom prípade skript umožní zadať názov zdieľania ručne.",
|
||||
"denyTitle": "Pripojenie v Proxmoxe zlyhá s NT_STATUS_ACCESS_DENIED",
|
||||
"denyBody": "Poverenia pvesm uložené sú mimo synchronizáciu so serverom Samba (zmenilo sa heslo, účet vypnutý, nesúlad domény / pracovnej skupiny). Opätovne zadať údaje <code>pvesm set <id> --username <u> --password <p></code> alebo odstrániť a opätovne pridať z ProxMenux. Ak je server v doméne AD, pripojte <code>--domain <DOMAIN></code> k hovoru <code>pvesm set</code>.",
|
||||
"sleepTitle": "\"host je dole\" alebo stav úložiska je neaktívny v noci",
|
||||
"sleepBody": "Niektoré NAS spotrebiče dali SMB do agresívneho spánku. <code>pvestatd</code> potom vidí úložisko ako neaktívne, kým prvý prístup prebudí NAS. Ak je to kozmetické, nič nie je pokazené. Ak to spôsobí poruchy zálohovania, zakázať SMB vypnuté odpojenie na NAS alebo plán záloh mimo okna spánku.",
|
||||
"lxcNoWriteTitle": "Neprivilegovaný LXC nemôže zapisovať do cesty fstab cez bind mount",
|
||||
"lxcNoWriteBody": "Pomocou <code>findmnt /mnt/<path></code> overte požadované voľby, napríklad <code>uid=0,gid=0,file_mode=0777,dir_mode=0777</code>. Chýbajúci lokálny zápis môže blokovať mapované UID LXC. Znova použite profil RW alebo upravte vlastné voľby. Overte aj právo zápisu používateľa SMB na serveri a či rozšírenia Unix/POSIX poskytujú režimy servera. Otvorené lokálne režimy neobídu ACL servera.",
|
||||
"fstabBootTitle": "fstab mount nepríde po reštarte",
|
||||
"fstabBootBody": "Skript pridáva <code>nofail,_netdev</code>, aby nedostupné zdieľanie pri štarte neblokovalo spúšťanie systému. Ak sa nepripojí vôbec, overte sieť pomocou <code>ping <server></code>, skontrolujte <code>journalctl -u remote-fs.target</code>, existenciu a čitateľnosť súboru s údajmi pomocou <code>ls -l /etc/samba/credentials/</code> a skúste ručne spustiť <code>mount -a</code>."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/storage-share/host-nfs",
|
||||
"label": "Zdieľanie NFS ako úložisko Proxmox",
|
||||
"tail": " — súvisiaca stránka s rovnakým postupom (metóda A pvesm + metóda B fstab) a porovnaním výhod a nevýhod."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-mount-points",
|
||||
"label": "Správca LXC mountov",
|
||||
"tailRich": " Pripojiť cestu, ktorá je určená len pre fstab <code>/mnt/<path></code> do jedného alebo viacerých kontajnerov."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-samba-client",
|
||||
"label": "Samba klient v LXC",
|
||||
"tail": " Alternatíva: pripojte Samba priamo zvnútra privilegovaného kontajnera (obíde hostiteľa)."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,135 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Proxmox NFS, Samba, iSCSI a body pripojenia LXC — Úložisko a zdieľanie | ProxMenux",
|
||||
"description": "Integrujte externé aj lokálne úložisko do Proxmox VE a zdieľajte priečinky medzi hostiteľom a kontajnermi LXC. Pridajte zdieľania NFS, Samba (CIFS) a ciele iSCSI ako úložisko Proxmox, nastavte bind mounty LXC cez Mount Manager a prevádzkujte klientov a servery NFS alebo Samba v kontajneroch.",
|
||||
"ogTitle": "Proxmox NFS, Samba, iSCSI a body pripojenia LXC — Úložisko a zdieľanie",
|
||||
"ogDescription": "Integrácia externých a lokálnych úložísk do Proxmox VE: registrácia NFS, Samba a iSCSI, bind mounty LXC a zdieľanie cez sieť.",
|
||||
"twitterTitle": "Proxmox NFS, Samba, iSCSI | ProxMenux",
|
||||
"twitterDescription": "Pridajte NFS / Samba / iSCSI ako úložisko Proxmox a zdieľajte priečinky medzi hostiteľom a LXC."
|
||||
},
|
||||
"header": {
|
||||
"title": "Správca úložísk a zdieľania",
|
||||
"description": "Integrujte externé alebo lokálne úložisko do Proxmox VE a zdieľajte priečinky medzi hostiteľom a kontajnermi LXC. Tri skupiny nástrojov: integrácia úložiska hostiteľa (registrácia priamo v Proxmoxe), LXC Mount Manager (bind mounty s praktickou správou oprávnení) a sieťové zdieľanie LXC (postupy klienta a servera NFS alebo Samba pre konkrétne prípady použitia).",
|
||||
"section": "Úložisko a zdieľanie"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Na čo je toto menu",
|
||||
"body": "Disk Manager pracuje na úrovni <em>jednotlivých fyzických diskov</em>. Storage & Share Manager pracuje o úroveň vyššie — <strong>registruje úložné pooly a sieťové zdieľania v Proxmoxe</strong> (aby ich mohlo používať rozhranie a nástroj na vytváranie VM) a <strong>nastavuje zdieľanie súborov medzi hostiteľom a kontajnermi</strong>."
|
||||
},
|
||||
"opening": {
|
||||
"heading": "Otvorenie menu",
|
||||
"body": "V hlavnej ponuke ProxMenux vyberte <strong>Storage & Share Manager</strong>. Zobrazí sa toto:",
|
||||
"imageAlt": "Menu správcu úložiska a zdieľania s blokmi HOST a LXC"
|
||||
},
|
||||
"groups": {
|
||||
"heading": "Tri skupiny nástrojov",
|
||||
"intro": "Ponuka je rozdelená na tri skupiny. <strong>Integrácia úložiska hostiteľa</strong> registruje externé alebo lokálne úložisko priamo v Proxmoxe. <strong>LXC Mount Manager</strong> je hlavný nástroj na zdieľanie priečinkov s kontajnermi — praktický postup bind mountu, ktorý na strane hostiteľa rieši mapovanie UID neprivilegovaných CT. <strong>Sieťové zdieľanie LXC</strong> zahŕňa štyri ďalšie scenáre, pri ktorých kontajner potrebuje priamo <em>používať</em> alebo <em>sprístupňovať</em> zdieľania NFS alebo Samba.",
|
||||
"hostTitle": "Úložisko hostiteľa",
|
||||
"hostBody": "Zaregistrujte externé a lokálne úložisko v Proxmoxe cez <code>pvesm add …</code>. Po registrácii, úložisko sa objaví v Proxmox UI a je k dispozícii pre VM a CT tvorcov.",
|
||||
"hostItems": [
|
||||
"Externé NFS / Samba / iSCSI → Úložisko Proxmox",
|
||||
"Lokálny disk → Adresár Proxmox alebo pamäť ZFS",
|
||||
"Lokálny zdieľaný adresár (pre bind mounty medzi CT)"
|
||||
],
|
||||
"lxcMountTitle": "Správca LXC mountov",
|
||||
"lxcMountBody": "Hlavný nástroj na zdieľanie LXC. Cez <code>pct set -mpN</code> sprístupňuje adresáre hostiteľa v kontajneroch pomocou bind mountov a rieši osobitosti oprávnení neprivilegovaných CT bez vytvárania skupín alebo používateľov v kontajneri.",
|
||||
"lxcMountItems": [
|
||||
"Pracuje s privilegovanými a neprivilegovanými CT",
|
||||
"Ponúka nastavenie <code>o+rwx</code> v adresári hostiteľa pre neprivilegované UID",
|
||||
"V prípade potreby opraví existujúce pripojenia CIFS a NFS"
|
||||
],
|
||||
"lxcNetTitle": "Sieťové zdieľanie v LXC",
|
||||
"lxcNetBody": "Štyri ďalšie postupy pre kontajnery, ktoré potrebujú priamo používať alebo sprístupňovať zdieľania NFS alebo Samba. Všetky vyžadujú <strong>privilegovaný</strong> kontajner.",
|
||||
"lxcNetItems": [
|
||||
"<strong>Klient</strong> NFS / Samba (používanie externých zdieľaní)",
|
||||
"<strong>Server</strong> NFS / Samba (sprístupňovanie priečinkov CT)"
|
||||
]
|
||||
},
|
||||
"host": {
|
||||
"heading": "Napojenie úložiska na hosta",
|
||||
"intro": "Zaregistrujte skladovanie v Proxmox. Každá možnosť volá <code>pvesm add …</code> pod kapotou, takže úložisko sa zobrazí v <strong>Datacenter → Úložisko</strong> a stáva sa k dispozícii pre tvorcov VM / CT.",
|
||||
"options": [
|
||||
{
|
||||
"href": "/docs/storage-share/host-nfs",
|
||||
"icon": "Network",
|
||||
"title": "Pridať NFS zdieľanie ako Proxmox úložisko",
|
||||
"description": "Zaregistruje externý export NFS ako úložisko Proxmox pomocou pvesm add nfs. Pripojenie spravuje Proxmox, bez ďalších záznamov vo fstab."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/host-samba",
|
||||
"icon": "Share2",
|
||||
"title": "Pridať Samba zdieľanie ako Proxmox úložisko",
|
||||
"description": "Zaregistruje externé zdieľanie Samba alebo CIFS ako úložisko Proxmox pomocou pvesm add cifs. Proxmox spravuje pripojenie aj prihlasovacie údaje."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/host-iscsi",
|
||||
"icon": "Database",
|
||||
"title": "Pridať iSCSI target ako Proxmox úložisko",
|
||||
"description": "Pripojte sa k externému iSCSI cieľu a zaregistrujte ho ako úložisko Proxmox (blokové zariadenie) pre obrazy VM disku."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/host-local-disk",
|
||||
"icon": "HardDrive",
|
||||
"title": "Pridať lokálny disk ako Proxmox úložisko",
|
||||
"description": "Naformátujte lokálny disk SATA / SAS / NVMe a zaregistrujte ho ako adresár Proxmox alebo ZFS pool úložisko."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/host-local-shared",
|
||||
"icon": "FolderOpen",
|
||||
"title": "Pridať zdieľaný priečinok na hoste",
|
||||
"description": "Vytvorte adresár na hostiteľovi určený na sprístupnenie viacerým CT pomocou bind mountov. Nejde o úložisko Proxmox — je to iba prostriedok na strane hostiteľa pre bind mounty LXC."
|
||||
}
|
||||
]
|
||||
},
|
||||
"lxcMount": {
|
||||
"heading": "Správca LXC mountov",
|
||||
"intro": "Hlavný nástroj na zdieľanie priečinkov medzi hostiteľom Proxmox a kontajnermi LXC. Používa <code>pct set -mpN</code> na bind mount adresára hostiteľa do kontajnera a na strane hostiteľa rieši osobitosti oprávnení neprivilegovaných CT (v kontajneri sa nevytvárajú skupiny ani používatelia).",
|
||||
"card": {
|
||||
"title": "Body pripojenia LXC (hostiteľ ↔ CT)",
|
||||
"description": "Sprístupnite ľubovoľný adresár hostiteľa kontajneru LXC cez bind mount pomocou pct set -mpN. Funguje s privilegovanými aj neprivilegovanými CT, ponúka chmod o+rwx a ACL pre adresár na hostiteľovi a podľa potreby opraví existujúce pripojenia CIFS alebo NFS."
|
||||
}
|
||||
},
|
||||
"lxcNet": {
|
||||
"heading": "Sieťové zdieľanie v LXC",
|
||||
"intro": "Tieto postupy použite, ak kontajner potrebuje <em>byť</em> koncovým bodom NFS alebo Samba — používať externé zdieľanie (klient) alebo sprístupňovať vlastné priečinky (server). Pre väčšinu potrieb zdieľania (bind mounty hostiteľ ↔ CT) je <mountLink>LXC Mount Manager</mountLink> jednoduchší a nevyžaduje privilegované kontajnery.",
|
||||
"options": [
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-nfs-client",
|
||||
"icon": "Download",
|
||||
"title": "NFS klient v LXC",
|
||||
"description": "Pripájajte externé zdieľania NFS z privilegovaného kontajnera LXC. Podporuje automatické vyhľadanie, trvalé nastavenie v /etc/fstab a čisté odpojenie."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-samba-client",
|
||||
"icon": "Download",
|
||||
"title": "Samba klient v LXC",
|
||||
"description": "Pripájajte zdieľania Samba / CIFS z privilegovaného kontajnera LXC. Prihlasovacie údaje sa ukladajú chráneným spôsobom a je dostupné automatické vyhľadanie."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-nfs-server",
|
||||
"icon": "Upload",
|
||||
"title": "NFS server v LXC",
|
||||
"description": "Exportovať priečinky cez NFS z vo vnútri privilegovaného LXC kontajnera."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-samba-server",
|
||||
"icon": "Upload",
|
||||
"title": "Samba server v LXC",
|
||||
"description": "Sprístupniť priečinky cez SMB / CIFS z privilegovaného LXC kontajnera."
|
||||
}
|
||||
]
|
||||
},
|
||||
"privReq": {
|
||||
"title": "Požiadavka na privilegovaný kontajner",
|
||||
"body": "Štyri uvedené postupy <strong>sieťového zdieľania LXC</strong> vyžadujú <strong>privilegovaný</strong> kontajner. Skripty tento podporovaný režim overujú pred nastavením služieb a pripájacích nástrojov (<code>nfs-kernel-server</code>, <code>smbd</code>, <code>mount.nfs</code>, <code>mount.cifs</code>). Ak potrebujete len zdieľať súbory medzi hostiteľom a neprivilegovaným CT, použite <mountLink>LXC Mount Manager</mountLink> — vytvorí bind mount a upraví oprávnenia na hostiteľovi, takže kontajner môže čítať a zapisovať bez nastavenia týchto služieb či nástrojov vo svojom vnútri."
|
||||
},
|
||||
"unprivExplain": {
|
||||
"title": "Ako ProxMenux spracováva neprivilegované práva CT",
|
||||
"body": "Neprivilegované kontajnery LXC posúvajú svoje UID na hostiteľovi o <strong>+100000</strong> (UID 0 v kontajneri = UID 100000 na hostiteľovi, UID 1000 v kontajneri = UID 101000 na hostiteľovi, …). Súbor vytvorený používateľom kontajnera sa preto na hostiteľovi javí ako <em>ostatní</em> — nezodpovedá bežnému používateľovi ani skupine hostiteľa. LXC Mount Manager to rieši prakticky: namiesto zosúlaďovania UID/GID medzi hostiteľom a CT ponúka <code>chmod o+rwx</code> a zodpovedajúce ACL v adresári hostiteľa, aby každé mapované UID mohlo čítať a zapisovať. CIFS znova pripojí s <code>uid=0,gid=0,file_mode=0777,dir_mode=0777</code>; pri NFS nastaví adresár zapisovateľný všetkými so sticky bitom a pri root squash poradí so správnou úpravou na serveri."
|
||||
},
|
||||
"scripts": {
|
||||
"heading": "Uvedené skripty",
|
||||
"intro": "Každá jednotlivá stránka odkazuje na skript, ktorý riadi jej tok. Nižšie uvedený súbor je zdieľaný pomocník, ktorý nie je zdokumentovaný ako jeho vlastná stránka, ale je používaný niekoľkými z LXC sieťových tokov:",
|
||||
"itemTail": " — spoločné pomocné funkcie pre klientov a servery LXC: overenie CT, výber bodu pripojenia, kontrola privilegovaného režimu a nastavenie univerzálnej skupiny."
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,174 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Body pripojenia LXC (hostiteľ ↔ kontajner) | Dokumentácia ProxMenux",
|
||||
"description": "LXC Mount Manager sprístupní adresár hostiteľa jednému alebo viacerým kontajnerom LXC cez bind mount pomocou pct set -mpN. Rieši osobitosti oprávnení neprivilegovaných kontajnerov, opravuje pripojenia CIFS a NFS na hostiteľovi a vnútri kontajnera nič nemení.",
|
||||
"ogTitle": "Body pripojenia LXC (hostiteľ ↔ kontajner) | Dokumentácia ProxMenux",
|
||||
"ogDescription": "Sprístupnite adresáre hostiteľa kontajnerom LXC cez bind mount. Prakticky rieši mapovanie UID neprivilegovaných kontajnerov a opravuje prístup CIFS / NFS na hostiteľovi."
|
||||
},
|
||||
"header": {
|
||||
"title": "Body pripojenia LXC (hostiteľ ↔ kontajner)",
|
||||
"description": "Hlavný nástroj na zdieľanie priečinkov medzi hostiteľom Proxmox a kontajnermi LXC. Sprístupní ľubovoľný adresár hostiteľa jednému alebo viacerým kontajnerom cez bind mount pomocou natívnej syntaxe pct set -mpN. Oprávnenia neprivilegovaných kontajnerov rieši na hostiteľovi a vnútri kontajnera nič nemení.",
|
||||
"section": "Úložisko a zdieľanie · LXC"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Čo to robí?",
|
||||
"body": "Vyberte adresár na hostiteľovi Proxmox (lokálny priečinok, pripojené zdieľanie NAS alebo úložisko spravované Proxmoxom) a sprístupnite ho v kontajneri LXC na zvolenej ceste. Oprávnenia fungujú aj pre neprivilegované kontajnery bez zmien vnútri kontajnera."
|
||||
},
|
||||
"bigPicture": {
|
||||
"heading": "Ako to funguje (veľký obraz)",
|
||||
"intro": "Pri bind mounte Proxmox požiada jadro, aby adresár <code>X</code> hostiteľa zobrazovalo aj na ceste <code>Y</code> v kontajneri. Bez kopírovania, synchronizácie či siete: obe strany vidia súčasne <em>tie isté súbory</em>.",
|
||||
"sourceLabel": "Hostiteľ Proxmox",
|
||||
"sourceDetail": "/mnt/data\n(váš priečinok)",
|
||||
"targetLabel": "Kontajner LXC",
|
||||
"targetDetail": "/mnt/data\n(Ukazuje sa tu)",
|
||||
"arrowLabel": "bind mount",
|
||||
"outro": "Cesta hostiteľa vľavo a cesta kontajnera vpravo sa môžu líšiť. Napríklad <code>/mnt/nas-films</code> na hostiteľovi môže byť <code>/media/films</code> v kontajneri. Skript pridá položku do konfigurácie kontajnera (<code>/etc/pve/lxc/<ctid>.conf</code>) s ďalším voľným indexom <code>mpN</code> a dvoma predvolenými nastaveniami:",
|
||||
"items": [
|
||||
"<code>shared=1</code> — označí dáta ako zdieľané, takže ich Proxmox nemigruje s CT. Tento príznak dáta nereplikuje: rovnaká cesta a dáta už musia byť dostupné na cieľovom uzle.",
|
||||
"<code>backup=0</code> — vylúči bind mount zo záloh <code>vzdump</code>. Dáta sú na hostiteľovi a zálohujete ich samostatne."
|
||||
]
|
||||
},
|
||||
"perms": {
|
||||
"heading": "Spracovanie oprávnení",
|
||||
"intro": "Bind mounty sú v princípe jednoduché. Náročné sú oprávnenia: <strong>neprivilegovaný</strong> kontajner LXC posúva UID o <strong>+100000</strong>, takže súbor vytvorený používateľom 1000 v CT má na hostiteľovi UID 101000, ktoré nepatrí bežnému účtu hostiteľa. ProxMenux namiesto zjednocovania UID hostiteľa a kontajnerov upraví oprávnenia na strane <em>hostiteľa</em> podľa typu adresára:",
|
||||
"headerType": "Typ adresára hostiteľa",
|
||||
"headerAction": "Čo skript ponúka vykonať",
|
||||
"localType": "Lokálny priečinok",
|
||||
"localTypeSub": "napr. /mnt/data",
|
||||
"localActionRich": "<code>chmod o+rwx</code> + <code>setfacl o::rwx</code> v adresári hostiteľa. Ponúka sa len vtedy, ak CT nie je privilegované a aktuálne práva sú nedostatočné.",
|
||||
"cifsType": "Pripojené CIFS / SMB",
|
||||
"cifsTypeSub": "napr. /mnt/pve/cifs-…",
|
||||
"cifsActionRich": "Znova pripojiť s <code>uid=0, gid=0, file_mode=0777, dir_mode=0777</code>, takže CT (akékoľvek UID) môže čítať a zapisovať do zdieľania. <code>/etc/fstab</code> je aktualizovaný.",
|
||||
"nfsType": "Pripojená NFS",
|
||||
"nfsTypeSub": "napr. /mnt/pve/nfs-…",
|
||||
"nfsActionRich": "<code>chmod 1777</code> a <code>setfacl o::rwx</code> na pripojení NFS. Neobídu squashing na serveri: ak nemôže zapisovať ani root hostiteľa, skript poradí upraviť export na serveri NFS.",
|
||||
"privTitle": "Privilegované kontajnery nepotrebujú nič z toho.",
|
||||
"privBody": "V privilegovanom CT je UID 0 rovnaké ako UID 0 hostiteľa. Používateľ root v CT preto môže priamo čítať a zapisovať do adresára hostiteľa bez úprav oprávnení. Skript to rozpozná a úpravu oprávnení úplne preskočí.",
|
||||
"noCtTitle": "Skript nikdy nemení nič vnútri kontajnera",
|
||||
"noCtBody": "Všetky úpravy oprávnení prebiehajú na <strong>súborovom systéme hostiteľa</strong>. Žiadne zmeny vlastníkov cez <code>pct exec</code>, vytváranie skupín v CT ani fstab v kontajneri. Pri neskoršom použití toho istého adresára v inom CT platia rovnaké oprávnenia automaticky, bez nastavovania každého kontajnera."
|
||||
},
|
||||
"writes": {
|
||||
"heading": "Čo ProxMenux píše a čo nie",
|
||||
"intro": "Bežný zmätok pri pripájaní väzby do neprivilegovaného CT: ľudia predpokladajú, že ProxMenux musí zapisovať <code>lxc.idmap</code> položky do <code>/etc/pve/lxc/<CTID>.conf</code>. <strong>Nie.</strong> K tomuto súboru je pripojený iba jeden riadok – samotný bind mount:",
|
||||
"outro": "Výstupný riadok na konci <em>„Neprivilegovaný kontajner — posun UID: 100000“</em> je len informačný. Oznamuje predvolené neprivilegované mapovanie Proxmoxu (root v CT = UID 100000 hostiteľa). Skript toto mapovanie nijako nenastavuje.",
|
||||
"twoWaysHeading": "Dva spôsoby riešenia oprávnení — a prečo si ProxMenux vyberá jeden",
|
||||
"headerApproach": "Prístup",
|
||||
"headerChanges": "Čo to mení",
|
||||
"headerWhen": "Kedy je vhodný",
|
||||
"hostType": "Oprávnenia na hostiteľovi",
|
||||
"hostTypeSub": "(čo tento scenár robí)",
|
||||
"hostChangesRich": "<code>chmod o+rwx</code> + <code>setfacl o::rwx</code> v adresári hostiteľa. CT zmapované UID (100000+) spadajú do \"ostatných\" vedra, takže otvorenie <em>ostatní</em> je dosť.",
|
||||
"hostWhen": "Všeobecný prístup k zdieľanému priečinku z ľubovoľného CT. Viaceré CT používajú rovnaký adresár hostiteľa. Jednoduché a opakovane použiteľné.",
|
||||
"idmapTypeRich": "<code>lxc.idmap</code>",
|
||||
"idmapTypeSub": "(nepoužitý týmto skriptom)",
|
||||
"idmapChangesRich": "Vlastné UID/GID mapovanie v <code>/etc/pve/lxc/<CTID>.conf</code> plus zodpovedajúce <code>/etc/subuid</code> + <code>/etc/subgid</code> položky na hostiteľa. CT sa musí reštartovať pri každej zmene.",
|
||||
"idmapWhenRich": "Potrebujete <em>špecifickú</em> UID vnútri CT mapovať na <em>špecifickú</em> UID na hostiteľa (napr. <code>media:1000</code> v CT musí vlastniť súbory ako <code>media:1000</code> na hostiteľa, takže NFS nemá squash). Pevnejšie nastavenie, zvyčajne stojí za to len pre tento presný scenár.",
|
||||
"idmapTipTitle": "Keď skutočne potrebujete lxc.idmap",
|
||||
"idmapTipBody": "Ručné mapovanie použite, ak majú súbory z CT na hostiteľovi patriť konkrétnemu číselnému UID/GID, napríklad spoločnému vlastníkovi s používateľom hostiteľa. Neobíde NFS <code>all_squash</code>; anonymnú identitu a oprávnenia stále určuje server. Podľa potreby ručne pridajte položky <code>lxc.idmap</code>. Riadok bind mountu je od nich nezávislý."
|
||||
},
|
||||
"opening": {
|
||||
"heading": "Otvorenie nástroja",
|
||||
"body": "V hlavnej ponuke ProxMenux otvorte <strong>Storage & Share Manager → Configure LXC Mount Points (Host ↔ Container)</strong>. Zobrazí sa podponuka s tromi možnosťami:",
|
||||
"imageAlt": "Ponuka LXC Mount Manager — Pridať / Zobraziť / Odstrániť"
|
||||
},
|
||||
"addFlow": {
|
||||
"heading": "Pridať pripojenie — celý postup",
|
||||
"intro": "Technický pohľad, pre kedy chcete presne vedieť, čo robí každý dialóg:"
|
||||
},
|
||||
"sources": {
|
||||
"heading": "Čo si môžete vybrať ako hostiteľský adresár",
|
||||
"intro": "Výber adresára hostiteľa je najpodrobnejší v časti Úložisko a zdieľanie. Prehľadá štyri zdroje a ponúkne zoznam bez duplicít:",
|
||||
"headerSource": "Zdroj",
|
||||
"headerWhere": "Odkiaľ pochádza",
|
||||
"headerLabel": "Štítok v menu",
|
||||
"rows": [
|
||||
{
|
||||
"source": "Aktívne sieťové pripojenia",
|
||||
"whereRich": "Aktuálne pripojené zdieľania CIFS / NFS načítané z <code>/proc/mounts</code>.",
|
||||
"labelRich": "<code>NFS [used/size]</code> alebo <code>CIFS/SMB [used/size]</code>"
|
||||
},
|
||||
{
|
||||
"source": "Neaktívne pripojenia fstab",
|
||||
"whereRich": "Definované v <code>/etc/fstab</code>, ale momentálne nie sú namontované.",
|
||||
"labelRich": "<code>fstab(off)-NFS</code> / <code>fstab(off)-CIFS/SMB</code>"
|
||||
},
|
||||
{
|
||||
"source": "Miestne adresáre",
|
||||
"whereRich": "Sub-adresáre pod <code>/mnt</code>, ktoré nie sú sieťové pripojenia.",
|
||||
"labelRich": "<code>Local [size]</code>"
|
||||
},
|
||||
{
|
||||
"source": "Úložiská Proxmox",
|
||||
"whereRich": "Skladovacie cesty pod <code>/mnt/pve/*</code> (NFS / CIFS registrované cez <code>pvesm</code>).",
|
||||
"labelRich": "<code>PVE-NFS</code> / <code>PVE-CIFS/SMB</code> / <code>Proxmox-Storage</code>"
|
||||
},
|
||||
{
|
||||
"source": "Ručný záznam",
|
||||
"where": "Čokoľvek iné, zadajte absolútnu cestu.",
|
||||
"labelRich": "<em>Zadajte cestu manuálne</em>"
|
||||
}
|
||||
],
|
||||
"tipTitle": "Interné cesty Proxmox sú filtrované",
|
||||
"tipBody": "Výber vynechá interné cesty Proxmoxu (<code>/mnt/pve/local</code>, <code>/mnt/pve/local-lvm</code>, <code>/mnt/pve/backup</code> atď.). Sú vyhradené pre interné použitie a nemali by sa sprístupňovať cez bind mount. Zobrazia sa iba úložiská pridané používateľom."
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Ručný ekvivalent",
|
||||
"privIntro": "Pre privilegovaný kontajner — najjednoduchší prípad bez úprav oprávnení:",
|
||||
"unprivLocalIntro": "Pre neprivilegovaný kontajner s lokálnym adresárom hostiteľa — najprv otvorte oprávnenia na hostiteľovi:",
|
||||
"unprivCifsIntro": "Pre neprivilegovaný kontajner s zdieľaním CIFS už namontovaný na hostiteľa:"
|
||||
},
|
||||
"view": {
|
||||
"heading": "Zobraziť body pripojenia",
|
||||
"body": "Vypíše všetky položky <code>mpN</code> všetkých kontajnerov na hostiteľovi Proxmox, zoskupené podľa ID CT. Zobrazí cestu hostiteľa → cestu kontajnera aj ďalšie voľby. Je to pohľad iba na čítanie, vhodný na kontrolu pred pridaním či odstránením."
|
||||
},
|
||||
"remove": {
|
||||
"heading": "Odstrániť bod pripojenia",
|
||||
"body": "Vyberte kontajner, položku <code>mpN</code> a potvrďte. Skript pomocou <code>pct set --delete mpN</code> odstráni položku z konfigurácie CT a ponúkne reštart bežiaceho kontajnera. Adresár hostiteľa a jeho obsah <strong>zostanú nedotknuté</strong>. Pripojenie môžete neskôr pridať znova alebo ten istý adresár pripojiť inému CT.",
|
||||
"warnTitle": "Bežiace kontajnery potrebujú reštart, aby sa zmeny prejavili",
|
||||
"warnBody": "Pridanie aj odstránenie bodov pripojenia sa zobrazí vo vnútri kontajnera až po reštarte. Skript ponúka jedno kliknutie <code>pct reboot</code> na konci každej operácie; môžete odmietnuť a reštartovať neskôr."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Riešenie problémov",
|
||||
"noMountTitle": "Pripojenie sa zobrazuje v pct config, ale nie v kontajneri",
|
||||
"noMountBody": "Bind mounty sa pripájajú pri spustení kontajnera. Ak ste pripojenie pridali počas behu CT, reštartujte ho pomocou <code>pct reboot <ctid></code>. Ak stále chýba aj po reštarte, príkazom <code>pct config <ctid></code> overte, že záznam existuje a cesta na hostiteľovi skutočne obsahuje adresár.",
|
||||
"noWriteTitle": "Kontajner môže vidieť adresár, ale nemôže písať",
|
||||
"noWriteBody": "Takmer vždy ide o oprávnenia. Pri neprivilegovanom CT zopakujte opravu oprávnení v skripte; ACL adresára hostiteľa mohol zmeniť rsync, obnova zálohy alebo ručné <code>chmod</code>. Pri CIFS overte voľby na hostiteľovi pomocou <code>findmnt /mnt/pve/cifs-…</code> a hodnoty <code>uid=</code> / <code>gid=</code> / <code>file_mode=</code>.",
|
||||
"alreadyTitle": "\"Táto cesta sa už používa ako bod pripojenia v tomto kontajneri\"",
|
||||
"alreadyBody": "Vybrali ste si rovnakú cestu kontajnera, ktorá je už pripojená k inému adresáru. Buď vyberiete inú cestu kontajnera, alebo najprv odstráňte existujúci bod pripojenia.",
|
||||
"nfsTitle": "NFS prístup zablokovaný aj po použití hostiteľa fix",
|
||||
"nfsIntro": "Váš NFS server je squashing koreň alebo všetky spojenia. Skript to môže detekovať (snaží sa napísať testovací súbor z hostiteľa) a zobrazí usmernenie na strane servera. Dve spoločné serverové opravy pre export:",
|
||||
"nfsItems": [
|
||||
"<code>no_root_squash</code> — privilegované CT môžu zapisovať priamo.",
|
||||
"<code>all_squash,anonuid=65534,anongid=65534</code> pre neprivilegované CT."
|
||||
],
|
||||
"nfsOutro": "Tieto zmeny sa dejú na serveri NFS (TrueNAS, Synology, váš vlastný export, ...), nie na serveri Proxmox.",
|
||||
"fstabOffTitle": "Pripojenie \"fstab(off) \" položky nič nerobí",
|
||||
"fstabOffBody": "Zoznam zobrazuje položky <code>fstab(off)-</code>, ak je sieťové pripojenie definované vo fstab, ale momentálne nie je pripojené. Skript umožní sprístupniť cestu cez bind mount, no adresár zostane prázdny, kým zdieľanie skutočne nepripojíte príkazom <code>mount <path></code> na hostiteľovi. Najskôr pripojte zdieľanie a až potom ho sprístupnite CT."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/storage-share/host-local-shared",
|
||||
"label": "Pridať zdieľaný adresár na hostiteľa",
|
||||
"tailRich": " — Typický prvý krok: pripraviť <code>/mnt/shared</code> na hostiteľa pred viazaním-pripojiť ho do jedného alebo viacerých CT tu."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/host-nfs",
|
||||
"label": "Pridať NFS zdieľanie ako Proxmox úložisko",
|
||||
"extraHref": "/docs/storage-share/host-samba",
|
||||
"extraLabel": "Pridať Samba zdieľanie ako Proxmox úložisko",
|
||||
"joiner": " / ",
|
||||
"tailRich": " — Najskôr zaregistrujte externé zdieľanie v Proxmoxe, potom priviažte jeho cestu <code>/mnt/pve/<id></code> do CT tu."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-nfs-client",
|
||||
"label": "NFS klient v LXC",
|
||||
"extraHref": "/docs/storage-share/lxc-samba-client",
|
||||
"extraLabel": "Samba klient v LXC",
|
||||
"joiner": " / ",
|
||||
"tail": " - Alternatíva, keď chcete CT sám pripojiť zdieľanie (vyžaduje privilegovaný kontajner)."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,128 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "NFS klient v LXC | ProxMenux Dokumentácia",
|
||||
"description": "Pripojte zdieľania NFS priamo zvnútra kontajnera Proxmox LXC pomocou ProxMenuxu. Skript nainštaluje nfs-common, podporuje automatické vyhľadanie serverov v LAN, trvalé pripojenia cez /etc/fstab a bezpečné spúšťanie systému. Vyžaduje privilegovaný kontajner.",
|
||||
"ogTitle": "NFS klient v LXC | ProxMenux Dokumentácia",
|
||||
"ogDescription": "Pripojte zdieľania NFS z privilegovaného kontajnera LXC. Automatické vyhľadanie, trvalé záznamy v /etc/fstab a bezpečné nastavenia spúšťania."
|
||||
},
|
||||
"header": {
|
||||
"title": "NFS klient v LXC",
|
||||
"description": "Pripojte zdieľania NFS priamo z kontajnera Proxmox LXC. Kontajner sa stáva skutočným klientom NFS: komunikuje so serverom cez sieť, spúšťa mount.nfs a zapisuje do /etc/fstab. ProxMenux nainštaluje nfs-common, pomôže vyhľadať servery a exporty a nastaví bezpečné spúšťanie.",
|
||||
"section": "Úložisko a zdieľanie · LXC"
|
||||
},
|
||||
"privReq": {
|
||||
"title": "Požadovaný privilegovaný kontajner",
|
||||
"body": "Klient NFS používajúci <code>mount.nfs</code> potrebuje schopnosti (aspoň <code>SYS_ADMIN</code>), ktoré neprivilegované LXC neposkytujú. Skript vyžiada výber CT a <strong>skončí, ak je neprivilegovaný</strong>. Ak zdieľanie potrebujete v neprivilegovanom CT, najprv ho pripojte na hostiteľovi Proxmox cez <hostNfsLink>Zdieľanie NFS ako úložisko Proxmox</hostNfsLink> a potom ho sprístupnite CT pomocou bind mountu v <mountLink>LXC Mount Manager</mountLink>."
|
||||
},
|
||||
"what": {
|
||||
"heading": "Čo to robí?",
|
||||
"body": "LXC Mount Manager sprístupňuje CT cestu <em>cez</em> hostiteľa Proxmox. Tento skript namiesto toho poskytne kontajneru <strong>vlastného klienta NFS</strong>: kontajner komunikuje cez sieť, pripája zdieľania priamo zo servera NFS a ukladá ich do vlastného súboru <code>/etc/fstab</code>. Hostiteľ Proxmox nie je súčasťou dátovej cesty.",
|
||||
"diagramServerLabel": "NFS server",
|
||||
"diagramServerDetail": "/export/data",
|
||||
"diagramHostLabel": "Hostiteľ Proxmox",
|
||||
"diagramHostDetail": "(len\nmost siete)",
|
||||
"diagramCtLabel": "LXC (privilegovaný)",
|
||||
"diagramCtDetail": "/mnt/data\nmount.nfs vnútri CT",
|
||||
"diagramArrow": "NFS",
|
||||
"twoWaysTitle": "Dva spôsoby, ako poskytnúť CT NFS prístup — vyberte si jeden",
|
||||
"twoWaysBind": "<strong>Bind mount cez hostiteľa</strong> (<mountLink>LXC Mount Manager</mountLink>): hostiteľ pripojí NFS raz a každý CT dostane rovnakú cestu cez bind mount. Funguje s neprivilegovanými CT. Odporúča sa, ak rovnaké zdieľanie potrebuje viacero CT.",
|
||||
"twoWaysDirect": "<strong>Priame pripojenie NFS v CT</strong> (táto stránka): CT pripojí NFS samostatne. Vyžaduje privilegovaný CT. Hodí sa, ak má CT spravovať vlastné pripojenie a prihlasovacie údaje alebo ak každý CT komunikuje s iným serverom."
|
||||
},
|
||||
"opening": {
|
||||
"heading": "Otvorenie nástroja",
|
||||
"body": "V hlavnej ponuke otvorte <strong>Storage & Share Manager → Nastaviť klienta NFS v LXC (iba privilegovaný)</strong>. ProxMenux najprv vyžiada <strong>výber cieľového CT</strong>, spustí ho, ak je zastavený, a skončí pri neprivilegovanom CT. Potom sa zobrazí táto podponuka:",
|
||||
"imageAlt": "Ponuka klienta NFS — Pripojiť / Zobraziť / Odpojiť / Testovať pripojenie"
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Ako beží skript (Mount flow)"
|
||||
},
|
||||
"fstabFlags": {
|
||||
"heading": "Prečo tie fstab vlajky?",
|
||||
"intro": "Pre trvalé pripojenie skript pridáva tri vlajky za štandardné NFS možnosti: <code>_netdev,x-systemd.automount,noauto</code>. Každý z nich rieši skutočný boot-time problém:",
|
||||
"headerFlag": "Vlajka",
|
||||
"headerEffect": "Čo to robí?",
|
||||
"rows": [
|
||||
{
|
||||
"flag": "_netdev",
|
||||
"effect": "Oznámi inicializačnému systému, že toto pripojenie potrebuje sieť. Spúšťanie systému sa nezablokuje čakaním na pripojenie ešte pred dostupnosťou siete."
|
||||
},
|
||||
{
|
||||
"flag": "x-systemd.automount",
|
||||
"effectRich": "Vytvorí jednotku systemd automount: súborový systém sa pripojí až pri prvom prístupe k <code>/mnt/<path></code>. Nedostupný server NFS pri štarte nezablokuje CT."
|
||||
},
|
||||
{
|
||||
"flag": "noauto",
|
||||
"effect": "Vynechá okamžité pripojenie pri štarte. Spolu s uvedenou jednotkou automount sa súborový systém pripojí až pri prvom prístupe."
|
||||
}
|
||||
],
|
||||
"netEffectTitle": "Čistý účinok",
|
||||
"netEffectBody": "Súborový systém NFS sa pripojí pri <em>prvom prístupe</em>, nie okamžite pri štarte. Ak server nie je dostupný, prístup môže čakať alebo zlyhať a ovplyvniť služby závislé od danej cesty. Automount znižuje závislosť pri štarte, ale nezaručuje, že výpadok NFS neovplyvní žiadnu službu CT."
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Ručný ekvivalent",
|
||||
"body": "Celý postup zopakujete ručne — každý príkaz sa spúšťa <strong>vo vnútri CT</strong> cez <code>pct exec <ctid> --</code> alebo priamo cez <code>pct enter <ctid></code>:"
|
||||
},
|
||||
"view": {
|
||||
"heading": "Zobraziť aktuálne pripojenia",
|
||||
"body": "Zobrazí aktívne pripojenia NFS v CT (<code>mount | grep nfs</code>) aj všetky riadky NFS v jeho <code>/etc/fstab</code>. Pri každom zázname fstab sa zobrazí aktuálny stav pripojenia, čo pomáha nájsť trvalé pripojenia neobnovené pri štarte."
|
||||
},
|
||||
"unmount": {
|
||||
"heading": "Odpojiť zdieľanie NFS",
|
||||
"body": "Spojí aktívne pripojenia a položky fstab do jedného zoznamu, umožní výber a <strong>odstráni príslušný riadok z <code>/etc/fstab</code></strong>. Skript <em>nespúšťa</em> <code>umount</code> na aktívnom pripojení — upozorní, že odpojenie sa prejaví až po reštarte CT.",
|
||||
"warnTitle": "Skript odstráni položky fstab, nie aktívne pripojenia",
|
||||
"warnBody": "Ide o zámerné správanie: <code>umount</code> zlyhá s „device busy“, ak pripojenie stále používa proces v CT. Odstránenie záznamu z fstab zabezpečí, že sa pri ďalšom spustení CT neobnoví. Ak ho chcete odpojiť <em>hneď</em> a ste si istí, že ho nič nepoužíva, po skončení skriptu ručne vykonajte <code>pct exec <ctid> -- umount /mnt/<path></code>."
|
||||
},
|
||||
"test": {
|
||||
"heading": "Test NFS konektivita",
|
||||
"body": "Diagnostika vnútri CT overí inštaláciu <code>nfs-common</code>, beh <code>rpcbind</code> a vypíše aktuálne pripojenia NFS. Potom pri každom serveri NFS uvedenom vo fstab skontroluje ping, port 2049 a <code>showmount -e</code>. Je to vhodný prvý krok, ak sa trvalé pripojenie neobnoví."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Riešenie problémov",
|
||||
"privTitle": "Vyžaduje sa privilegovaný kontajner (skript skončí)",
|
||||
"privBody": "Vybrané CT je neprivilegované. Jadro NFS klient potrebuje schopnosť <code>SYS_ADMIN</code>, ktorú neprivilegované CT nevystavujú. Buď previesť CT na privilegované (Disk Manager & konverzie je zdokumentovaný v <importLink>Import Disk na LXC</importLink>) alebo použiť alternatívnu cestu popísanú v varovaní v hornej časti tejto stránky.",
|
||||
"aptTitle": "apt-get install nfs-common fails",
|
||||
"aptIntro": "Skript predpokladá rodinu Debianu CT (<code>apt-get</code>). Ak CT beží Alpine / Arch / Rocky / Alma, inštalačný krok nefunguje ticho. Nainštalujte NFS klienta ručne pre tento distro:",
|
||||
"aptItems": [
|
||||
"Alpine: <code>apk add nfs-utils</code>",
|
||||
"Arch: <code>pacman -S nfs-utils</code>",
|
||||
"Rocky / Alma: <code>dnf install nfs-utils</code>"
|
||||
],
|
||||
"aptOutro": "Potom znova spustite skript ProxMenux — krok inštalácie preskočí, keď už sú nástroje k dispozícii.",
|
||||
"portTitle": "\"NFS port (2049) is not accessible\"",
|
||||
"portBody": "Ping uspel, ale <code>nc -z <server> 2049</code> zlyhal zvnútra CT. Skontrolujte, či služba NFS beží na serveri, či firewall umožňuje 2049 zo siete CT a či má CT skutočne platnú sieťovú trasu (skúste <code>pct exec <ctid> -- ip route</code>).",
|
||||
"bootTitle": "Trvalé pripojenie funguje, ale po štarte sa neobnoví",
|
||||
"bootBody": "Príčinou býva nepripravená sieť pri pripájaní v CT, nedostupný server pri štarte alebo nefungujúce DNS pri štarte. Prvý problém riešia voľby <code>_netdev,x-systemd.automount,noauto</code>; ak ste záznam fstab vytvorili ručne bez nich, pridajte pripojenie znovu cez skript. Automount čaká na prvý prístup, čo je bežné správanie. Pri probléme s DNS použite IP adresu servera namiesto názvu.",
|
||||
"squashTitle": "Server squashes root, žiadny prístup k zápisu z vnútra CT",
|
||||
"squashIntro": "Export NFS používa <code>root_squash</code> (štandardne) a CT píše ako root. Dve možnosti:",
|
||||
"squashItems": [
|
||||
"Server-strana: zmeňte export na <code>no_root_squash</code> (iba ak veríte CT).",
|
||||
"Na strane CT zapisujte ako používateľ mimo root, ktorého server akceptuje, alebo vhodne upravte vlastníka zdieľania cez chown."
|
||||
],
|
||||
"squashOutro": "ProxMenux to nemôže opraviť — ide o pravidlá servera."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-mount-points",
|
||||
"label": "LXC Body pripojenia (Host ↔ Container)",
|
||||
"tail": " - alternatíva pre neprivilegované CT: pripojiť sa na hostiteľa, naviazať do CT."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-samba-client",
|
||||
"label": "Samba klient v LXC",
|
||||
"tail": " — súvisiaca stránka s rovnakým postupom pre zdieľania SMB / CIFS."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-nfs-server",
|
||||
"label": "NFS server v LXC",
|
||||
"tailRich": " — opačný smer: sprístupniť priečinky <em>z</em> CT cez NFS."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/host-nfs",
|
||||
"label": "Zdieľanie NFS ako úložisko Proxmox",
|
||||
"tail": " — zaregistrovať zdieľanie priamo v Proxmoxe namiesto jedného CT."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,159 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "NFS server v LXC | ProxMenux Dokumentácia",
|
||||
"description": "Zdieľajte priečinky cez NFS z kontajnera Proxmox LXC pomocou ProxMenux. Automaticky nainštaluje nfs-kernel-server a nastaví spoločnú skupinu sharedfiles, /etc/exports, sieťové ACL aj úplnú odinštaláciu. Vyžaduje privilegovaný kontajner.",
|
||||
"ogTitle": "NFS server v LXC | ProxMenux Dokumentácia",
|
||||
"ogDescription": "Spustite server NFS v privilegovanom LXC so spoločnou skupinou sharedfiles, sieťovými ACL a úplnou odinštaláciou."
|
||||
},
|
||||
"header": {
|
||||
"title": "NFS server v LXC",
|
||||
"description": "Spustite server NFS jadra v kontajneri Proxmox LXC a sprístupnite priečinky iným počítačom v sieti. ProxMenux nainštaluje nfs-kernel-server, nastaví spoločnú skupinu sharedfiles na zdieľanie súborov medzi viacerými privilegovanými CT, spravuje /etc/exports a ponúka úplnú odinštaláciu.",
|
||||
"section": "Úložisko & Share · LXC"
|
||||
},
|
||||
"privReq": {
|
||||
"title": "Požadovaný privilegovaný kontajner",
|
||||
"body": "<code>nfs-kernel-server</code> musí pripojiť súborový systém jadra <code>nfsd</code> do <code>/proc/fs/nfsd</code>. To vyžaduje <code>CAP_SYS_ADMIN</code> v mennom priestore jadra hostiteľa, nielen v používateľskom mennom priestore kontajnera. Neprivilegované LXC túto schopnosť nemajú: <code>rpc.nfsd: Unable to access /proc/fs/nfsd errno 2 (No such file or directory)</code>; systemd označí <code>nfs-server.service</code> ako zlyhanú pre závislosť. Skript preto vyžaduje privilegovaný CT a <strong>pri neprivilegovanom CT sa ukončí</strong>. Alternatívou je server NFS vo VM."
|
||||
},
|
||||
"what": {
|
||||
"heading": "Čo to robí?",
|
||||
"body": "Ide o opačný smer než na stránke <em>klienta NFS</em>: CT sa stane <strong>serverom NFS</strong> a sprístupní vlastný priečinok iným CT, hostiteľovi Proxmox, VM alebo fyzickým počítačom.",
|
||||
"diagramServerLabel": "LXC (privilegovaný) NFS server",
|
||||
"diagramServerDetail": "/mnt/data\n(sprístupnený priečinok)\n\nchown root:sharedfiles\nchmod 2775 (SGID)\n\nnfs-kernel-server\n+ rpcbind spustené",
|
||||
"diagramClientLabel": "Každý klient v sieti",
|
||||
"diagramClientDetail": "ďalší CT, hostiteľ,\nVM, fyzický stroj...",
|
||||
"diagramArrow": "Export NFS"
|
||||
},
|
||||
"shared": {
|
||||
"heading": "Spoločná skupina „sharedfiles“",
|
||||
"body": "Skript vytvorí skupinu <code>sharedfiles</code> s GID <strong>101000</strong> a pridá do nej bežných používateľov. Exportovaný adresár nastaví na <code>root:sharedfiles</code> s režimom <code>2775</code>. Úvodná číslica <code>2</code> zapína SGID: nové súbory a podadresáre zdedia skupinu <code>sharedfiles</code>.",
|
||||
"gidTitle": "Prečo konkrétne GID 101000",
|
||||
"gidBody": "Pri predvolenom mapovaní ID v LXC (+100000) sa GID 101000 hostiteľa zobrazí ako GID <strong>1000</strong> v neprivilegovanom CT. Tento serverový postup používa <strong>privilegovaný</strong> CT bez posunu ID. Dva privilegované CT so skupinou <code>sharedfiles</code> a GID 101000 preto používajú rovnaké číselné ID skupiny.",
|
||||
"remapTitle": "Staré vytváranie používateľov „remap_*“ sa pri privilegovaných CT preskočí",
|
||||
"remapBody": "Stará vetva pre neprivilegované CT by vytvorila používateľov <code>remap_<uid></code> s UID <code><uid> + 100000</code> v skupine <code>sharedfiles</code> pre bežných používateľov a časté UID (33, 1000, 1001, 1002). Posun <code>+100000</code> sa na požadované <strong>privilegované</strong> CT nevzťahuje, preto skript túto vetvu preskočí. Chýbajúce účty <code>remap_*</code> vo výstupe <code>getent passwd</code> sú očakávané a neznamenajú chybu."
|
||||
},
|
||||
"defaults": {
|
||||
"heading": "Predvolené voľby exportu — prečítajte si najprv",
|
||||
"warnTitle": "Štandardné možnosti zahŕňajú no_root_squash",
|
||||
"warnBody": "ProxMenux predvolene používa <code>rw,sync,no_subtree_check,'<'strong'>'no_root_squash'<'/strong'>'</code>. <strong>Každý používateľ root na klientovi môže do exportu zapisovať ako root.</strong> Používajte to iba v dôveryhodnej domácej LAN. Ak je CT dostupný z nedôveryhodnej siete (VPS alebo nedôveryhodná VLAN), <strong>zmeňte voľbu na <code>root_squash</code></strong> v dialógu vlastných volieb."
|
||||
},
|
||||
"opening": {
|
||||
"heading": "Otvorenie nástroja",
|
||||
"body": "V hlavnej ponuke otvorte <strong>Storage & Share Manager → Configure NFS Server in LXC</strong>. Zobrazia sa iba privilegované CT. Vyberte cieľový CT; skript ho spustí, ak je zastavený, a neprivilegovaný CT odmietne. Ponuka má päť možností.",
|
||||
"imageAlt": "Ponuka servera NFS — Vytvoriť / Zobraziť / Odstrániť / Stav / Odinštalovať"
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Ako spustí skript (Create flow)"
|
||||
},
|
||||
"network": {
|
||||
"heading": "Sieťové ACL — kto smie pripojiť export?",
|
||||
"intro": "<code>/etc/exports</code> určuje, ktorí klienti smú export pripojiť. Dialóg ponúka tri režimy:",
|
||||
"headerMode": "Režim",
|
||||
"headerValue": "Hodnota napísaná /etc/exports",
|
||||
"headerWhen": "Kedy si ju vybrať",
|
||||
"rows": [
|
||||
{
|
||||
"mode": "Miestna sieť",
|
||||
"value": "192.168.0.0/16",
|
||||
"whenRich": "Pre bežné domáce a malé firemné siete. Zahŕňa všetky adresy <code>192.168.*.*</code>."
|
||||
},
|
||||
{
|
||||
"mode": "Vlastná podsieť",
|
||||
"value": "Váš CIDR (napr. 10.0.0.0/24)",
|
||||
"when": "Keď vaša LAN nie je v 192.168.x.x alebo chcete pevnejší rozsah."
|
||||
},
|
||||
{
|
||||
"mode": "Jediný hostiteľ",
|
||||
"value": "IP (napr. 10.0.0.42)",
|
||||
"when": "Len jeden konkrétny stroj by sa mal pripojiť. Najviac obmedzujúce."
|
||||
}
|
||||
]
|
||||
},
|
||||
"options": {
|
||||
"heading": "Možnosti exportu vysvetlené",
|
||||
"headerOption": "Možnosť",
|
||||
"headerEffect": "Čo to robí?",
|
||||
"rows": [
|
||||
{
|
||||
"option": "rw / ro",
|
||||
"effect": "Povolí pripojeným klientom čítanie a zápis alebo prístup iba na čítanie."
|
||||
},
|
||||
{
|
||||
"option": "sync",
|
||||
"effectRich": "Odpovedať na žiadosti o zápis až potom, čo dáta sú na disku. Bezpečnejšie ako <code>async</code> za cenu priepustnosti."
|
||||
},
|
||||
{
|
||||
"option": "no_subtree_check",
|
||||
"effect": "Pri každej požiadavke vynechá kontrolu, či je súbor stále v exportovanom podstrome. Je to rýchlejšie a predchádza problémom pri premenovaní súborov počas operácie."
|
||||
},
|
||||
{
|
||||
"option": "no_root_squash",
|
||||
"effectRich": "<strong>Dôverovať používateľovi root na klientovi.</strong> Klient pripájajúci zdieľanie ako root zapisuje aj na serveri ako root. Hodí sa do dôveryhodnej LAN, napríklad ak zálohovací nástroj musí zachovať vlastníkov súborov. Ak úplne nedôverujete každému zariadeniu povolenému sieťovým ACL, použite namiesto toho <code>root_squash</code>."
|
||||
}
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Ručný ekvivalent",
|
||||
"body": "Celý postup môžete vykonať ručne. Každý príkaz sa spúšťa <strong>v CT</strong> cez <code>pct exec <ctid> --</code> alebo <code>pct enter <ctid></code>:"
|
||||
},
|
||||
"view": {
|
||||
"heading": "Zobraziť aktuálne exporty",
|
||||
"body": "Zobrazí <code>/etc/exports</code> z CT bez komentárov a prázdnych riadkov a vypíše každý export so sieťovým ACL a voľbami. Pred zdieľaním IP adresy CT tak môžete overiť, ktoré priečinky sú sprístupnené."
|
||||
},
|
||||
"delete": {
|
||||
"heading": "Odstrániť export",
|
||||
"body": "Zobrazí každý riadok v <code>/etc/exports</code> pre výber, odstráni vybraný (<code>sed -i</code>), spustí <code>exportfs -ra</code> a reštartuje <code>nfs-kernel-server</code>. Samotný priečinok a jeho obsah zostávajú neporušené."
|
||||
},
|
||||
"status": {
|
||||
"heading": "Kontrola stavu NFS",
|
||||
"body": "Diagnostika overí, či sú <code>nfs-kernel-server</code> a <code>rpcbind</code> nainštalované a aktívne, vypíše výstup <code>exportfs -v</code>, aktívne relácie NFS (<code>showmount -a</code>) a aktuálne pripojenia klientov."
|
||||
},
|
||||
"uninstall": {
|
||||
"heading": "Odinštalovať server NFS",
|
||||
"body": "Úplné čistenie po potvrdení: zastaví a vypne <code>nfs-kernel-server</code> a <code>rpcbind</code>, vyprázdni <code>/etc/exports</code>, odstráni balíky NFS pomocou <code>apt-get purge</code>, skupinu <code>sharedfiles</code> aj používateľov <code>remap_*</code> a ukončí zvyšné procesy. <strong>Exportované priečinky sa neodstránia</strong>; odstráni sa iba konfigurácia NFS a balíky.",
|
||||
"warnTitle": "Skript sa zastaví na exportnom riadku, nie na dátach",
|
||||
"warnBody": "<em>Odstrániť export</em> a <em>Odinštalovať server NFS</em> odstráni konfiguráciu exportu. Údaje o exportovanom priečinku sa zachovajú. Ak chcete odstrániť aj údaje, urobte to explicitne pomocou <code>rm -rf</code> po dokončení skriptu – a ak by ich ešte niekto mohol potrebovať, najprv si ich zálohujte."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Riešenie problémov",
|
||||
"privTitle": "Vyžaduje sa privilegovaný kontajner (skript sa ukončí)",
|
||||
"privBody": "Vybraný CT je neprivilegovaný. <code>nfs-kernel-server</code> v ňom nemôže bežať, pretože pripojenie <code>/proc/fs/nfsd</code> vyžaduje <code>CAP_SYS_ADMIN</code> v mennom priestore jadra hostiteľa. Ani modul <code>nfsd</code> nie je sprístupnený v mennom priestore kontajnera: <code>modprobe nfsd</code> zvnútra vráti <code>FATAL: Module nfsd not found</code>. Ak obídete kontrolu, v denníku sa objaví <code>rpc.nfsd: Unable to access /proc/fs/nfsd errno 2 (No such file or directory)</code> a porty NFS sa neotvoria. Možnosti sú previesť CT na privilegovaný alebo presunúť server NFS do VM.",
|
||||
"aptTitle": "Príkaz apt-get install zlyhá",
|
||||
"aptIntro": "Skript predpokladá CT založený na Debiane. Na Alpine / Arch / Rocky / Alma nainštalujte balíky servera NFS ručne:",
|
||||
"aptItems": [
|
||||
"Alpine: <code>apk add nfs-utils</code>",
|
||||
"Arch: <code>pacman -S nfs-utils</code>",
|
||||
"Rocky / Alma: <code>dnf install nfs-utils</code>"
|
||||
],
|
||||
"aptOutro": "Potom znova spustite skript ProxMenux; ak sú nástroje už prítomné, inštalácia sa preskočí.",
|
||||
"aclTitle": "Klient sa nemôže pripojiť: 'prístup zamietnutý serverom'",
|
||||
"aclBody": "IP adresa klienta je mimo nakonfigurovaného sieťového ACL. Vytvorte export so širšou podsieťou alebo pridajte presnú IP klienta. Pozor: pri pripojení cez NAT sa môže zobraziť WAN IP smerovača namiesto LAN IP klienta. Overte to na serveri pomocou <code>tcpdump -n port 2049</code>.",
|
||||
"ownTitle": "Súbory napísané klientom sa objavujú s divným vlastníctvom na serveri",
|
||||
"ownIntro": "Dve možnosti:",
|
||||
"ownItems": [
|
||||
"S <code>no_root_squash</code> (predvolené) používateľ root na klientovi zapisuje ako root na serveri. Súbory sú vlastnené <code>root:sharedfiles</code> vďaka SGID na priečinku.",
|
||||
"Používatelia klienta bez oprávnení root zapisujú pod vlastným UID/GID. Ak ich UID na serveri neexistuje, pri súboroch sa zobrazia iba čísla, napríklad <code>1234:1234</code>. Použite aj na klientovi skupinu <code>sharedfiles</code> alebo zjednoťte UID v systémoch, ktoré zdieľajú súbory."
|
||||
],
|
||||
"noShowTitle": "Server dosiahnuteľný, ale showmount nič nevráti",
|
||||
"noShowBody": "Po úprave <code>/etc/exports</code> obnovte tabuľku exportov pomocou <code>exportfs -ra</code> a reštartujte <code>nfs-kernel-server</code>. Skript robí oboje, ale po ručnej úprave to musíte spraviť sami. Overte tiež, že firewall CT aj hostiteľa Proxmox povoľuje TCP/UDP 2049 a port rpcbind (111)."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-nfs-client",
|
||||
"label": "NFS klient v LXC",
|
||||
"tail": " — opačný smer: pripojenie externých zdieľaní NFS v CT."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-samba-server",
|
||||
"label": "Samba server v LXC",
|
||||
"tail": " — súvisiaca stránka s rovnakým postupom, ale SMB / CIFS namiesto NFS."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/host-nfs",
|
||||
"label": "Zdieľanie NFS ako úložisko Proxmox",
|
||||
"tailRich": " — keď CT sprístupňuje export, zaregistrujte zdieľanie NFS v Proxmoxe, aby sa zobrazilo v <em>Datacenter → Storage</em>."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,155 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Samba klient v LXC | ProxMenux Dokumentácia",
|
||||
"description": "Pripojte zdieľania Samba / CIFS z kontajnera Proxmox LXC cez ProxMenux. Automaticky nainštaluje cifs-utils a smbclient, podporuje vyhľadanie serverov, chránené uloženie prihlasovacích údajov a trvalé pripojenia cez /etc/fstab. Vyžaduje privilegovaný kontajner.",
|
||||
"ogTitle": "Samba klient v LXC | ProxMenux Dokumentácia",
|
||||
"ogDescription": "Pripojte zdieľania Samba / CIFS z privilegovaného kontajnera LXC. Automatické vyhľadanie, chránený súbor prihlasovacích údajov a trvalé nastavenie v /etc/fstab."
|
||||
},
|
||||
"header": {
|
||||
"title": "Samba klient v LXC",
|
||||
"description": "Pripájajte zdieľania Samba (SMB / CIFS) priamo zvnútra kontajnera Proxmox LXC. Kontajner funguje ako skutočný klient CIFS: komunikuje so serverom Samba cez sieť, používa mount.cifs, chráni prihlasovacie údaje a zapisuje pripojenia do /etc/fstab. ProxMenux nainštaluje cifs-utils a smbclient a pred pripojením overí prihlasovacie údaje na serveri.",
|
||||
"section": "Úložisko a zdieľanie · LXC"
|
||||
},
|
||||
"privReq": {
|
||||
"title": "Požadovaný privilegovaný kontajner",
|
||||
"body": "Klient Samba / CIFS používajúci <code>mount.cifs</code> potrebuje schopnosti (aspoň <code>SYS_ADMIN</code>), ktoré neprivilegované LXC neposkytujú. Skript vyžiada výber CT a <strong>skončí, ak je neprivilegovaný</strong>. Ak zdieľanie potrebujete v neprivilegovanom CT, najprv ho pripojte na hostiteľovi Proxmox cez <hostSambaLink>Zdieľanie Samba / CIFS ako úložisko Proxmox</hostSambaLink> a potom ho sprístupnite CT pomocou bind mountu v <mountLink>LXC Mount Manager</mountLink>."
|
||||
},
|
||||
"what": {
|
||||
"heading": "Čo to robí?",
|
||||
"body": "Kontajner komunikuje cez sieť protokolom CIFS a pripája zdieľanie samostatne. Hostiteľ Proxmox slúži len ako sieťový most — pripojenie nevidí ani nespravuje.",
|
||||
"diagramServerLabel": "Samba server",
|
||||
"diagramServerDetail": "//srv/share",
|
||||
"diagramHostLabel": "Hostiteľ Proxmox",
|
||||
"diagramHostDetail": "(len\nmost siete)",
|
||||
"diagramCtLabel": "LXC (privilegovaný)",
|
||||
"diagramCtDetail": "/mnt/share\nmount.cifs vnútri CT",
|
||||
"diagramArrow": "CIFS",
|
||||
"twoWaysTitle": "Dva spôsoby, ako dať CT zdieľanie Samba — vyberte si jeden",
|
||||
"twoWaysBind": "<strong>Bind mount cez hostiteľa</strong> (<mountLink>LXC Mount Manager</mountLink>): hostiteľ pripojí CIFS raz a každý CT dostane rovnakú cestu cez bind mount. Funguje s neprivilegovanými CT. Odporúča sa, ak rovnaké zdieľanie potrebuje viacero CT.",
|
||||
"twoWaysDirect": "<strong>Priame pripojenie CIFS v CT</strong> (táto stránka): CT pripojí CIFS samostatne. Vyžaduje privilegovaný CT. Hodí sa, ak má CT spravovať vlastné prihlasovacie údaje alebo ak každý CT komunikuje s iným serverom."
|
||||
},
|
||||
"opening": {
|
||||
"heading": "Otvorenie nástroja",
|
||||
"body": "V hlavnej ponuke otvorte <strong>Storage & Share Manager → Nastaviť klienta Samba v LXC (iba privilegovaný)</strong>. ProxMenux najprv vyžiada <strong>výber cieľového CT</strong>, spustí ho, ak je zastavený, a skončí pri neprivilegovanom CT. Potom sa zobrazí táto podponuka:",
|
||||
"imageAlt": "Ponuka klienta Samba — Pripojiť / Zobraziť / Odpojiť / Testovať pripojenie"
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Ako beží skript (Mount flow)"
|
||||
},
|
||||
"creds": {
|
||||
"heading": "Kde býva heslo",
|
||||
"body": "ProxMenux <strong>nevkladá heslo do príkazu na pripojenie</strong> ani do <code>/etc/fstab</code>. Namiesto toho vytvorí súbor prihlasovacích údajov v CT. Obsahuje údaje v otvorenom texte chránené oprávneniami iba pre root; nie je šifrovaný:",
|
||||
"whyTitle": "Prečo samostatný súbor skôr než fstab",
|
||||
"whyBody": "Modul CIFS podporuje voľby <code>username=</code> / <code>password=</code> priamo vo fstab. Každý, kto môže čítať <code>/etc/fstab</code>, by však videl heslo v otvorenom texte. Uloženie prihlasovacích údajov do súboru prístupného iba root a odkaz z fstab pomocou <code>credentials=</code> zabráni tomu, aby bolo heslo v konfigurácii čitateľnej pre všetkých."
|
||||
},
|
||||
"options": {
|
||||
"heading": "Vysvetlenie možností pripojenia",
|
||||
"headerOption": "Možnosť",
|
||||
"headerEffect": "Čo to robí?",
|
||||
"rows": [
|
||||
{
|
||||
"option": "rw / ro",
|
||||
"effect": "Režim čítania a zápisu alebo iba čítania pre celé pripojenie."
|
||||
},
|
||||
{
|
||||
"option": "file_mode=0664",
|
||||
"effect": "Oprávnenia hlásené pre súbory prostredníctvom CIFS. Štandardne umožňuje majiteľ+skupina písať, iní čítať."
|
||||
},
|
||||
{
|
||||
"option": "dir_mode=0775",
|
||||
"effect": "Oprávnenia hlásené pre adresáre. Predvolene vlastník a skupina môžu vstupovať a vytvárať obsah, ostatní môžu adresár prechádzať."
|
||||
},
|
||||
{
|
||||
"option": "iocharset=utf8",
|
||||
"effect": "Vynúti UTF-8 pre názvy súborov prenášané cez sieť a zabráni poškodenému zobrazovaniu znakov mimo ASCII."
|
||||
},
|
||||
{
|
||||
"option": "credentials=file",
|
||||
"effect": "Čítať užívateľské meno / heslo zo súboru (pridané automaticky pre užívateľa auth)."
|
||||
},
|
||||
{
|
||||
"option": "guest",
|
||||
"effect": "Overte ako hosť, nie sú potrebné žiadne údaje (pri výbere hosťa automaticky pridané)."
|
||||
},
|
||||
{
|
||||
"option": "_netdev",
|
||||
"effect": "Oznámi inicializačnému systému, že toto pripojenie potrebuje sieť. Spúšťanie systému sa nezablokuje čakaním naň."
|
||||
},
|
||||
{
|
||||
"option": "x-systemd.automount",
|
||||
"effect": "Pripojenie až pri prvom prístupe: súborový systém sa pripojí, keď sa začne používať. Nedostupný server CIFS pri štarte nezablokuje CT."
|
||||
},
|
||||
{
|
||||
"option": "noauto",
|
||||
"effect": "Vynechá okamžité pripojenie pri štarte. V kombinácii s jednotkou automount sa súborový systém pripojí až vtedy, keď je potrebný."
|
||||
}
|
||||
],
|
||||
"netEffectTitle": "Čistý účinok indikátorov fstab",
|
||||
"netEffectBody": "Súborový systém CIFS sa pripojí pri <em>prvom prístupe</em>, nie okamžite pri štarte. Ak server nie je dostupný, prístup môže čakať alebo zlyhať a ovplyvniť služby závislé od danej cesty. Automount znižuje závislosť pri štarte, ale nezaručuje, že výpadok CIFS neovplyvní žiadnu službu CT."
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Ručný ekvivalent",
|
||||
"body": "Celý postup zopakujete ručne — každý príkaz sa spúšťa <strong>vo vnútri CT</strong> cez <code>pct exec <ctid> --</code> alebo priamo cez <code>pct enter <ctid></code>:",
|
||||
"guestIntro": "Variant hosťa — súbor prihlasovacích údajov nie je potrebný:"
|
||||
},
|
||||
"view": {
|
||||
"heading": "Zobraziť aktuálne pripojenia",
|
||||
"body": "Zobrazí aktívne pripojenia CIFS v CT (<code>mount -t cifs</code>) a všetky riadky CIFS v jeho <code>/etc/fstab</code>. Pri každom zázname fstab sa zobrazí aktuálny stav, čo pomáha nájsť trvalé pripojenia neobnovené pri štarte."
|
||||
},
|
||||
"unmount": {
|
||||
"heading": "Odpojiť zdieľanie Samba",
|
||||
"body": "Spojí aktívne pripojenia a položky fstab do zoznamu, umožní výber a <strong>odstráni príslušný riadok z <code>/etc/fstab</code></strong> aj súvisiaci súbor prihlasovacích údajov. Skript nespustí <code>umount</code> na aktívnom pripojení, ale upozorní na potrebu reštartu CT, aby sa odpojenie prejavilo.",
|
||||
"warnTitle": "Skript odstráni položky fstab, nie aktívne pripojenia",
|
||||
"warnBody": "Rovnaký princíp ako pri klientovi NFS: <code>umount</code> na používanom pripojení zlyhá s „device busy“. Odstránenie záznamu z fstab zabezpečí, že sa pripojenie pri ďalšom spustení CT neobnoví. Ak ho chcete odpojiť <em>hneď</em>, po skončení skriptu ručne vykonajte <code>pct exec <ctid> -- umount /mnt/<path></code>."
|
||||
},
|
||||
"test": {
|
||||
"heading": "Testovať Samba konektivitu",
|
||||
"body": "Diagnostický priechod vnútri CT: potvrdzuje, že je nainštalovaný <code>cifs-utils</code>, uvádza aktuálne pripojenia CIFS, potom pre každý server, na ktorý sa odkazuje vo fstab, kontroluje ping → porty 139/445 → zoznam hostí. \"Vyžaduje overenie\" v teste hosťa je normálne pre každý server, ktorý nezverejňuje verejné zdieľania."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Riešenie problémov",
|
||||
"privTitle": "Vyžaduje sa privilegovaný kontajner (skript skončí)",
|
||||
"privBody": "Vybrané CT je neprivilegované. Jadro CIFS klient potrebuje <code>SYS_ADMIN</code>, ktoré neprivilegované CT nevystavujú. Buď konvertujte CT na privilegovanú alebo použite alternatívnu cestu popísanú v varovaní v hornej časti tejto stránky.",
|
||||
"aptTitle": "apt-get install fails",
|
||||
"aptIntro": "Skript predpokladá rodinu Debianu CT (<code>apt-get</code>). Na Alpine / Arch / Rocky / Alma, inštalujte CIFS klienta ručne:",
|
||||
"aptItems": [
|
||||
"Alpine: <code>apk add cifs-utils samba-client</code>",
|
||||
"Arch: <code>pacman -S cifs-utils smbclient</code>",
|
||||
"Rocky / Alma: <code>dnf install cifs-utils samba-client</code>"
|
||||
],
|
||||
"aptOutro": "Potom znova spustite skript ProxMenux — krok inštalácie preskočí, keď už sú nástroje k dispozícii.",
|
||||
"guestFallbackTitle": "\"Server vás spájal ako hosť namiesto zadaného užívateľa\"",
|
||||
"guestFallbackBody": "Aktívne overenie skriptu zistilo problém s autentifikáciou. Server prijal pripojenie, ale zmenil ho na hosťa pre nesprávne prihlasovacie údaje. Príčiny bývajú preklep v mene alebo hesle, neexistujúci alebo zablokovaný používateľ a nesprávna pracovná skupina či doména. Zopakujte postup a údaje starostlivo zadajte znova (heslo je v dialógu skryté).",
|
||||
"denyTitle": "„NT_STATUS_ACCESS_DENIED“ pri pripájaní",
|
||||
"denyBody": "Prihlasovacie údaje sú overené, ale zdieľanie odmieta prístup. Na serveri skontrolujte oprávnenia používateľa ku konkrétnemu zdieľaniu (overenie potvrdzuje prihlásenie, nie ACL jednotlivých zdieľaní). Overte aj požadovanú verziu SMB: do volieb pridajte <code>vers=3.0</code> (alebo <code>2.1</code>, <code>2.0</code>).",
|
||||
"utf8Title": "Názvy súborov UTF-8 / mimo ASCII sa zobrazujú nesprávne",
|
||||
"utf8Body": "Predvolené možnosti zahŕňajú <code>iocharset=utf8</code>, ale niektoré konfigurácie serverov hlásia neočakávanú stránku kódov. Ak mená súborov s akcentmi / symbolmi vyzerajú zle, skúste aj <code>nounix</code> (niektoré servery Linux Samba to potrebujú, keď je klient tiež Linux) alebo nastavte stranu servera na <code>unix extensions = no</code>.",
|
||||
"bootTitle": "Trvalé pripojenie funguje, ale po štarte sa neobnoví",
|
||||
"bootBody": "Príčinou býva nepripravená sieť pri pripájaní v CT, nedostupný server pri štarte alebo nefungujúce DNS. Voľby <code>_netdev,x-systemd.automount,noauto</code> riešia prvý prípad; automount bežne čaká na prvý prístup. Pri probléme s DNS použite IP adresu servera namiesto názvu."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-mount-points",
|
||||
"label": "LXC Body pripojenia (Host ↔ Container)",
|
||||
"tail": " - alternatíva pre neprivilegované CT: pripojiť sa na hostiteľa, naviazať do CT."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-nfs-client",
|
||||
"label": "NFS klient v LXC",
|
||||
"tail": " — súvisiaca stránka s rovnakým postupom pre zdieľania NFS."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-samba-server",
|
||||
"label": "Samba server v LXC",
|
||||
"tailRich": " — opačný smer: sprístupniť priečinky <em>z</em> CT cez Samba."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/host-samba",
|
||||
"label": "Samba / CIFS ako Proxmox skladovanie",
|
||||
"tail": " — zaregistrovať zdieľanie priamo v Proxmoxe namiesto jedného CT."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,132 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Samba server v LXC | ProxMenux Dokumentácia",
|
||||
"description": "Spustite server Samba (SMB / CIFS) v kontajneri Proxmox LXC cez ProxMenux. Automaticky nainštaluje samba a spravuje /etc/samba/smb.conf, používateľov smbpasswd a skupinu sharedfiles pre priečinky pripojené cez bind mount. Vyžaduje privilegovaný kontajner.",
|
||||
"ogTitle": "Samba server v LXC | ProxMenux Dokumentácia",
|
||||
"ogDescription": "Sprístupnite priečinky cez SMB/CIFS z privilegovaného LXC. Automatická inštalácia, používateľ smbpasswd a oprávnenia prispôsobené bind mountom."
|
||||
},
|
||||
"header": {
|
||||
"title": "Samba server v LXC",
|
||||
"description": "Spustite server Samba (SMB / CIFS) v kontajneri Proxmox LXC a vystavte priečinky klientom Windows / macOS / Linux v sieti. ProxMenux nainštaluje samba, vytvorí používateľa Samba pomocou smbpasswd, spravuje /etc/samba/smb.conf a použije oprávnenia prispôsobené bind mountom, keď zdieľaný priečinok pochádza od hostiteľa.",
|
||||
"section": "Úložisko & Share · LXC"
|
||||
},
|
||||
"privReq": {
|
||||
"title": "Požadovaný privilegovaný kontajner",
|
||||
"body": "Samba sa vydáva za pripájajúceho užívateľa <code>setgroups()</code> pri každom pripojení k zdieľaniu (v okamihu, keď klient otvorí zdieľanie). V neprivilegovaných LXC, jadro odmieta, že syscall, pretože používateľský menný priestor kontajnera je vytvorený s <code>setgroups=deny</code> a <code>smbd</code> reaguje prerušením pracovného procesu s <code>PANIC: sys_setgroups failed</code>. Výsledkom je, že <code>smbd</code> začína a viaže porty 139/445, ale každý klient spojenie zlyhá s <code>NT_STATUS_CONNECTION_DISCONNECTED</code>. Skript presadzuje privilegovaný CT z tohto dôvodu a <strong>sa ukončí, ak CT nie je privilegovaný</strong>. Na strane servera neexistuje čistá oprava; použite privilegovaný CT, alebo spustiť Samba vnútri VM."
|
||||
},
|
||||
"what": {
|
||||
"heading": "Čo to robí?",
|
||||
"body": "Kontajner sa stáva SMB/CIFS serverom: prevádzkuje <code>smbd</code>, vystavuje priečinok cez <code>/etc/samba/smb.conf</code> a prijíma klientske pripojenia na portoch <code>139</code> / <code>445</code>. Klienti vidia zdieľanie na <code>\\\\<ct-ip>\\<share-name></code> vo Windows Explorer, <code>smb://<ct-ip>/<share-name></code> v macOS Finder, alebo prostredníctvom <code>mount.cifs</code> na Linuxe.",
|
||||
"diagramServerLabel": "LXC (privilegovaný) — server Samba",
|
||||
"diagramServerDetail": "/mnt/data\n(sprístupnený priečinok)\n\nsmbd + nmbd spustené\n\nPoužívateľ: <username>\n(via smbpasswd)\n\nVynútená skupina:\nsharedfiles",
|
||||
"diagramClientLabel": "Každý klient v sieti",
|
||||
"diagramClientDetail": "Windows: \\\\<ip>\\<share>\nmacOS: smb://<ip>/<share>\nLinux: mount.cifs",
|
||||
"diagramArrow": "SMB / CIFS"
|
||||
},
|
||||
"perms": {
|
||||
"heading": "Dve cesty povolenia v závislosti od typu priečinka",
|
||||
"body": "Pred pridaním zdieľania do <code>smb.conf</code> skript overí, či je priečinok <strong>bind mountom z hostiteľa</strong> alebo bežným <strong>lokálnym priečinkom v CT</strong>. Podľa toho nastaví rôznych vlastníkov a oprávnenia:",
|
||||
"headerType": "Typ priečinku",
|
||||
"headerAction": "Čo robí skript",
|
||||
"bindType": "Bind mount z hostiteľa",
|
||||
"bindTypeSubRich": "detekovaný prostredníctvom výstupu <code>mount</code>",
|
||||
"bindActionRich": "Vytvorí skupinu <code>sharedfiles</code> (predvolené GID 999, dynamické, ak je obsadené), pridá používateľa Samba a použije <code>chown root:sharedfiles</code> a <code>chmod 2775</code> (SGID — nové súbory zdedia skupinu). Ak používateľ stále nemôže zapisovať, použije <code>setfacl -m u:<user>:rwx</code>.",
|
||||
"localType": "Lokálny priečinok vnútri CT",
|
||||
"localTypeSub": "Nebol zistený bind mount",
|
||||
"localActionRich": "Štandardné vlastníctvo: <code>chown -R <user>:<user></code> + <code>chmod -R 755</code>. Žiadna spoločná skupina nie je potrebná, pretože do tohto priečinku nepíše žiadna iná CT. Vracia sa do <code>setfacl</code> ak stále chýba prístup k zápisu.",
|
||||
"gidTitle": "GID pre „sharedfiles“ sa líši od toku servera NFS",
|
||||
"gidBody": "Skript Samba server používa GID <strong>999</strong> pre <code>sharedfiles</code>, zatiaľ čo <nfsLink>postup servera NFS</nfsLink> používa GID <strong>101000</strong>. Ak spustíte oba servery v rovnakom CT a chcete jednu spoločnú skupinu v oboch protokoloch, upravte jeden z nich tak, aby zodpovedal druhému po inštalácii (napr. <code>groupmod -g 101000 sharedfiles</code>) a znova nastavte vlastníkov príslušných priečinkov. Toto je známy nesúlad v aktuálnych skriptoch."
|
||||
},
|
||||
"opening": {
|
||||
"heading": "Otvorenie nástroja",
|
||||
"body": "V hlavnej ponuke otvorte <strong>Storage & Share Manager → Configure Samba Server in LXC</strong>. Zobrazia sa iba privilegované CT. Vyberte cieľový CT; skript ho spustí, ak je zastavený, a neprivilegovaný CT odmietne. Ponuka má päť možností.",
|
||||
"imageAlt": "Ponuka servera Samba — Vytvoriť / Zobraziť / Odstrániť / Stav / Odinštalovať"
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Ako prebieha vytvorenie v skripte"
|
||||
},
|
||||
"modes": {
|
||||
"heading": "Tri režimy zdieľania",
|
||||
"intro": "Každý režim zapíše iný blok do <code>smb.conf</code>. Všetky tri zahŕňajú <code>valid users = <username></code> (nie anonymné), <code>force group = sharedfiles</code> (takže nové súbory patria do zdieľanej skupiny) a <code>veto files = /lost+found/</code> (skrýva ich od klientov).",
|
||||
"headerMode": "Režim",
|
||||
"headerBlock": "Blok napísaný smb.conf",
|
||||
"rwMode": "Čítanie a zápis",
|
||||
"roMode": "Iba na čítanie",
|
||||
"customMode": "Vlastné",
|
||||
"customBodyRich": "Svoje vlastné smernice zapíšete do voľného textu. ProxMenux ich stále zabalí do bloku <code>[share]</code> štandardným <code>path</code>, <code>valid users</code>, <code>force group</code> a <code>veto files</code>."
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Ručný ekvivalent",
|
||||
"body": "Celý postup môžete vykonať ručne. Každý príkaz sa spúšťa <strong>v CT</strong> cez <code>pct exec <ctid> --</code> alebo <code>pct enter <ctid></code>:"
|
||||
},
|
||||
"connect": {
|
||||
"heading": "Pripojenie od klientov",
|
||||
"headerOs": "Operačný systém klienta",
|
||||
"headerHow": "Ako sa pripojiť",
|
||||
"windowsOs": "Windows",
|
||||
"windowsHowRich": "Prieskumník → panel s adresou: <code>\\\\<ct-ip>\\<share-name></code>. Alebo <em>Pripojiť sieťovú jednotku</em> → začiarknite „Pripojiť pomocou iných prihlasovacích údajov“.",
|
||||
"macosOs": "macOS",
|
||||
"macosHowRich": "Finder → <em>Choď → Pripojiť k serveru…</em> → <code>smb://<ct-ip>/<share-name></code>. Alebo <code>mount_smbfs //user@<ct-ip>/<share> /mountpoint</code>.",
|
||||
"linuxOs": "Linux",
|
||||
"linuxHowRich": "<code>mount -t cifs //<ct-ip>/<share> /mnt/x -o username=<u>,password=<p>,iocharset=utf8</code>. Alebo použite klienta <clientLink>Samba na stránke LXC</clientLink>, ak je klientom iný Proxmox CT."
|
||||
},
|
||||
"view": {
|
||||
"heading": "Zobraziť aktuálne zdieľania",
|
||||
"body": "Analyzuje <code>/etc/samba/smb.conf</code> v CT a vypíše každý blok <code>[share]</code> s cestou, pričom preskočí <code>[global]</code>, <code>[homes]</code> a <code>[printers]</code>. Hodí sa ako rýchly prehľad."
|
||||
},
|
||||
"delete": {
|
||||
"heading": "Odstrániť zdieľanie",
|
||||
"body": "Umožňuje vybrať zdieľanie podľa mena, odstraňuje blok z <code>smb.conf</code> (<code>sed</code> odstráni z <code>[share]</code> do ďalšieho prázdneho riadku) a reštartuje <code>smbd</code>. Priečinok sám a jeho obsah sú ponechané neporušené."
|
||||
},
|
||||
"status": {
|
||||
"heading": "Kontrola stavu Samby",
|
||||
"body": "Oznámi, či sú <code>smbd</code> a <code>nmbd</code> nainštalované a aktívne, vypíše používateľov Samba (<code>pdbedit -L</code>) a aktívne relácie (<code>smbstatus</code>)."
|
||||
},
|
||||
"uninstall": {
|
||||
"heading": "Odinštalovať server Samba",
|
||||
"body": "Úplné čistenie po potvrdení: zastaví a vypne <code>smbd</code> a <code>nmbd</code>, zálohuje <code>smb.conf</code> do <code>smb.conf.backup.YYYYMMDD_HHMMSS</code>, odstráni používateľov Samba pomocou <code>smbpasswd -x</code> a balíky Samba pomocou <code>apt-get purge</code>. <strong>Exportované priečinky sa neodstránia</strong>.",
|
||||
"warnTitle": "Priečinky zostanú — dáta zálohujte samostatne",
|
||||
"warnBody": "<em>Odstrániť zdieľanie</em> aj <em>Odinštalovať server Samba</em> odstránia konfiguráciu zdieľania. Dáta v exportovaných priečinkoch sa zachovajú. Ak ich chcete tiež odstrániť, použite po dokončení skriptu výslovne <code>rm -rf</code>."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Riešenie problémov",
|
||||
"privTitle": "Vyžaduje sa privilegovaný kontajner (skript sa ukončí)",
|
||||
"privBody": "Vybrané CT je neprivilegované a <code>smbd</code> tam nemôže slúžiť súbory. Ak obídete bránu a konfigurujete Sambu ručne, začne sa <code>smbd</code> a otvoria sa porty, ale prvé klientske spojenie spanikári s <code>PANIC: sys_setgroups failed</code> v <code>/var/log/samba/log.<client></code> a klient vidí <code>NT_STATUS_CONNECTION_DISCONNECTED</code>. Príčinou je neprivilegované používateľský menný priestor s <code>setgroups=deny</code>, ktoré blokuje prevzatie identity používateľa Sambou pri každom pripojení. Ani <code>features=keyctl=1</code> ani odstránenie <code>force user</code> / <code>force group</code> to nemení. Jediné funkčné možnosti sú: previesť CT na privilegované, alebo presunúť Samba na VM.",
|
||||
"aptTitle": "Príkaz apt-get install zlyhá",
|
||||
"aptIntro": "Skript predpokladá CT založený na Debiane. Na Alpine / Arch / Rocky / Alma nainštalujte Sambu ručne:",
|
||||
"aptItems": [
|
||||
"Alpine: <code>apk add samba</code>",
|
||||
"Arch: <code>pacman -S samba</code>",
|
||||
"Rocky / Alma: <code>dnf install samba</code>"
|
||||
],
|
||||
"aptOutro": "Potom znova spustite skript ProxMenux; ak sú nástroje už prítomné, inštalácia sa preskočí.",
|
||||
"noShareTitle": "Klient sa pripojí, ale nevidí zdieľanie",
|
||||
"noShareBody": "Overte <code>browseable = yes</code> v bloku zdieľania (predvolené pre rw / ro; vo vlastnom režime môže chýbať). Firewall CT aj hostiteľa Proxmox musí povoľovať TCP 445 (SMB) a 139 (NetBIOS). Niektorí klienti Windows potrebujú preklad názvov; najprv skúste priamo IP adresu.",
|
||||
"authTitle": "Zlyhanie overovania (NT_STATUS_LOGON_FAILURE)",
|
||||
"authBody": "Heslo je nesprávne (heslá Samba sú <em>oddelené</em> od systémových; používateľov Samba vypíšete pomocou <code>pdbedit -L</code>) alebo používateľ chýba v <code>valid users</code> daného zdieľania. Heslo obnovte v CT pomocou <code>smbpasswd <user></code>.",
|
||||
"groupTitle": "Súbory napísané klientom sa objavujú s nesprávnou skupinou na serveri",
|
||||
"groupBody": "Skript nastaví <code>force group = sharedfiles</code> v bloku zdieľania, takže nové súbory by mali byť skupiny <code>sharedfiles</code>. Ak nie sú, SGID bit na rodičovskom adresári mohol byť stratený (niekto spustil <code>chmod</code> ručne). Opakovane: <code>chmod 2775 /mnt/<share></code>.",
|
||||
"bothTitle": "Zdieľanie rovnakého priečinka na oboch NFS a Samba",
|
||||
"bothBody": "ProxMenux používa rôzne GIDs pre <code>sharedfiles</code> v každom skripte (Samba: 999, NFS: 101000). Ak podávate rovnaký priečinok prostredníctvom oboch, rozhodnite sa pre jednu GID a zarovnajte obe. Najjednoduchšia oprava: po spustení oboch skriptov upravte menšie GID:"
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-samba-client",
|
||||
"label": "Samba klient v LXC",
|
||||
"tail": " — opačný smer: pripojenie externých zdieľaní Samba v CT."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-nfs-server",
|
||||
"label": "NFS server v LXC",
|
||||
"tail": " — súvisiaca stránka s rovnakým postupom, ale NFS namiesto CIFS."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/host-samba",
|
||||
"label": "Samba / CIFS ako úložisko Proxmox",
|
||||
"tailRich": " — keď CT sprístupňuje export, zaregistrujte zdieľanie Samba v Proxmoxe, aby sa zobrazilo v <em>Datacenter → Storage</em>."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user