Cloud-PBS TUI : un client terminal pour sauvegarder vos hôtes Linux

Sauvegarder un hôte Linux vers un Proxmox Backup Server passe par le client officiel proxmox-backup-client. C’est un outil complet et fiable, mais entièrement en ligne de commande : il faut connaître le dépôt cible, le datastore, l’espace de noms, fournir un jeton d’API, assembler les bons chemins, gérer le chiffrement et planifier l’exécution. Pour un usage occasionnel ou pour standardiser un parc, la marge d’erreur est réelle.

Nous avons développé Cloud-PBS TUI pour répondre à ce besoin : une interface en mode texte qui guide ces étapes, sans rien masquer de ce que fait proxmox-backup-client en dessous. Voici un point factuel sur l’outil et son état actuel.

Ce que c’est, et ce que ce n’est pas

Cloud-PBS TUI est une application terminal (TUI, terminal user interface) écrite en Go. Elle s’exécute directement dans une console, sans serveur graphique, ce qui la rend utilisable aussi bien sur un poste que sur un serveur en SSH.

Point important : l’outil n’embarque pas le code de proxmox-backup-client. Il l’invoque comme un sous-processus. Le client officiel doit donc être installé séparément sur l’hôte. Cloud-PBS TUI ne réimplémente pas la sauvegarde : il construit les commandes, les lance et en restitue la sortie. La logique de sauvegarde reste celle de Proxmox.

Le binaire est compilé en statique (CGO_ENABLED=0), sans dépendance externe, pour rester portable entre distributions Linux.

Les écrans

L’interface s’organise en cinq écrans, accessibles par les touches 1 à 5.

Accueil. Une vue de synthèse de la configuration courante : cible PBS, sources sélectionnées, planification active.

Cible. Le formulaire de connexion au Proxmox Backup Server : adresse du dépôt, datastore, espace de noms et jeton d’API. Les champs sont validés avant d’être enregistrés.

Sources. La sélection des chemins à inclure dans la sauvegarde. On navigue dans l’arborescence du système de fichiers pour ajouter ou retirer des répertoires, avec une estimation de la volumétrie concernée.

Planning. La planification des sauvegardes récurrentes. L’écran génère les unités systemd correspondantes (.service et .timer) à partir de presets : toutes les heures, quotidien à 02:00 ou 23:00, hebdomadaire, mensuel, ou une expression OnCalendar personnalisée.

Sauvegardes. La consultation des snapshots présents dans le datastore, et leur restauration. Les permissions du jeton sont testées au passage : un jeton limité à Datastore.Backup peut écrire des sauvegardes sans pour autant être autorisé à les lire. L’écran le signale plutôt que d’échouer sans explication.

L’exécution d’une sauvegarde se fait depuis un panneau dédié qui affiche les logs en temps réel, le temps que proxmox-backup-client traite les sources.

Le chiffrement

Cloud-PBS TUI peut générer une clé de chiffrement côté client, via proxmox-backup-client key create. La sauvegarde est alors chiffrée avant de quitter l’hôte.

La clé est générée sans phrase de passe (--kdf none) : le secret réside uniquement dans le fichier de clé, dont la confidentialité repose sur les permissions du système de fichiers. L’outil ne remplace jamais une clé existante, pour éviter de rendre des sauvegardes illisibles par accident.

La configuration

La configuration est enregistrée localement, dans les répertoires standards XDG (~/.config/cloudpbs-tui pour la configuration, ~/.local/state/cloudpbs-tui pour les logs). Le jeton d’API est traité comme un secret. La configuration est relue au lancement : on retrouve sa cible, ses sources et sa planification d’une session à l’autre.

L’état du projet à date

Le développement avance par jalons. À ce jour :

• la configuration de la cible, des sources et de la planification est complète ;
• l’exécution des sauvegardes avec logs en temps réel fonctionne ;
• le chiffrement côté client est en place ;
• la consultation et la restauration des snapshots sont disponibles ;
• une chaîne d’intégration continue compile et publie les binaires Linux (amd64 et arm64) à chaque release.

Trois versions ont été publiées, la dernière étant la v0.3.0.

Reste à venir : le packaging .deb, pour une installation via apt, et l’ouverture du code source une fois la licence finalisée. L’outil est en développement actif.

Télécharger

Le binaire est compilé et publié à chaque release. Les liens ci-dessous pointent toujours vers la dernière version :

• Linux amd64
• Linux arm64
• SHA256SUMS — sommes de contrôle SHA256

Après téléchargement, vérifiez l’intégrité de l’archive puis décompressez-la :

sha256sum -c SHA256SUMS
tar xzf cloudpbs-tui-linux-amd64.tar.gz
./cloudpbs-tui

Rappel : proxmox-backup-client doit être installé séparément sur l’hôte pour exécuter une sauvegarde réelle.

Pour qui

Cloud-PBS TUI s’adresse aux administrateurs qui sauvegardent des hôtes Linux vers un Proxmox Backup Server, qu’il s’agisse d’une instance Cloud-PBS infogérée ou d’un PBS auto-hébergé. C’est un composant de notre écosystème Cloud-PBS, conçu d’abord pour nos propres usages, et que nous ouvrons progressivement.

Vous gérez un parc Linux et la sauvegarde vers PBS vous occupe plus que de raison ? Parlons-en.