Info::pcLuks copie cryptée

De wiki_pcwiki2
Aller à la navigationAller à la recherche

KEYWORDS: PCLUKS, CRYPTED COPY

Le 26/10/2026:
pcLuks permet de copier une archive cryptée sur un serveur distant alors que lui même n'a pas la clé
Le serveur distant détient donc un fichier qu'il est incapable de décrypter. 
Le vol de données est donc sans importance (par rapport au fichier bien sur, après, c'est grave  ...')

NB: les modules sont définis dans <localhost>::/root/.config/pcLuks/pcLuks.ini
Pour le moment, les ressources sont: pcroad, Atelier, etc et system 
Mais il suffit d'en ajouter d'autres dans le .ini

Exemple de copie: 
pcLuks --host=<remote host> --module <ressource>
pcLuks --host=ovh1 --module etc

Exemple de restoration:
pcLuks --recover <remote host> <local host> <ressource>
pcLuks --recover ovh1 srv18 etc
Il n'y a qu'une seule clé par serveur: /mnt/pcLuks/pcLuks.SERVER.key
Cette clé permet de décrypter toutes les images sauvegardées (ailleurs)
A ne JAMAIS perdre !!

NB: une copie de chaque clé est automatiquement envoyée à srv18::/mnt/pcLuks/KEYS_SAVED
Par contre, si l'image est volée, ce n'est pas grave, la clé n'est pas sur le serveur récipiendaire.

Par sécurité, à la fin de chaque copie, le serveur qui copie envoie sa clé sur srv18:/mnt/pcLuks/KEYS_SAVED
pcLuks copie les données essentielles (yc debian-dvt::/Atelier) vers (au moins) ovh1 et ovh2.
SEE ALSO: pcCollect [[1]] (pour collecter les données essentielles d'un serveur)
Le 27/07/2026:
pcLuks règle le problème de stocker des infos confidentielles (sources, mots de passes ...) sur un serveur distant et ouvert sur l'internet.
L'image luks a besoin d'une clé qui n’existe pas sur le serveur distant. 
Elle est juste envoyée au serveur distant juste le temps d'ouvrir l'archive.

script vite fait: pcLuks::script   --  fichier pcLuks.ini: pcLuks::ini

pcLuks

Version : 1.01

Date : 27/07/2026

Rôle : gère le cycle de vie d'un ou plusieurs conteneurs LUKS hébergés sur une ou plusieurs machines distantes (création, agrandissement, ouverture pour consultation manuelle, fermeture, suppression, installation des prérequis) et synchronise un répertoire local dessus par rsync.

Fonctionnement

Toutes les opérations distantes passent par ssh : aucun secret ne transite jamais en argument de commande NI en fichier sur le disque distant - la clé LUKS est fournie aux commandes cryptsetup qui en ont besoin via le stdin du canal ssh chiffré (--key-file -), jamais écrite là-bas, même transitoirement (voir Gestion de la clé plus bas). La connexion ssh utilise BatchMode=yes : toute invite interactive (mot de passe, confirmation de clé d'hôte inconnue) échoue immédiatement au lieu de bloquer indéfiniment.

Sans aucun argument du tout, pcLuks affiche cette aide au lieu de lancer une synchronisation avec les valeurs par défaut brutes - un appel totalement nu n'est jamais volontaire.

Sans option d'action (-c/-C/-i/-o/-x/-d/-I), le comportement par défaut est : ouverture du conteneur (idempotente - ne re-déverrouille/re-monte pas si déjà fait), synchronisation rsync, génération d'un inventaire du contenu distant (voir Listing du contenu plus bas), puis fermeture automatique. Pour ouvrir sans synchroniser ni refermer - consulter ou modifier manuellement le contenu via une session ssh séparée - voir -o/--open ; refermer ensuite avec -x/--exit.

La création est en deux temps : -C/--createKey génère d'abord la clé, puis -c/--create formate le conteneur avec cette clé. -C refuse d'écraser une clé locale existante, pour ne pas rendre illisible un conteneur déjà formaté avec l'ancienne clé.

Gestion de la clé : jamais écrite sur le disque distant

La clé LUKS n'est jamais stockée, même transitoirement, sur le serveur distant :

  • -C/--createKey génère et protège la clé

exclusivement en local, dans /mnt/pcLuks/pcLuks.<machine locale>.key (ex. pcLuks.debian-dvt.key) - une seule clé par machine locale, commune à tous ses modules, pas une par module. Protégée par l'attribut immutable (chattr +i) pour éviter une suppression accidentelle (même par root, tant que l'attribut n'est pas retiré explicitement via chattr -i).

  • Depuis le 27/07/2026 : avant toute opération distante qui en a

besoin (luksFormat/luksOpen/ cryptsetup resize), le contenu brut de la clé est lu en local puis transmis directement sur le stdin du canal ssh chiffré (cryptsetup --key-file - --keyfile-size=2048), jamais écrit sur le disque distant. --keyfile-size accompagne systématiquement --key-file - : sans lui, la lecture s'arrêterait au premier octet \n rencontré dans la clé binaire aléatoire, la tronquant silencieusement. Auparavant (versions antérieures au 27/07/2026), la clé était envoyée transitoirement par scp vers un chemin distant puis détruite par shred -u juste après - fenêtre d'exposition courte mais réelle sur un fichier physique, désormais nulle.

  • Un attaquant qui accéderait au disque distant hors ligne (image

forensique, disque volé) ne trouverait donc jamais la clé - seulement le conteneur chiffré, comme avant. La différence : même un accès root en direct au moment de l'opération ne peut plus lire la clé sur disque, puisqu'elle n'y est jamais écrite (seule une capture du canal ssh déchiffré, ou de la mémoire du process cryptsetup en cours d'exécution, le permettrait désormais).

Limite connue : aucune passphrase interactive de secours n'est définie - le fichier de clé local généré par -C est l'unique moyen de déchiffrer les conteneurs formatés avec lui, et n'existe plus qu'à cet endroit (plus de copie distante permanente à récupérer en cas de perte). S'il est perdu ou corrompu, ces conteneurs deviennent définitivement illisibles - aucune récupération possible. Sauvegardez ce fichier ailleurs si vous voulez un filet de secours supplémentaire.

Protection immuable des images distantes (27/07/2026)

La clé locale était déjà protégée par l'attribut immuable (cf. section précédente). Depuis le 27/07/2026, chaque fichier image distant bénéficie de la même protection :

  • Appliquée (chattr +i) juste après une création

(-c/--create) ou une fermeture réelle (-x/--exit, ou fermeture automatique en fin d'action par défaut).

  • Retirée (chattr -i) juste avant une ouverture

réelle (-o/--open, ou ouverture automatique en début d'action par défaut/-i/--increase) et juste avant une suppression (-d/--delete).

Objectif : éviter une suppression ou modification accidentelle du fichier image (script relancé à tort, --image mal orthographié...) pendant les longues périodes où le conteneur n'est pas activement utilisé.

Best-effort, comme pour la clé : un échec de chattr produit un avertissement (std::cerr) mais ne fait jamais échouer l'opération réelle qui suit (les commandes sont chaînées par ; et non && côté distant) - tous les systèmes de fichiers ne supportent pas cet attribut (ext2/3/4 oui). Les conteneurs de production créés avant cette date ne sont pas protégés rétroactivement ; ils le deviennent automatiquement dès leur prochaine fermeture réelle, sans action manuelle requise.

Listing du contenu

Juste avant la fermeture automatique de l'action par défaut, un inventaire récursif du contenu distant (type, taille, date, chemin - sortie de find --printf) est rapatrié et écrit dans /mnt/pcLuks/<HOTE>/LISTS/<NOM_MODULE>.filelist (pcLuks.filelist sans module) - regroupé par machine distante (--host), pour retrouver facilement tous les listings d'un même hôte quel que soit le nombre de modules qui y vivent. Fichier texte brut, consultable avec cat/less/grep sans avoir à rouvrir le conteneur. Contrairement à la clé, il n'est pas protégé par l'attribut immutable : il est régénéré (écrasé) à chaque synchronisation.

Modules

Comme les modules rsync, -m/--module NOM permet de gérer plusieurs dépôts indépendants sans répéter toutes les options à chaque fois. Sans module, le programme se comporte exactement comme un dépôt unique avec les valeurs par défaut.

Un module influence les valeurs par défaut de deux façons cumulables :

  1. Déduction automatique par le nom (sans rien configurer) :

--image, --mapper et --mountpoint intègrent le nom du module et celui de la machine locale, pour éviter toute collision entre modules de même nom - y compris entre modules sauvegardés par des machines différentes vers le même hôte. --keyfile ne dépend que de la machine locale (une seule clé, commune à tous ses modules).

  1. Fichier pcLuks.ini (optionnel, voir plus bas) :

une section [NOM] peut surcharger n'importe laquelle de ces valeurs, y compris --host/--user/ --path.

Ordre de priorité (le premier trouvé gagne) :

  1. option CLI explicite
  2. section [NOM_MODULE] de pcLuks.ini
  3. section globale de pcLuks.ini (clés avant toute
 section, s'applique à tous les modules non surchargés)
  1. valeur déduite (--image/--mapper/
 --mountpoint : module + machine locale ;
 --keyfile : machine locale seule)
  1. valeur par défaut brute (sans module)

La commande effective (valeurs par défaut/module/ini incluses) est toujours affichée avant exécution, pour savoir exactement ce qui va tourner - y compris quand une valeur vient d'un module ou du fichier ini plutôt que d'une option tapée à la main. Pour l'action par défaut (ouverture + synchronisation), la commande rsync réellement exécutée est également affichée avant lancement.

Fichier pcLuks.ini

Emplacement fixe : /root/.config/pcLuks/pcLuks.ini. Optionnel - absent, il n'a simplement aucun effet (pas une erreur).

Format : lignes cle = valeur ; sections [nom_module]. Les lignes avant toute section forment la section globale, qui s'applique à tout module qui ne les surcharge pas explicitement. Commentaires : ligne entière commençant par ; ou # - pas de commentaire en fin de ligne après une valeur (non supporté par le parseur, serait inclus dans la valeur).

Les 11 clés reconnues (section globale ET section de module) :

Clé Équivalent CLI Valeur déduite si omise
host --host aucune - retombe sur la section globale, puis localhost
user --user aucune - retombe sur la section globale, puis root
path -p/--path aucune - retombe sur la section globale, puis /Atelier
image --image /mnt/pcLuks/images/pcLuks.HOTE_LOCAL.NOM.img
keyfile --keyfile /mnt/pcLuks/pcLuks.HOTE_LOCAL.key (pas de NOM : commune à tous les modules)
mapper --mapper data.HOTE_LOCAL.NOM.pcLuks
mountpoint --mountpoint /mnt/pcLuks/HOTE_LOCAL.NOM.dir (pas /mnt)
preExecLocal aucun (ini uniquement) aucune - vide = hook désactivé
preExecRemote aucun (ini uniquement) aucune - vide = hook désactivé
postExecLocal aucun (ini uniquement) aucune - vide = hook désactivé
postExecRemote aucun (ini uniquement) aucune - vide = hook désactivé

HOTE_LOCAL = nom de la machine qui exécute pcLuks (gethostname()), pas la machine distante (host) - intégré à image/mapper/ mountpoint pour éviter qu'une autre machine sauvegardant un module de même nom vers le même host ne partage - et corrompe - le même conteneur distant.

keyfile ne désigne plus un chemin distant (depuis le 27/07/2026, la clé n'est plus jamais écrite sur le disque distant, cf. Gestion de la clé plus haut) : seul son nom de fichier sert à identifier le fichier de clé local.

preExecLocal/preExecRemote/ postExecLocal/postExecRemote (27/07/2026) : commande shell exécutée une seule fois, juste avant toute ouverture (pre) ou fermeture (post) réelle du conteneur (jamais si déjà dans l'état visé) - Local sur cette machine, Remote sur --host (via ssh). Un code de retour non nul bloque l'opération (ouverture ou fermeture annulée). Remplace le versionnement automatique intégré (pcversionning lancé après chaque copie, désormais retiré) : à brancher soi-même, typiquement via postExecRemote.

Variables d'environnement exposées à la commande (locale ou distante) : PCLUKS_HOST, PCLUKS_USER, PCLUKS_MODULE, PCLUKS_PATH, PCLUKS_IMAGE, PCLUKS_MAPPER, PCLUKS_MOUNTPOINT (valeurs déjà résolues).

Pour désactiver un hook tout en gardant sa clé visible dans le fichier (rappel qu'il est disponible) plutôt que de l'omettre : cle = "", cle = (rien après) ou cle (sans =) sont tous équivalents à une clé absente - le parseur retire les guillemets doubles entourant une valeur.

Exemple (module system) :

[system]
path = /root/debian-dvt.pcCollect
preExecLocal = pcCollect
postExecRemote = pcversionning -f -r -n 12 $PCLUKS_MOUNTPOINT

Priorité (rappel) : option CLI explicite > section [NOM_MODULE] > section globale > valeur déduite (jamais host/user/path) > valeur par défaut brute du programme.

Exemple couvrant tous les cas de figure :

; section globale : s'applique a tout module qui ne la surcharge pas
; explicitement
host = srv05
user = root

[Atelier]
; ne fixe que path -> image/mapper/mountpoint deduits du nom "Atelier"
; et de la machine locale ; keyfile deduite de la machine locale
; seule ; host/user herites de la section globale
path = /Atelier

[Documents]
; surcharge aussi host en plus de path -> le reste toujours deduit
path = /home/user/Documents
host = srv18

[system]
; preExecLocal collecte les donnees AVANT l'ouverture (local) ;
; postExecRemote versionne SUR LE DISTANT juste avant la fermeture
path = /root/debian-dvt.pcCollect
preExecLocal = pcCollect
postExecRemote = pcversionning -f -r -n 12 $PCLUKS_MOUNTPOINT

[Photos]
; les 7 cles de base explicites : rien de deduit ni herite ici
host       = srv18
user       = root
path       = /home/user/Photos
image      = /root/backups/photos.img
keyfile    = /root/.config/pcLuks/photos-secret.key
mapper     = photos_crypt
mountpoint = /mnt/photos-crypt

pcLuks -m Atelier / pcLuks -m Documents / pcLuks -m system / pcLuks -m Photos résolvent alors chacune un ensemble de valeurs différent selon ce fichier.

Syntaxe

pcLuks [action] [options]

Valeurs par défaut (sans module)

HOTE_LOCAL = nom de la machine qui exécute pcLuks (gethostname()), pas la machine distante (--host). Même sans module, la clé reste propre à cette machine.

Option Valeur par défaut
--host localhost
--user root
--image /mnt/pcLuks/images/backup.img
--keyfile /mnt/pcLuks/pcLuks.HOTE_LOCAL.key
--mapper data.pcLuks
--mountpoint /mnt/pcLuks/data.pcLuks
--path /Atelier

Valeurs déduites du module (-m NOM, si pcLuks.ini ne les fixe pas)

--keyfile est commune à tous les modules de cette machine (pas de NOM dans son nom de fichier) - --image/--mapper/--mountpoint sont eux propres à la fois au module et à la machine locale.

Option Valeur déduite
--image /mnt/pcLuks/images/pcLuks.HOTE_LOCAL.NOM.img
--keyfile /mnt/pcLuks/pcLuks.HOTE_LOCAL.key
--mapper data.HOTE_LOCAL.NOM.pcLuks
--mountpoint /mnt/pcLuks/HOTE_LOCAL.NOM.dir (pas /mnt)

Options

-h, --help

Affiche l'aide complète (fonctionnement, syntaxe, exemple par option) et quitte.

Exemple :

pcLuks --help

-V, --version

Affiche le numéro de version et la date, puis quitte.

Exemple :

pcLuks --version

-v, --verbose

Sans cette option (défaut) : seules les actions en cours (avec une brève explication) et la commande rsync de haut niveau sont affichées, pas leur détail. Avec -v : commandes ssh/ cryptsetup brutes exécutées, sortie complète de rsync (fichiers copiés/détruits) et messages de confirmation supplémentaires.

Exemple :

pcLuks -v --host=srv05 --user=root

-m, --module <nom>

Sélectionne un module (voir ci-dessus). Caractères autorisés : alphanumériques, _, -, ..

Exemple :

pcLuks --host=srv05 --user=root -m Documents -p /home/user/Documents

-p, --path <chemin>

Répertoire local à synchroniser. Sans -m ni entrée path dans pcLuks.ini, la valeur par défaut est /Atelier.

Exemple :

pcLuks --host=srv05 --user=root -p /home/user/Documents

-C, --createKey

Crée le fichier de clé LUKS (--keyfile), avec ses répertoires parents si besoin. Refuse d'écraser un fichier de clé déjà existant. Aucune passphrase interactive de secours n'est définie : ce fichier est l'unique moyen de déchiffrer les conteneurs formatés avec lui. À exécuter avant -c/--create.

Exemple :

pcLuks --host=srv05 --user=root -C

-c, --create

Crée un nouveau conteneur LUKS distant à l'emplacement --image (donné explicitement, déduit du module, ou par défaut), formaté avec le fichier de clé déjà présent (cf. -C, à exécuter au préalable), puis y crée un système de fichiers ext4. Ne prend pas le chemin en argument direct - utilisez --image= pour le fixer explicitement (piège classique de getopt_long évité : un --create suivi d'un argument requis avalait silencieusement le token suivant, même s'il ressemblait à une autre option). Si -s/--size n'est pas fourni, la taille est calculée automatiquement (1.5x la taille de --path, mesurée localement via du) et annoncée avant création - implique donc que --path (ou le module/ini) pointe déjà vers le bon répertoire au moment de la création. En cas d'échec à n'importe quelle étape (ex: -C/--createKey pas encore exécuté), le fichier image partiellement créé est automatiquement supprimé côté distant, pour ne pas laisser un fichier tronqué mais jamais formaté en LUKS qui ferait échouer la prochaine ouverture avec une erreur trompeuse. Depuis le 27/07/2026, le fichier image est ensuite protégé par l'attribut immuable (chattr +i), cf. section Protection immuable des images distantes plus bas.

Exemple :

pcLuks --host=srv05 --user=root -c --image=/mnt/pcLuks/images/backup.img -s 51200

Exemple (taille automatique) :

pcLuks --host=srv05 --user=root -p /Atelier -c --image=/mnt/pcLuks/images/backup.img

Exemple (module, image déduite) :

pcLuks -m Atelier -c -s 51200

-s, --size <Mo>

Taille du conteneur à créer, en mébioctets. Utilisable uniquement avec -c/--create. Optionnelle (voir -c/--create pour le calcul automatique si absente).

Exemple :

pcLuks --host=srv05 --user=root -c --image=/mnt/pcLuks/images/backup.img -s 51200

-i, --increase <Mo>

Agrandit de la taille donnée (en mébioctets) un conteneur existant : ouvre le conteneur si besoin (comportement identique à l'action par défaut), étend le fichier image, redimensionne le mapping LUKS puis le système de fichiers ext4.

Exemple :

pcLuks --host=srv05 --user=root -i 10240

-o, --open

Ouvre et monte le conteneur, sans synchroniser ni refermer - pour consulter ou modifier manuellement le contenu distant (via une session ssh séparée) avant de refermer vous-même avec -x/--exit. Contrairement à l'action par défaut, ne génère pas de listing et ne referme jamais automatiquement. Retire l'attribut immuable de l'image (chattr -i) juste avant l'ouverture réelle, pour permettre l'écriture (27/07/2026).

Exemple :

pcLuks --host=srv05 --user=root -o

-M, --miroir

Modifie l'action par défaut (ce n'est pas une action à part entière, rejetée avec toute autre option d'action) : ajoute --delete à rsync, donc supprime du dépôt distant les fichiers absents de --path. Par défaut, la synchronisation n'efface jamais rien à distance (sert de sauvegarde qui accumule) - -M en fait un vrai miroir. La sortie rsync (visible avec -v/--verbose) liste alors aussi les deleting .... Demande une confirmation interactive (o/N) sauf si -y/--yes est fourni.

Exemple :

pcLuks --host=srv05 --user=root -M

-x, --exit

Démonte et reverrouille le conteneur distant (sans erreur si rien n'est actuellement monté/ouvert), puis réapplique l'attribut immuable (chattr +i) sur l'image (27/07/2026).

Exemple :

pcLuks --host=srv05 --user=root -x

-d, --delete

Ferme le conteneur si besoin (comme -x), retire l'attribut immuable (chattr -i, 27/07/2026) puis supprime définitivement le fichier image distant (--image). Action irréversible : toutes les données qu'il contient sont perdues. Ne touche pas au fichier de clé (--keyfile), qui reste utilisable pour un nouveau conteneur. Demande une confirmation interactive (o/N) sauf si -y/--yes est fourni ; sans réponse explicite (ex: exécution non interactive sans -y), la suppression est annulée par défaut.

Exemple :

pcLuks --host=srv05 --user=root -d

-y, --yes

Confirme automatiquement -d/--delete ou -M/--miroir, sans demander (usage scripté/non interactif). N'a de sens qu'avec l'un des deux.

Exemple :

pcLuks --host=srv05 --user=root -d -y

-I, --install

Installe sur la machine distante les paquets requis : cryptsetup, rsync, e2fsprogs (pour resize2fs). Suppose une distribution basée sur apt (Debian/Ubuntu). Non interactif (DEBIAN_FRONTEND=noninteractive), exécute apt-get update avant l'installation.

Exemple :

pcLuks --host=srv05 --user=root -I

--host=HOTE (défaut: localhost)

Nom ou adresse de la machine distante (résolu par ssh).

Exemple :

pcLuks --host=srv05 --user=root

--user=UTILISATEUR (défaut: root)

Utilisateur ssh pour la connexion à la machine distante.

Exemple :

pcLuks --host=srv05 --user=root

--image=CHEMIN (défaut: /mnt/pcLuks/images/backup.img, ou déduit du module)

Chemin du conteneur LUKS sur la machine distante, pour les actions autres que -c/--create (qui fixe elle-même ce chemin).

Exemple :

pcLuks --host=srv05 --user=root --image=/mnt/pcLuks/images/backup2.img

--keyfile=CHEMIN (défaut: /mnt/pcLuks/pcLuks.HOTE_LOCAL.key)

Ne désigne plus un chemin distant depuis le 27/07/2026 (la clé n'est plus jamais écrite sur le disque distant, cf. Gestion de la clé plus haut) - seul le nom de fichier (sans le répertoire) sert à identifier le fichier de clé local, sous /mnt/pcLuks/. Déduit uniquement de la machine locale, jamais du module - une seule clé sert à tous les modules d'une même machine.

Exemple :

pcLuks --host=srv05 --user=root --keyfile=/mnt/pcLuks/autrecle.key

--mapper=NOM (défaut: data.pcLuks, ou déduit du module)

Nom du device-mapper utilisé pour le volume déchiffré.

Exemple :

pcLuks --host=srv05 --user=root --mapper=srcbackup

--mountpoint=CHEMIN (défaut: /mnt/pcLuks/data.pcLuks, ou déduit du module)

Point de montage distant du volume déchiffré.

Exemple :

pcLuks --host=srv05 --user=root --mountpoint=/mnt/srcbackup

Prérequis système

Machine locale : ssh, rsync, find.

Machine distante (ou locale, si --host=localhost) : cryptsetup, rsync, e2fsprogs (pour resize2fs), et une connexion ssh non interactive (clé ssh, pas de mot de passe) autorisée pour --user@--host. Voir -I/--install pour installer automatiquement les paquets distants (nécessite toutefois que ssh fonctionne déjà). pcversionning n'est utile que si un module l'invoque lui-même via preExecRemote/postExecRemote (poussé par -I/--install par commodité).

Build

Paquets Debian requis :

apt install cmake g++

Compilation :

cmake -B build -S .
cmake --build build

Mode d'emploi minimum

1) Créer un module et y copier un répertoire, sans pcLuks.ini

--host/--user/--path à répéter à chaque commande.

pcLuks --host=srv05 --user=root -m NOM -C
    -> génère la clé locale du module NOM

pcLuks --host=srv05 --user=root -m NOM -p /chemin/local -c -s 51200
    -> crée le conteneur distant (51200 Mo), formé avec cette clé

pcLuks --host=srv05 --user=root -m NOM -p /chemin/local
    -> ouvre, copie /chemin/local, génère le listing, referme
       automatiquement - à relancer telle quelle pour chaque
       synchronisation ultérieure

2) Même chose avec pcLuks.ini

(host/path déjà définis dans une section [NOM] - voir Fichier pcLuks.ini plus haut)

pcLuks -m NOM -C
    -> génère la clé locale (host/path repris de pcLuks.ini)

pcLuks -m NOM -c -s 51200
    -> crée le conteneur distant (51200 Mo)

pcLuks -m NOM
    -> ouvre, copie, génère le listing, referme automatiquement

3) Sans module (un seul dépôt, valeurs par défaut brutes)

pcLuks --host=srv05 -C
    -> génère la clé locale (chemin par défaut)

pcLuks --host=srv05 -c -s 51200
    -> crée le conteneur distant (51200 Mo)

pcLuks --host=srv05
    -> ouvre, copie /Atelier (défaut), génère le listing, referme
       automatiquement

4) Consulter ou modifier manuellement le contenu

Au lieu de la synchronisation automatique :

pcLuks -m NOM -o
    -> ouvre et monte le conteneur, sans copier ni refermer

ssh user@hote
    -> connexion manuelle ; puis cd <mountpoint>, examiner...

pcLuks -m NOM -x
    -> reverrouille le conteneur une fois terminé

Alternative sans ouvrir le conteneur : consulter le listing déjà rapatrié par la dernière synchronisation :

grep -i motcle /mnt/pcLuks/HOTE/LISTS/NOM.filelist
    -> recherche dans l'inventaire local, sans accéder au distant

5) Agrandir un conteneur existant

pcLuks -m NOM -i 10240
    -> ajoute 10240 Mo à l'espace du conteneur (ouvre si besoin)

6) Installer les prérequis sur une machine distante neuve

pcLuks --host=srv05 --user=root -I
    -> installe cryptsetup, rsync, e2fsprogs via apt

7) Script minimal à partir de rien : création puis synchronisations

Entièrement autonome - aucun besoin de pcLuks.ini, --host et tous les paramètres sont donnés explicitement.

Étape A - création (à exécuter une seule fois) : -C/-c ne sont pas rejouables sans risque (-C refuse d'écraser une clé existante ; rejouer -c reformaterait le conteneur et effacerait les données déjà synchronisées) - d'où sa séparation de l'étape B ci- dessous, à ne jamais fusionner en un seul script rejouable.

#!/usr/bin/env bash
set -euo pipefail

PCLUKS=/Atelier/pcLuks/V1.02/build/pcLuks
HOTE=srv14
USER=root
MODULE=Atelier
CHEMIN_LOCAL=/Atelier

"$PCLUKS" --host="$HOTE" --user="$USER" -m "$MODULE" -C
"$PCLUKS" --host="$HOTE" --user="$USER" -m "$MODULE" -p "$CHEMIN_LOCAL" -c

Fourni tel quel dans le dépôt : /Atelier/pcLuks/V1.02/setup-atelier.sh (exécutable, inclut aussi la première copie, cf. contenu réel du fichier).

Étape B - synchronisation (première fois, puis à chaque répétition, ex. cron) :

#!/usr/bin/env bash
set -euo pipefail

/Atelier/pcLuks/V1.02/build/pcLuks -m Atelier --host=srv14 --user=root

Fourni tel quel dans le dépôt : /Atelier/pcLuks/V1.02/sync-atelier.sh (exécutable).

Fermeture automatique du conteneur

Action Ferme automatiquement ?
(défaut, sync/-M) Oui - ouvre, copie, liste, referme
-o, --open Non - reste ouvert, refermer avec -x
-i, --increase Non - ouvre si besoin, ne referme pas
-c, --create Se referme lui-même en fin de séquence
-d, --delete Ferme d'abord (si besoin), puis supprime