Proxmox BS: oporavak na razini datoteka iz sigurnosne kopije VM-a

Uvod

Ovaj vodič objašnjava kako koristiti Proxmox Backup Server za oporavak na razini datoteka iz sigurnosne kopije virtualnog stroja bez postavljanja cijelog virtualnog stroja. Naučit ćete kako dohvatiti pojedinačne datoteke pomoću preglednika datoteka sigurnosnih kopija Proxmox u web sučelju Proxmox VE te kako izvesti oporavak datoteka Proxmox iz naredbenog retka pomoću alata proxmox-backup-client. Ovaj tijek rada koristan je kada trebate vratiti pojedinačne datoteke koje sadrže sigurnosne kopije Proxmox, bez potpunog vraćanja virtualnog stroja.

Ciljana publika: sistemski administratori srednje razine
Procijenjeno vrijeme: 20 – 40 minuta
Krajnji cilj: Na kraju ovog vodiča moći ćete vratiti određene datoteke iz sigurnosne kopije virtualnog stroja na poslužitelju Proxmox Backup Server bez vraćanja cijelog virtualnog stroja.

Preduvjeti

Prije početka provjerite imate li sljedeće:

• Ispravan Proxmox VE host s konfiguriranim Proxmox Backup Server pohranom.
• Proxmox Backup Server 3.x ili 4.x s postojećim datastoreom.
• Dovršenu sigurnosnu kopiju virtualnog stroja pohranjenu u PBS datastoreu.
• Pristup web sučelju Proxmox VE s dopuštenjima za pregledavanje sigurnosnih kopija i vraćanje datoteka.
• Pristup ljusci (shell) Proxmox VE hosta za CLI metodu.
• Naredbu proxmox-backup-client dostupnu na Proxmox VE hostu.
• Pristup root ljusci za CLI metodu mapiranja, jer mapiranje loop uređaja i montiranje datotečnih sustava zahtijevaju povišena ovlaštenja.
• Datoteku šifrirnog ključa ako sigurnosna kopija virtualnog stroja koristi šifriranje na strani klijenta.
• Osnovno znanje o Linux datotečnim sustavima, točkama montiranja i pohrani sigurnosnih kopija Proxmox VE.

Korak 1: Upoznajte opcije oporavka na razini datoteka

Proxmox Backup Server pohranjuje sigurnosne kopije virtualnih strojeva Proxmox VE kao sigurnosne kopije slika diskova na razini blokova. To znači da sigurnosna kopija virtualnog stroja obično sadrži datoteke poput drive-scsi0.img.fidx, qemu-server.conf.blob i client.log.blob, a ne uobičajeno stablo direktorija.

Za detaljan oporavak datoteka u Proxmox VE na raspolaganju su dvije praktične opcije:

• Koristite web sučelje Proxmox VE za pregledavanje snimke (snapshot) sigurnosne kopije i preuzimanje datoteka.
• Koristite proxmox-backup-client map za mapiranje slike diska virtualnog stroja iz sigurnosne kopije na lokalni loop uređaj, a zatim montirajte datotečni sustav gosta samo za čitanje.

Gumb File Restore u Proxmox VE otvara preglednik datoteka za sadržaj sigurnosne kopije. Naredba proxmox-backup-client map mapira sliku pogona sigurnosne kopije virtualnog stroja na lokalni loopback uređaj, a nakon oporavka treba je slijediti naredba unmap.

Korak 2: Vratite pojedinačne datoteke putem web sučelja Proxmox VE

Koristite ovu metodu kada želite na najjednostavniji način dohvatiti određene datoteke bez postavljanja cijelog virtualnog stroja.

Otvorite prikaz sigurnosnih kopija

1. Prijavite se u web sučelje Proxmox VE.
2. U lijevom navigacijskom stablu odaberite virtualni stroj.
3. Otvorite karticu Backup.
4. Odaberite pohranu Proxmox Backup Server u izborniku pohrane ako vaše okruženje ima više pohrana sigurnosnih kopija.

Trebali biste vidjeti popis dostupnih snimki sigurnosnih kopija za odabrani virtualni stroj.

Otvorite preglednik datoteka sigurnosnih kopija Proxmox

1. Odaberite snimku sigurnosne kopije koja sadrži potrebnu datoteku.
2. Kliknite File Restore.
3. Pričekajte da Proxmox VE otvori preglednik datoteka sigurnosne kopije.
4. Proširite disk virtualnog stroja koji sadrži operacijski sustav gosta ili podatkovni volumen.

Sada pregledavate snimke sigurnosnih kopija putem sučelja Proxmox VE. Ovaj prikaz podržava tijek rada vraćanja datoteka s poslužitelja Proxmox Backup Server i omogućuje oporavak odabranih podataka bez potpunog vraćanja virtualnog stroja.

Preuzmite potrebnu datoteku

1. Idite do direktorija koji sadrži datoteku.
2. Odaberite datoteku.
3. Kliknite Download.
4. Spremite datoteku na svoje radno računalo.

Odabranu datoteku trebali biste primiti putem preglednika. Time je dovršen oporavak na razini datoteka iz sigurnosne kopije virtualnog stroja putem preglednika.

Korak 3: Pripremite CLI okruženje

Koristite ovu metodu kada podatke iz sigurnosnih kopija u PBS datastoreu vraćate putem naredbenog retka.

Definirajte varijable za oporavak

Pokrenite sljedeće naredbe na Proxmox VE hostu. Zamijenite rezervirana mjesta vrijednostima iz svog okruženja.

export PBS_REPOSITORY="<PBS_USER>@<PBS_REALM>@<PBS_SERVER>:<DATASTORE>"
export PBS_SNAPSHOT="vm/<VM_ID>/<SNAPSHOT_TIMESTAMP>"
export PBS_ARCHIVE="drive-scsi0.img"
export RESTORE_MOUNT="/mnt/pbs-file-restore"
export RESTORE_TARGET="/root/restored-from-pbs"
export PBS_PASSWORD="<PBS_USER_PASSWORD>"
export PBS_FINGERPRINT="<PBS_SERVER_FINGERPRINT>"

Primjeri vrijednosti:

export PBS_REPOSITORY="root@[email protected]:backup"
export PBS_SNAPSHOT="vm/101/2026-06-04T01:30:00Z"
export PBS_ARCHIVE="drive-scsi0.img"
export RESTORE_MOUNT="/mnt/pbs-file-restore"
export RESTORE_TARGET="/root/restored-from-pbs"
export PBS_PASSWORD="12345678"
export PBS_FINGERPRINT="b1:89:bd:c9:b1:f8:33..."

Varijable definiraju PBS repozitorij, snimku sigurnosne kopije virtualnog stroja, arhiv diska za mapiranje, privremenu točku montiranja i lokalno odredište oporavka. Postavite varijable okruženja PBS_PASSWORD i PBS_FINGERPRINT. Otisak (fingerprint) certifikata dohvatite na poslužitelju Proxmox Backup Server pokretanjem naredbe proxmox-backup-manager cert info.

Pri prvom povezivanju naredba login interaktivno traži potvrdu otiska certifikata i unos lozinke. Bez ovih varijabli automatizirane naredbe ne uspijevaju s porukom certificate validation failed kada otisak nedostaje ili s porukom no password input mechanism available kada lozinka nije zadana.

Prijavite se na Proxmox Backup Server

Pokrenite naredbu za prijavu:

proxmox-backup-client login --repository "$PBS_REPOSITORY"

Očekivani izlaz:

Password:

Unesite lozinku PBS korisnika. Ako autentifikacija uspije, klijent pohranjuje privremenu ulaznicu (ticket).

Korak 4: Odredite snimku sigurnosne kopije virtualnog stroja i arhiv diska

Ispišite grupe sigurnosnih kopija u PBS repozitoriju:

proxmox-backup-client list --repository "$PBS_REPOSITORY"

Primjer očekivanog izlaza: tablica sigurnosnih kopija.

Ispišite snimke grupe virtualnog stroja:

proxmox-backup-client snapshot list vm/<VM_ID> \
  --repository "$PBS_REPOSITORY"

Primjer očekivanog izlaza: tablica snimki.

Ispišite datoteke u odabranoj snimci:

proxmox-backup-client snapshot files "$PBS_SNAPSHOT" \
  --repository "$PBS_REPOSITORY"

Primjer očekivanog izlaza:

client.log.blob
drive-scsi0.img.fidx
index.json.blob
qemu-server.conf.blob

Korak 5: Mapirajte disk sigurnosne kopije virtualnog stroja na loop uređaj

Izradite direktorije za vraćanje:

mkdir -p "$RESTORE_MOUNT" "$RESTORE_TARGET"

Mapirajte sliku diska virtualnog stroja iz PBS-a:

proxmox-backup-client map "$PBS_SNAPSHOT" "$PBS_ARCHIVE" \
  --repository "$PBS_REPOSITORY"

Primjer očekivanog izlaza:

/dev/loop0

Vraćeni loop uređaj spremite u varijablu:

export LOOP_DEVICE="/dev/loop0"

Naredba map mapira sliku pogona sigurnosne kopije virtualnog stroja na lokalni loopback uređaj.

Korak 6: Pregledajte mapirani disk

Ispišite particije i datotečne sustave:

lsblk -f "$LOOP_DEVICE"

Primjer očekivanog izlaza:

NAME        FSTYPE LABEL UUID                                 MOUNTPOINTS
loop0
├─loop0p1   vfat         1111-2222
└─loop0p2   ext4         aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

Ako se particije ne pojave, zatražite od jezgre da pročita particijsku tablicu:

partx -a "$LOOP_DEVICE"

Zatim ponovno provjerite:

lsblk -f "$LOOP_DEVICE"

Sada biste trebali vidjeti particijske uređaje poput /dev/loop0p1 i /dev/loop0p2.

Korak 7: Montirajte datotečni sustav gosta samo za čitanje

Odaberite particiju koja sadrži potrebne datoteke. U ovom primjeru korijenski datotečni sustav Linuxa je /dev/loop0p2.

Montirajte je samo za čitanje:

mount -o ro /dev/loop0p2 "$RESTORE_MOUNT"

Očekivani izlaz: naredba ne bi trebala ispisati ništa kada je montiranje uspješno.

Provjerite montirani datotečni sustav:

ls "$RESTORE_MOUNT"

Primjer očekivanog izlaza:

bin
boot
etc
home
root
usr
var

Sada putem naredbenog retka vraćate pojedinačne datoteke iz sigurnosnih kopija Proxmox, bez vraćanja cijelog virtualnog stroja.

Montirajte LVM volumen ako gost koristi LVM

Ako lsblk -f prikazuje LVM2_member, potražite grupe volumena:

vgscan --mknodes

Primjer očekivanog izlaza:

Found volume group "ubuntu-vg" using metadata type lvm2

Aktivirajte grupu volumena:

vgchange -ay ubuntu-vg

Ispišite logičke volumene:

lvs

Primjer očekivanog izlaza:

LV        VG        Attr       LSize
ubuntu-lv ubuntu-vg -wi-a----- 50.00g

Montirajte logički volumen samo za čitanje:

mount -o ro /dev/ubuntu-vg/ubuntu-lv "$RESTORE_MOUNT"

Sada biste trebali moći pregledavati vraćeni datotečni sustav gosta u $RESTORE_MOUNT.

Korak 8: Kopirajte određene datoteke iz sigurnosne kopije

Izradite lokalni direktorij za oporavljene datoteke:

mkdir -p "$RESTORE_TARGET"

Kopirajte jednu datoteku:

cp -a "$RESTORE_MOUNT/etc/hostname" "$RESTORE_TARGET/"

Očekivani izlaz: naredba ne bi trebala ispisati ništa kada je datoteka uspješno kopirana.

Kopirajte direktorij:

rsync -a "$RESTORE_MOUNT/var/www/html/" \
  "$RESTORE_TARGET/html/"

Očekivani izlaz: naredba ne bi trebala ispisati ništa kada je direktorij uspješno kopiran.

Provjerite kopirane datoteke:

find "$RESTORE_TARGET" -maxdepth 3 -type f

Primjer očekivanog izlaza:

/root/restored-from-pbs/hostname
/root/restored-from-pbs/html/index.html

Korak 9: Vratite datoteke iz PBS sigurnosne kopije temeljene na datotekama pomoću alata pxar

Ovaj je korak neobavezan za oporavak datoteka virtualnog stroja, ali je koristan kada snimka sigurnosne kopije sadrži arhiv datoteka poput root.pxar.

Ispišite datoteke u snimci:

proxmox-backup-client snapshot files "$PBS_SNAPSHOT" \
  --repository "$PBS_REPOSITORY"

Primjer očekivanog izlaza:

catalog.pcat1.didx
root.pxar.didx

Otvorite interaktivnu ljusku za vraćanje:

proxmox-backup-client catalog shell "$PBS_SNAPSHOT" root.pxar \
  --repository "$PBS_REPOSITORY"

Unutar ljuske ispišite direktorije:

pxar:/ > ls

Primjer očekivanog izlaza:

etc
home
root
var

Odaberite datoteku:

pxar:/ > select /etc/hostname

Vratite odabrane datoteke:

pxar:/ > restore-selected /root/restored-from-pxar

Izađite iz ljuske:

pxar:/ > exit

Korak 10: Očistite CLI sesiju vraćanja

Demontirajte datotečni sustav gosta:

umount "$RESTORE_MOUNT"

Ako ste aktivirali LVM grupu volumena, deaktivirajte je nakon demontiranja:

vgchange -an ubuntu-vg

Uklonite mapiranja particija ako ste ih izradili naredbom partx:

partx -d "$LOOP_DEVICE"

Uklonite mapiranje PBS loop uređaja:

proxmox-backup-client unmap "$LOOP_DEVICE"

Očekivani izlaz: naredba ne bi trebala ispisati ništa kada je mapiranje loop uređaja uspješno uklonjeno.

Uklonite privremene direktorije montiranja ako vam više ne trebaju:

rmdir "$RESTORE_MOUNT"

Uklonite osjetljive varijable okruženja:

unset PBS_PASSWORD
unset PBS_REPOSITORY
unset PBS_SNAPSHOT
unset PBS_ARCHIVE
unset LOOP_DEVICE

Lokalno okruženje za oporavak sada je očišćeno.

Provjera

Provjerite postoje li vraćene datoteke:

ls -la "$RESTORE_TARGET"

Primjer očekivanog izlaza:

total 12
drwxr-xr-x  3 root root 4096 Jun  4 02:10 .
drwx------ 10 root root 4096 Jun  4 02:10 ..
-rw-r--r--  1 root root   12 Jun  4 01:00 hostname

Prema potrebi usporedite sadržaj datoteka:

cat "$RESTORE_TARGET/hostname"

Primjer očekivanog izlaza:

app-vm-01

Potvrdite da se vraćena kopija nalazi izvan montiranog datotečnog sustava sigurnosne kopije:

realpath "$RESTORE_TARGET"

Primjer očekivanog izlaza:

/root/restored-from-pbs

Provjerite da nakon čišćenja nije ostalo nijedno PBS loop mapiranje:

losetup -a | grep pbs-loopdev || true

Očekivani izlaz: ako naredba ne ispiše ništa, nije ostalo nijedno proxmox-backup loop mapiranje.

Poništavanje promjena

Ovaj vodič ne mijenja izvornu sigurnosnu kopiju virtualnog stroja niti PBS datastore. Metoda putem web sučelja preuzima datoteke samo na vaše radno računalo. CLI metoda stvara privremena loop mapiranja, točke montiranja i lokalne kopije oporavljenih datoteka.

Za poništavanje CLI okruženja za oporavak pokrenite:

umount "$RESTORE_MOUNT"
proxmox-backup-client unmap "$LOOP_DEVICE"
rm -rf "$RESTORE_TARGET"
rmdir "$RESTORE_MOUNT"

Ako ste aktivirali LVM grupu volumena gosta, deaktivirajte je:

vgchange -an ubuntu-vg

Ako ste mapiranja particija dodali ručno, uklonite ih:

partx -d "$LOOP_DEVICE"

Rješavanje problema

Gumb File Restore nedostaje

Provjerite jeste li odabrali snimku sigurnosne kopije na PBS pohrani, a ne na lokalnoj pohrani ISO-a ili slika. Provjerite i ima li vaš račun dovoljna ovlaštenja za pregledavanje sadržaja sigurnosnih kopija.

Web preglednik datoteka ne može pročitati datotečni sustav

Datotečni sustav gosta možda nije podržan, šifriran je unutar virtualnog stroja, oštećen je ili se nalazi unutar LVM-a, RAID-a ili drugog sloja pohrane. Isprobajte CLI metodu kako biste ručno pregledali particije pomoću naredbi lsblk, blkid, vgscan i alata specifičnih za datotečni sustav.

proxmox-backup-client map ne uspijeva s pogreškama autentifikacije

Provjerite niz repozitorija i vjerodajnice:

echo "$PBS_REPOSITORY"
proxmox-backup-client login --repository "$PBS_REPOSITORY"

Očekivani format repozitorija:

<PBS_USER>@<PBS_REALM>@<PBS_SERVER>:<DATASTORE>

Ako koristite namespace, dodajte --ns relevantnim naredbama proxmox-backup-client.

Sigurnosna kopija je šifrirana

Navedite datoteku ključa pri mapiranju sigurnosne kopije:

proxmox-backup-client map "$PBS_SNAPSHOT" "$PBS_ARCHIVE" \
  --repository "$PBS_REPOSITORY" \
  --keyfile <PATH_TO_ENCRYPTION_KEY>

Primjer očekivanog izlaza:

/dev/loop0

Particijski uređaji se ne pojavljuju

Pokrenite:

partx -a "$LOOP_DEVICE"
lsblk -f "$LOOP_DEVICE"

Ako disk koristi LVM, pokrenite:

vgscan --mknodes
lvs

Ako disk koristi softverski RAID, ZFS unutar gosta ili šifriranje cijelog diska, upotrijebite odgovarajuće alate za pohranu gosta i oporavljene datoteke po mogućnosti montirajte samo za čitanje.

Montiranje ne uspijeva zbog pogrešne vrste datotečnog sustava

Provjerite vrstu datotečnog sustava:

blkid

Primjer očekivanog izlaza:

/dev/loop0p2: UUID="..." TYPE="ext4"

Zatim po potrebi montirajte s ispravnom vrstom:

mount -t ext4 -o ro /dev/loop0p2 "$RESTORE_MOUNT"

Kopiranje datoteka čuva pogrešno vlasništvo

Pri kopiranju datoteka kao root iz montiranog datotečnog sustava gosta vlasništvo se može odnositi na numeričke ID-ove korisnika iz gosta. To je očekivano. Koristite rsync -a kako biste sačuvali metapodatke za kasniji pregled ili kopirajte bez očuvanja vlasništva ako trebate samo sadržaj datoteka.

Zaključak

Vratili ste pojedinačne datoteke iz sigurnosne kopije virtualnog stroja na poslužitelju Proxmox Backup Server bez postavljanja cijelog virtualnog stroja. Metoda putem web sučelja najbrži je put za većinu zadataka vraćanja datoteka s poslužitelja Proxmox Backup Server, dok CLI metoda pruža preciznu kontrolu za napredni oporavak datoteka u Proxmoxu i pregled datotečnih sustava. Za rutinske operacije najprije koristite tijek rada File Restore u Proxmox VE, a proxmox-backup-client map koristite kada trebate dublji oporavak iz naredbenog retka iz PBS datastorea.

Sljedeći koraci

Razmislite o dokumentiranju svog internog postupka oporavka s točnim nazivima PBS repozitorija, namespaceova, ID-ovima virtualnih strojeva, lokacijom pohrane šifrirnog ključa i kontrolnim popisom za provjeru vraćanja. Oporavak na razini datoteka možete i redovito testirati kao dio provjere sigurnosnih kopija, jer je sigurnosna kopija korisna samo ako iz nje možete vratiti podatke koji su vam potrebni.

Verzija dokumenta: 1.0
Posljednje ažuriranje: lipanj 2026.
Vlasnik: Tim za tehničku dokumentaciju