Info::pcLuks copie cryptée
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/--createKeygé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 :
- 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).
- 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) :
- option CLI explicite
- section
[NOM_MODULE]depcLuks.ini - section globale de
pcLuks.ini(clés avant toute
section, s'applique à tous les modules non surchargés)
- valeur déduite (
--image/--mapper/
--mountpoint: module + machine locale ;--keyfile: machine locale seule)
- 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 |