{ "meta": { "title": "Lokalt arkivmål — tar.zst på ett filsystem eller en USB-enhet | ProxMenux", "description": "Det lokala säkerhetskopieringsmålet skriver ett enda .tar.zst-arkiv till en skrivbar katalog: en intern disk, en Proxmox-monteringspunkt, en NFS-delning eller en USB-enhet. Sidan beskriver konfigurationen, hur USB-enheter upptäcks och monteras, skyddet mot att skriva arkivet till en sökväg som säkerhetskopieras samt JSON-sidofilen som identifierar arkivet.", "ogTitle": "ProxMenux Backup - Lokal arkiv destination", "ogDescription": "Hur ProxMenux skriver lokala säkerhetskopior som .tar.zst arkiv och hur man konfigurerar destinationskatalogen eller USB-enheten.", "twitterTitle": "Lokal backup destination | ProxMenux", "twitterDescription": "Hur ProxMenux skriver lokala säkerhetskopior som .tar.zst arkiv på ett filsystem eller USB-enhet." }, "header": { "title": "Lokalt arkiv", "description": "Det lokala målet skriver ett enda komprimerat tar-arkiv till en skrivbar katalog på värden: en intern disk, ett monterat NFS- eller SMB-filsystem eller en USB-enhet.", "section": "Säkerhetskopiering och återställning" }, "intro": { "title": "En fristående fil", "body": "En lokal säkerhetskopia producerar en enda hostcfg-HOST-TIMESTAMP.tar.zst-fil (eller .tar.gz när zstd är frånvarande). Filen innehåller hela arkivträdet - manifest.json, metadata/ och rootfs/ - och kan återställas på någon Proxmox värd med ProxMenux återställningsflöde, eller extraheras manuellt med tar --zstd -xf på alla Linux-system. Ingen server, ingen initiering av arkivlager, inget externt beroende. Detta är destinationen med den kortaste återhämtningsvägen när varken PBS eller Borg är tillgänglig." }, "targetConfig": { "heading": "Konfigurera målkatalogen", "intro": "Det lokala målet är en enda sparad målkatalog — inte en lista. ProxMenux sparar användarens val i /usr/local/share/proxmenux/local-target.conf och läser det vid varje säkerhetskopiering. Om inget mål har konfigurerats används standardvärdet HB_LOCAL_TARGET_DEFAULT = /var/lib/vz/dump (samma katalog som Proxmox använder för sina egna vzdump-utdata). Målet konfigureras via Konfigurera säkerhetskopieringsmål → Lokala mål:", "options": [ "Använd standard (/var/lib/vz/dump). Proxmox lokal lagring. Finns på varje Proxmox-installation; arkivet sitter bredvid vzdump-utdata och hämtas av fliken Monitor's Backups automatiskt.", "Ange en anpassad sökväg. Alla absoluta filsystemsökvägar kan användas: en NFS-montering, en SMB-delning monterad via fstab, ett särskilt ZFS-dataset eller en andra intern disk. ProxMenux kontrollerar att sökvägen finns och är en katalog innan valet sparas.", "Välj en USB-enhet. Öppnar USB-undermenyn (nedan), som upptäcker flyttbara enheter och erbjuder sig att montera eller formatera en." ] }, "usbFlow": { "heading": "USB-enhetsdetektering och montering", "intro": "USB-undermenyn listar partitioner på flyttbara enheter som rapporteras av lsblk. Varje partition visas med storlek, filsystemets etikett och aktuellt tillstånd. Tillståndet avgör vilken åtgärd ProxMenux erbjuder.", "statesTitle": "De tre enhetstillstånden", "stateRows": [ { "state": "monterad", "shown": "Storlek · etikett · [fstype] · → /mount/point", "action": "Partitionen är redan monterad. Om den väljs sparas dess aktuella monteringspunkt som lokalt mål. Ingen ny montering utförs." }, { "state": "ej monterad", "shown": "Storlek · etikett · [fstype] · (ej monterad — kommer att monteras)", "action": "Ett filsystem är närvarande men inte monterat. På bekräftelse kör ProxMenux hb_mount_usb_partition: skapar /mnt/backup-LABEL (eller en UUID-baserad väg om det inte finns någon etikett), monterar partitionen och sparar monteringspunkten som det lokala målet." }, { "state": "tom", "shown": "Storlek · rå USB-disk — inget filsystem (kommer att FORMATERAS)", "action": "Enheten har inget filsystem. Denna destruktiva åtgärd skyddas av två bekräftelser. Först förklarar en Ja/Nej-dialog att disken raderas. Sedan måste användaren skriva den exakta enhetssökvägen (t.ex. /dev/sdb) innan ProxMenux skapar en ny GPT med en ext4-partition och monterar den." } ], "notMountedFallback": "Om ingen USB-enhet upptäcks visar undermenyn ett vanligt inmatningsfält. Användaren kan ange valfri sökväg till en monteringspunkt; om sökvägen inte är en registrerad monteringspunkt visas en varning i en bekräftelsedialog innan processen fortsätter." }, "safetyCheck": { "heading": "Säkerhetskontroll - destination inuti en backupbana", "body": "Innan du skriver arkivet, verifierar _bk_local att destinationskatalogen inte är en undersökväg till någon katalog som säkerhetskopieras. Ett vanligt misstag skulle vara att lägga till /root till profilen och välja /root/backups som destination — arkivet skulle då inkludera sig självt, antingen producera ett korrupt arkiv eller växa utan gräns tills skivan fylls. Kontrollen löser båda sökvägarna med readlink -m, jämför dem och, vid konflikt, avbryter säkerhetskopieringen med en dialogruta som namnger den motstridiga sökvägen och listar tre sätt att lösa den: välj en destination utanför den motstridiga sökvägen, ta bort den anpassade posten som innehåller destinationen, eller använd anpassat läge för att avmarkera den motstridiga sökvägen för denna körning." }, "archiveFormat": { "heading": "Arkivformat och komprimering", "intro": "Utdatafilnamnet bäddar in källvärdnamnet och backup timestamp så att en katalog med flera arkiv sorterar kronologiskt och varje fil är självidentifierande.", "namePattern": "hostcfg-HOSTNAME-YYYYMMDD_HHMMSS.tar.zst", "compressionTitle": "Kompression", "compressionBody": "Huvudmetoden använder tar --zstd -cf — ett enda kommando som komprimerar med zstd:s standardnivå. Om zstd saknas på källan (ovanligt på Proxmox, men möjligt på minimala installationer) används gzip. Om pv finns vid denna reservmetod läggs en förloppsindikator till så att användaren ser arkivstorleken växa i realtid; utan pv används vanlig tar -czf utan förloppsutdata.", "sourceTitle": "Vad går in i arkivet", "sourceBody": "Kommandot tar anropas med -C \"$staging_root\" . och arkiverar därmed hela roten i den tillfälliga katalogen: rootfs/, metadata/ och manifest.json. Alla tre datablocken ligger bredvid varandra högst upp i tar-arkivet. Uppackningen ger exakt samma träd som återställningskoden använder." }, "sidecar": { "heading": "JSON-sidofilen", "intro": "Varje framgångsrik lokal backup producerar en följeslagare fil: HOSTNAME-TIMESTAMP.tar.zst.proxmenux.json, skriven bredvid arkivet av hb_write_archive_sidecar. Denna lilla JSON-fil låter ProxMenux Monitor identifiera arkivet som en ProxMenux-värdbackup även om det senare flyttas, bytas namn eller arkiveras någon annanstans.", "contentTitle": "Sidofilens innehåll", "contentBody": "Sidofilen lagrar schemaversionen, om säkerhetskopian kom från en interaktiv körning eller ett schemalagt jobb (kind), jobb-ID för schemalagda körningar, det profilläge som används (default eller custom), källvärdnamnet, den ursprungliga arkivbasnamnet, en tidsstämpel för skapandet i ISO-8601-format och arkivstorleken i byte.", "whyBody": "Monitors Backups-flik söker igenom konfigurerade lokala kataloger efter *.proxmenux.json-sidofiler, inte efter *.tar.zst-filer, eftersom en .tar.zst utan sidofil kanske inte är en ProxMenux-säkerhetskopia. Sökningen är snabb (JSON-filer är små) och kopplingen fungerar även efter namnbyte om sidofilen får ett motsvarande nytt namn." }, "restoreAccess": { "heading": "Återställande från ett lokalt arkiv", "body": "ProxMenux återställningsflödet upptäcker lokala arkiv genom att skanna det konfigurerade lokala målet efter sidofiler och visa dem i arkivlistan. Valet av ett arkiv utlöser _rs_check_layout, som extraherar tarball i en staging katalog och bekräftar strukturen med tre datablock innan du fortsätter. För manuell utvinning utanför ProxMenux ger tar --zstd -xf hostcfg-HOSTNAME-TIMESTAMP.tar.zst -C /tmp/hostcfg samma träd som återställningskoden förbrukar." } }