# Der Explorer

```bash
pvesnap-explorer                  # Gast und Snapshot auswählen
pvesnap-explorer 101              # Snapshot von VM 101 auswählen
pvesnap-explorer 101 <snapname>   # direkt öffnen
```

Braucht `root` — Snapshots einbinden und mounten geht nicht anders.

---

## Drei Ebenen

<div class="ablauf" markdown>

**Gastauswahl** → **Snapshot-Auswahl** → **Dateien**

</div>

Mit ++q++ geht es jeweils eine Ebene zurück. Beim Verlassen des Dateibrowsers
wird der Snapshot wieder ausgehängt, sodass man gleich den nächsten öffnen kann.

### 1. Welcher Gast?

![Gastauswahl](../bilder/explorer-gastauswahl.svg)

Alle VMs und Container des Clusters, mit Zustand und Node. Ein gestoppter Gast
ist kein Hindernis — sein Snapshot lässt sich genauso lesen.

### 2. Welcher Snapshot?

![Snapshot-Auswahl](../bilder/explorer-snapshotauswahl.svg)

Neueste zuerst, mit Datum und Beschreibung. Die Beschreibung ist der Grund,
warum es sich lohnt, sie in der Konfiguration ordentlich zu setzen — hier sucht
man später danach.

Halbfertige Einträge aus abgebrochenen Läufen werden ausgeblendet; wenn welche
da sind, sagt eine Meldung, wie man sie loswird.

### 3. Die Dateien

![Der Explorer mit zwei Fenstern](../bilder/explorer-fenster.svg)

Links der Snapshot, rechts der lokale Rechner. Oben steht, welcher Gast und
welcher Snapshot offen ist, unten der volle Pfad des markierten Eintrags.

---

## Tastenbelegung

| Taste | |
|---|---|
| ++tab++ | Fenster wechseln |
| ++up++ ++down++ | bewegen |
| ++enter++ | Verzeichnis öffnen oder Datei ansehen |
| ++backspace++ ++left++ | ein Verzeichnis hoch |
| ++home++ ++end++ | Anfang / Ende |
| ++page-up++ ++page-down++ | seitenweise |
| ++space++ | markieren |
| ++asterisk++ | Markierung umkehren |
| ++a++ / ++u++ | alle markieren / keine |
| ++f5++ oder ++c++ | Markiertes ins andere Fenster kopieren |
| ++f3++ oder ++v++ | Datei ansehen (Text oder Hex) |
| ++f7++ oder ++n++ | neues Verzeichnis (nur im lokalen Fenster) |
| ++f6++ oder ++g++ | Verzeichnis direkt eingeben |
| ++f2++ oder ++m++ | [Laufwerk wählen](#laufwerk-wahlen) |
| ++r++ | neu einlesen |
| ++f10++ oder ++q++ | eine Ebene zurück |
| ++question++ oder ++f1++ | Hilfe |

Die Hilfe ist jederzeit erreichbar:

![Die Tastenhilfe](../bilder/explorer-hilfe.svg)

---

## Kopieren

Markieren mit ++space++ — markierte Einträge stehen in Gelb:

![Markierte Dateien](../bilder/explorer-markiert.svg)

Dann ++f5++:

![Der Kopierdialog](../bilder/explorer-kopieren.svg)

Kopiert wird **immer vom aktiven ins andere Fenster**. In den Snapshot hinein
geht nichts — er ist schreibgeschützt eingebunden.

Während des Kopierens läuft ein Fortschrittsbalken; ++esc++ bricht ab. Bereits
kopierte Dateien bleiben dabei liegen, die gerade laufende wird entfernt, damit
kein halbes Stück zurückbleibt.

Existiert eine Datei am Ziel schon, wird gefragt:

| Antwort | |
|---|---|
| `ja` | diese überschreiben |
| `nein` | diese überspringen |
| `alle` | alles Weitere überschreiben, nicht mehr fragen |
| `keine` | alles Weitere überspringen |

**Was übersprungen wird:** Gerätedateien, Sockets und FIFOs. Symbolische
Verweise bleiben Verweise — sie werden nicht aufgelöst.

!!! tip "Aus mehreren Snapshots ins selbe Ziel"

    Das rechte Fenster behält sein Verzeichnis, auch wenn man zurückgeht und
    den nächsten Snapshot öffnet. Damit lassen sich mehrere Stände bequem
    nebeneinander sammeln — etwa dieselbe Konfigurationsdatei von gestern,
    vorgestern und vom Monatsersten.

---

## Dateien ansehen

++f3++ zeigt eine Datei, ohne sie zu kopieren:

![Eine Datei ansehen](../bilder/explorer-ansehen.svg)

Text wird als Text dargestellt, alles andere als Hexdump. Das reicht meist
schon, um die Frage „ist das die richtige Fassung?" zu beantworten — ohne die
Datei erst auf den Host zu holen.

---

## Laufwerk wählen

++f2++ öffnet eine Liste mit zwei Arten von Einträgen:

![Die Laufwerkswahl](../bilder/explorer-laufwerke.svg)

### Dateisysteme des Snapshots

Eine VM hat oft mehr als eine Partition: `/` und `/boot`, dazu vielleicht ein
eigenes Datenlaufwerk. Hat der Snapshot mehrere brauchbare Dateisysteme, fragt
der Explorer schon beim Öffnen, welches er zeigen soll — hier lässt sich
später ohne Schließen wechseln.

!!! note "Was nicht auftaucht"

    Swap-Partitionen, EFI-Partitionen ohne lesbaren Inhalt und alles, was der
    Kernel nicht kennt. LVM innerhalb der VM wird erkannt und aktiviert;
    verschlüsselte Volumes bleiben verschlüsselt.

### Austauschlaufwerke

Darunter stehen die
[Austauschlaufwerke](../wiederherstellen/transfer.md). Wählt man eines aus,
wird es am Host eingehängt und **im rechten Fenster** geöffnet.

Damit lässt sich aus einem Snapshot direkt auf das Austauschmedium kopieren,
das anschließend in eine [wiederhergestellte
Maschine](../wiederherstellen/index.md) wandert — ohne Umweg über
`pvesnap-recovery` und ohne Zwischenlager auf dem Host.

<div class="ablauf" markdown>

**Der typische Fall:** Vor dem Notfall die Werkzeuge zusammenstellen. Snapshot
öffnen, ++f2++, Austauschlaufwerk wählen, die gebrauchten Binärdateien und
Konfigurationen hinüberkopieren. Beim nächsten `pvesnap-recovery` steht alles
bereit.

</div>

| in der Liste | |
|---|---|
| ohne Zusatz | frei oder bereits am Host eingehängt — kann geöffnet werden |
| `[in Benutzung von 9101]` | steckt in einer Maschine. Öffnen wird abgelehnt; siehe [Host oder Gast, nie beides](../wiederherstellen/transfer.md#host-oder-gast-nie-beides) |

Beim Verlassen des Explorers wird ein so eingehängtes Laufwerk **automatisch
wieder ausgehängt** — sonst gälte es später als belegt und ließe sich nicht in
eine Maschine hängen. Ein Laufwerk, das schon vorher am Host hing, bleibt
unangetastet.

!!! note "Ohne Snapshot"

    Wird der Explorer aus der [Laufwerksverwaltung](../wiederherstellen/transfer.md)
    heraus geöffnet, gibt es kein Snapshot-Fenster. Dann landet das gewählte
    Laufwerk im **gerade aktiven** Fenster.

---

## Aufrufparameter

| Parameter | Vorgabe | Bedeutung |
|---|---|---|
| `vmid` | — | Gast direkt vorwählen |
| `snapshot` | — | Snapshot direkt vorwählen |
| `-l`, `--local <pfad>` | aktuelles Verzeichnis | Startverzeichnis im rechten Fenster |
| `-p`, `--path <pfad>` | — | beliebiges Verzeichnis öffnen, ohne Proxmox zu fragen |
| `--cleanup` | — | hängengebliebene Einbindungen lösen und beenden |
| `-v`, `--verbose` | — | ausführliches Protokoll |
| `-V`, `--version` | — | Version anzeigen |

```bash
pvesnap-explorer --local /srv/restore     # rechtes Fenster startet dort
pvesnap-explorer --path /mnt/x            # ohne Proxmox, zum Ausprobieren
pvesnap-explorer --cleanup                # nach einem Absturz aufräumen
```

`--path` ist auch der Weg, den Commander auf etwas ganz anderes loszulassen —
ein gemountetes Backup etwa. Dann braucht es weder Proxmox noch root.