Proxmox BS: Obnovitev datotek iz varnostne kopije VM

Uvod

Ta vodnik razlaga, kako uporabiti Proxmox Backup Server za obnovitev na ravni datotek iz varnostne kopije navideznega stroja, ne da bi bilo treba vzpostaviti celoten navidezni stroj. Naučili se boste, kako pridobiti posamezne datoteke prek brskalnika datotek varnostnih kopij Proxmox v spletnem vmesniku Proxmox VE in kako izvesti obnovitev datotek Proxmox iz ukazne vrstice z orodjem proxmox-backup-client. Ta potek dela je uporaben, kadar morate obnoviti posamezne datoteke, ki jih vsebujejo varnostne kopije Proxmox, ne da bi izvedli popolno obnovitev navideznega stroja.

Ciljna publika: sistemski administratorji srednje ravni
Ocenjeni čas: 20–40 minut
Končni cilj: Ob koncu tega vodnika boste lahko obnovili določene datoteke iz varnostne kopije navideznega stroja na strežniku Proxmox Backup Server, ne da bi obnovili celoten navidezni stroj.

Predpogoji

Preden začnete, poskrbite, da imate:

• Delujoč gostitelj Proxmox VE z nastavljenim shranjevalnikom Proxmox Backup Server.
• Proxmox Backup Server 3.x ali 4.x z obstoječim datastore.
• Dokončano varnostno kopijo navideznega stroja, shranjeno v datastore PBS.
• Dostop do spletnega vmesnika Proxmox VE z dovoljenji za brskanje po varnostnih kopijah in obnavljanje datotek.
• Dostop do lupine (shell) gostitelja Proxmox VE za metodo CLI.
• Ukaz proxmox-backup-client, ki je na voljo na gostitelju Proxmox VE.
• Dostop do lupine kot root za metodo preslikave prek CLI, ker preslikava naprav loop in priklop datotečnih sistemov zahtevata povišane pravice.
• Datoteko šifrirnega ključa, če varnostna kopija navideznega stroja uporablja šifriranje na strani odjemalca.
• Osnovno znanje o datotečnih sistemih Linux, priklopnih točkah in shranjevalniku varnostnih kopij Proxmox VE.

Korak 1: Spoznajte možnosti obnovitve na ravni datotek

Proxmox Backup Server shranjuje varnostne kopije navideznih strojev Proxmox VE kot varnostne kopije slik diskov na ravni blokov. To pomeni, da varnostna kopija navideznega stroja običajno vsebuje datoteke, kot so drive-scsi0.img.fidx, qemu-server.conf.blob in client.log.blob, ne pa običajnega drevesa map.

Za podrobno obnavljanje datotek v Proxmox VE imate dve praktični možnosti:

• Uporabite spletni vmesnik Proxmox VE za brskanje po posnetku (snapshot) varnostne kopije in prenos datotek.
• Uporabite proxmox-backup-client map, da sliko diska navideznega stroja iz varnostne kopije preslikate na lokalno napravo loop, nato pa datotečni sistem gosta priklopite samo za branje.

Gumb File Restore v Proxmox VE odpre brskalnik datotek za vsebino varnostne kopije. Ukaz proxmox-backup-client map preslika sliko pogona varnostne kopije navideznega stroja na lokalno napravo loopback, po končani obnovitvi pa mu mora slediti unmap.

Korak 2: Obnovite posamezne datoteke prek spletnega vmesnika Proxmox VE

To metodo uporabite, kadar želite določene datoteke pridobiti na najpreprostejši način, ne da bi vzpostavili celoten navidezni stroj.

Odprite pogled varnostnih kopij

1. Prijavite se v spletni vmesnik Proxmox VE.
2. V levem navigacijskem drevesu izberite navidezni stroj.
3. Odprite zavihek Backup.
4. V izbirniku shranjevalnikov izberite shranjevalnik Proxmox Backup Server, če ima vaše okolje več shranjevalnikov varnostnih kopij.

Videti bi morali seznam razpoložljivih posnetkov varnostnih kopij za izbrani navidezni stroj.

Odprite brskalnik datotek varnostnih kopij Proxmox

1. Izberite posnetek varnostne kopije, ki vsebuje potrebno datoteko.
2. Kliknite File Restore.
3. Počakajte, da Proxmox VE odpre brskalnik datotek varnostne kopije.
4. Razširite disk navideznega stroja, ki vsebuje operacijski sistem gosta ali podatkovni nosilec.

Zdaj brskate po posnetkih varnostnih kopij prek vmesnika Proxmox VE. Ta pogled podpira potek dela za obnavljanje datotek iz strežnika Proxmox Backup Server in omogoča obnovitev izbranih podatkov brez popolne obnovitve navideznega stroja.

Prenesite potrebno datoteko

1. Pojdite v mapo, ki vsebuje datoteko.
2. Izberite datoteko.
3. Kliknite Download.
4. Datoteko shranite na svoj delovni računalnik.

Izbrano datoteko bi morali prejeti prek brskalnika. S tem je obnovitev na ravni datotek iz varnostne kopije navideznega stroja prek brskalnika končana.

Korak 3: Pripravite okolje CLI

To metodo uporabite, kadar podatke iz varnostnih kopij v datastore PBS obnavljate iz ukazne vrstice.

Določite spremenljivke za obnovitev

Naslednje ukaze zaženite na gostitelju Proxmox VE. Nadomestne oznake zamenjajte z vrednostmi iz svojega okolja.

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>"

Primeri vrednosti:

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..."

Spremenljivke določajo repozitorij PBS, posnetek varnostne kopije navideznega stroja, arhiv diska za preslikavo, začasno priklopno točko in lokalni ciljni imenik obnovitve. Nastavite okoljski spremenljivki PBS_PASSWORD in PBS_FINGERPRINT. Prstni odtis (fingerprint) potrdila pridobite na strežniku Proxmox Backup Server z ukazom proxmox-backup-manager cert info.

Ob prvi povezavi ukaz login interaktivno zahteva potrditev prstnega odtisa potrdila in vnos gesla. Brez teh spremenljivk avtomatizirani ukazi spodletijo z napako certificate validation failed, kadar prstni odtis manjka, ali z napako no password input mechanism available, kadar geslo ni podano.

Prijavite se v Proxmox Backup Server

Zaženite ukaz za prijavo:

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

Pričakovani izhod:

Password:

Vnesite geslo uporabnika PBS. Če je overitev uspešna, odjemalec shrani začasno vstopnico (ticket).

Korak 4: Določite posnetek varnostne kopije navideznega stroja in arhiv diska

Izpišite skupine varnostnih kopij v repozitoriju PBS:

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

Primer izhoda: tabela varnostnih kopij.

Izpišite posnetke skupine navideznega stroja:

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

Primer izhoda: tabela posnetkov.

Izpišite datoteke v izbranem posnetku:

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

Primer izhoda:

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

Korak 5: Preslikajte disk varnostne kopije navideznega stroja na napravo loop

Ustvarite imenike za obnovitev:

mkdir -p "$RESTORE_MOUNT" "$RESTORE_TARGET"

Preslikajte sliko diska navideznega stroja iz PBS:

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

Primer izhoda:

/dev/loop0

Vrnjeno napravo loop shranite v spremenljivko:

export LOOP_DEVICE="/dev/loop0"

Ukaz map preslika sliko pogona varnostne kopije navideznega stroja na lokalno napravo loopback.

Korak 6: Preglejte preslikani disk

Izpišite particije in datotečne sisteme:

lsblk -f "$LOOP_DEVICE"

Primer izhoda:

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

Če se particije ne prikažejo, jedru naročite, naj prebere particijsko tabelo:

partx -a "$LOOP_DEVICE"

Nato ponovno preverite:

lsblk -f "$LOOP_DEVICE"

Zdaj bi morali videti particijske naprave, kot sta /dev/loop0p1 in /dev/loop0p2.

Korak 7: Datotečni sistem gosta priklopite samo za branje

Izberite particijo, ki vsebuje potrebne datoteke. V tem primeru je korenski datotečni sistem Linuxa /dev/loop0p2.

Priklopite jo samo za branje:

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

Pričakovani izhod: ukaz ob uspešnem priklopu ne bi smel vrniti nobenega izhoda.

Preverite priklopljeni datotečni sistem:

ls "$RESTORE_MOUNT"

Primer izhoda:

bin
boot
etc
home
root
usr
var

Zdaj z ukazno vrstico obnavljate posamezne datoteke iz varnostnih kopij Proxmox, ne da bi obnovili celoten navidezni stroj.

Priklopite nosilec LVM, če gost uporablja LVM

Če lsblk -f prikaže LVM2_member, poiščite skupine nosilcev:

vgscan --mknodes

Primer izhoda:

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

Aktivirajte skupino nosilcev:

vgchange -ay ubuntu-vg

Izpišite logične nosilce:

lvs

Primer izhoda:

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

Logični nosilec priklopite samo za branje:

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

Zdaj bi morali biti sposobni brskati po obnovljenem datotečnem sistemu gosta v $RESTORE_MOUNT.

Korak 8: Kopirajte določene datoteke iz varnostne kopije

Ustvarite lokalni imenik za obnovljene datoteke:

mkdir -p "$RESTORE_TARGET"

Kopirajte eno datoteko:

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

Pričakovani izhod: ukaz ob uspešnem kopiranju datoteke ne bi smel vrniti nobenega izhoda.

Kopirajte imenik:

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

Pričakovani izhod: ukaz ob uspešnem kopiranju imenika ne bi smel vrniti nobenega izhoda.

Preverite kopirane datoteke:

find "$RESTORE_TARGET" -maxdepth 3 -type f

Primer izhoda:

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

Korak 9: Obnovite datoteke iz varnostne kopije PBS na osnovi datotek s pxar

Ta korak je pri obnovitvi datotek iz navideznega stroja neobvezen, vendar je uporaben, kadar posnetek varnostne kopije vsebuje arhiv datotek, kot je root.pxar.

Izpišite datoteke v posnetku:

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

Primer izhoda:

catalog.pcat1.didx
root.pxar.didx

Odprite interaktivno lupino za obnovitev:

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

V lupini izpišite imenike:

pxar:/ > ls

Primer izhoda:

etc
home
root
var

Izberite datoteko:

pxar:/ > select /etc/hostname

Obnovite izbrane datoteke:

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

Zapustite lupino:

pxar:/ > exit

Korak 10: Počistite sejo obnovitve CLI

Odklopite datotečni sistem gosta:

umount "$RESTORE_MOUNT"

Če ste aktivirali skupino nosilcev LVM, jo po odklopu deaktivirajte:

vgchange -an ubuntu-vg

Odstranite preslikave particij, če ste jih ustvarili z ukazom partx:

partx -d "$LOOP_DEVICE"

Odstranite preslikavo naprave loop PBS:

proxmox-backup-client unmap "$LOOP_DEVICE"

Pričakovani izhod: ukaz ob uspešni odstranitvi preslikave naprave loop ne bi smel vrniti nobenega izhoda.

Odstranite začasne priklopne imenike, če jih ne potrebujete več:

rmdir "$RESTORE_MOUNT"

Odstranite občutljive okoljske spremenljivke:

unset PBS_PASSWORD
unset PBS_REPOSITORY
unset PBS_SNAPSHOT
unset PBS_ARCHIVE
unset LOOP_DEVICE

Lokalno okolje za obnovitev je zdaj počiščeno.

Preverjanje

Preverite, ali obnovljene datoteke obstajajo:

ls -la "$RESTORE_TARGET"

Primer izhoda:

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

Kjer je primerno, primerjajte vsebino datotek:

cat "$RESTORE_TARGET/hostname"

Primer izhoda:

app-vm-01

Potrdite, da je obnovljena kopija zunaj priklopljenega datotečnega sistema varnostne kopije:

realpath "$RESTORE_TARGET"

Primer izhoda:

/root/restored-from-pbs

Preverite, da po čiščenju ni ostala nobena preslikava loop PBS:

losetup -a | grep pbs-loopdev || true

Pričakovani izhod: če ukaz ne vrne nobenega izhoda, ni ostala nobena preslikava loop proxmox-backup.

Razveljavitev sprememb

Ta vodnik ne spreminja izvirne varnostne kopije navideznega stroja niti datastore PBS. Metoda prek spletnega vmesnika datoteke prenese samo na vaš delovni računalnik. Metoda CLI ustvari začasne preslikave loop, priklopne točke in lokalne kopije obnovljenih datotek.

Za razveljavitev okolja za obnovitev CLI zaženite:

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

Če ste aktivirali skupino nosilcev LVM gosta, jo deaktivirajte:

vgchange -an ubuntu-vg

Če ste preslikave particij dodali ročno, jih odstranite:

partx -d "$LOOP_DEVICE"

Odpravljanje težav

Gumb File Restore manjka

Preverite, ali ste izbrali posnetek varnostne kopije v shranjevalniku PBS in ne v lokalnem shranjevalniku ISO ali slik. Preverite tudi, ali ima vaš račun dovolj pravic za brskanje po vsebini varnostnih kopij.

Spletni brskalnik datotek ne more prebrati datotečnega sistema

Datotečni sistem gosta morda ni podprt, je šifriran znotraj navideznega stroja, poškodovan ali se nahaja znotraj LVM, RAID ali druge plasti shranjevanja. Preizkusite metodo CLI, da lahko particije ročno pregledate z ukazi lsblk, blkid, vgscan in orodji, specifičnimi za datotečni sistem.

proxmox-backup-client map spodleti z napakami overjanja

Preverite niz repozitorija in poverilnice:

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

Pričakovana oblika repozitorija:

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

Če uporabljate namespace, dodajte --ns ustreznim ukazom proxmox-backup-client.

Varnostna kopija je šifrirana

Pri preslikavi varnostne kopije podajte datoteko ključa:

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

Primer izhoda:

/dev/loop0

Particijske naprave se ne prikažejo

Zaženite:

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

Če disk uporablja LVM, zaženite:

vgscan --mknodes
lvs

Če disk uporablja programski RAID, ZFS znotraj gosta ali šifriranje celotnega diska, uporabite ustrezna orodja za shranjevanje gosta in obnovljene datoteke po možnosti priklopite samo za branje.

Priklop spodleti zaradi napačne vrste datotečnega sistema

Preverite vrsto datotečnega sistema:

blkid

Primer izhoda:

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

Nato po potrebi priklopite z ustrezno vrsto:

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

Kopiranje datotek ohrani napačnega lastnika

Pri kopiranju datotek kot root iz priklopljenega datotečnega sistema gosta se lahko lastništvo sklicuje na številske ID-je uporabnikov gosta. To je pričakovano. Uporabite rsync -a, da ohranite metapodatke za poznejši pregled, ali kopirajte brez ohranjanja lastništva, če potrebujete le vsebino datotek.

Zaključek

Obnovili ste posamezne datoteke iz varnostne kopije navideznega stroja na strežniku Proxmox Backup Server, ne da bi vzpostavili celoten navidezni stroj. Metoda prek spletnega vmesnika je najhitrejša pot za večino nalog obnavljanja datotek iz strežnika Proxmox Backup Server, medtem ko metoda CLI omogoča natančen nadzor pri naprednem obnavljanju datotek v Proxmoxu in pregledovanju datotečnih sistemov. Pri rutinskem delu najprej uporabite potek dela File Restore v Proxmox VE, proxmox-backup-client map pa uporabite, kadar potrebujete globlje obnavljanje iz ukazne vrstice iz datastore PBS.

Naslednji koraki

Razmislite o dokumentiranju svojega internega postopka obnovitve z natančnimi imeni repozitorijev PBS, namespace, ID-ji navideznih strojev, lokacijo hrambe šifrirnega ključa in kontrolnim seznamom za preverjanje obnovitve. Obnovitev na ravni datotek lahko tudi redno preizkušate kot del preverjanja varnostnih kopij, saj je varnostna kopija koristna le, če lahko iz nje obnovite potrebne podatke.

Različica dokumenta: 1.0
Zadnja posodobitev: junij 2026
Lastnik: Ekipa za tehnično dokumentacijo