Τεκμηρίωση LockBox CLI

Γρήγορη εκκίνηση

Βάλτε το LockBox.Cli.exe σε έναν φάκελο που περιλαμβάνεται στο PATH, ή καλέστε το με πλήρη διαδρομή. Ο δείκτης --cli γίνεται αποδεκτός για συμβατότητα αλλά δεν απαιτείται στην έκδοση μόνο για CLI.

.\LockBox.Cli.exe --help
.\LockBox.Cli.exe device-id
.\LockBox.Cli.exe algorithms
.\LockBox.Cli.exe keygen --count 3

Ελάχιστη ροή εργασίας δημιουργίας και ανοίγματος:

$env:LBX_MASTER = "use-a-long-master-password"
$env:LBX_L1 = "layer-1-key"

.\LockBox.Cli.exe create `
  --source "D:\Data" `
  --output "E:\Backups\data.lbx" `
  --master-env LBX_MASTER `
  --layer-env AES-128-GCM=LBX_L1

.\LockBox.Cli.exe open `
  --container "E:\Backups\data.lbx" `
  --output "D:\Restore" `
  --master-env LBX_MASTER `
  --key-env LBX_L1

Το Linux χρησιμοποιεί τις ίδιες εντολές με διαδρομές με slash και ένα δυαδικό χωρίς το επίθημα .exe:

chmod +x ./LockBox.Cli
./LockBox.Cli --help
./LockBox.Cli device-id
./LockBox.Cli create \
  --source "/srv/data" \
  --output "/backup/data.lbx" \
  --master-env LBX_MASTER \
  --layer-env AES-128-GCM=LBX_L1

Εγκατάσταση και έλεγχος CLI

Αποσυμπιέστε το ZIP για το σύστημα και τον επεξεργαστή σας. Το .NET περιλαμβάνεται. Συγκρίνετε το hash με το SHA256SUMS.txt. Τοποθετήστε το CLI στην παρακάτω απόλυτη διαδρομή και ελέγξτε βοήθεια και άδεια με τον λογαριασμό αντιγράφων ασφαλείας.

Το Linux χρειάζεται επίσης τις εγγενείς βιβλιοθήκες της διανομής, όπως ICU και OpenSSL· το ενσωματωμένο .NET δεν τις παρέχει. Στα Windows, η ισχύουσα πολιτική εκτέλεσης πρέπει να επιτρέπει σενάρια PowerShell.

.NET / Linux · PowerShell / ExecutionPolicy

Expand-Archive -LiteralPath '.\LockBox-Cli-win-x64.zip' -DestinationPath 'C:\Tools\LockBox'
& 'C:\Tools\LockBox\LockBox.Cli.exe' --help
& 'C:\Tools\LockBox\LockBox.Cli.exe' license
Get-FileHash -LiteralPath '.\LockBox-Cli-win-x64.zip' -Algorithm SHA256

uname -m
unzip LockBox-Cli-linux-x64.zip -d ./lockbox-cli
chmod +x ./lockbox-cli/LockBox.Cli
./lockbox-cli/LockBox.Cli --help
./lockbox-cli/LockBox.Cli license
sha256sum LockBox-Cli-linux-x64.zip

SHA256SUMS.txt

Windows x64   -> LockBox-Cli-win-x64.zip
Windows x86   -> LockBox-Cli-win-x86.zip
Windows ARM64 -> LockBox-Cli-win-arm64.zip
Linux x86_64  -> LockBox-Cli-linux-x64.zip
Linux aarch64 -> LockBox-Cli-linux-arm64.zip
Linux armv7l  -> LockBox-Cli-linux-arm.zip

Φάκελοι, διαδρομές και χώρος

Προσαρμόστε τις διαδρομές. Ο φάκελος πηγής δεν πρέπει να είναι κενός και το κοντέινερ πρέπει να βρίσκεται εκτός του. Το ίδιο όνομα εξόδου αντικαθιστά το προηγούμενο κοντέινερ και τα μέρη του. Προβλέψτε προσωρινό χώρο δίπλα στο κοντέινερ και αντίγραφο πηγής για προγραμματισμένες εργασίες. Οι μονάδες βασίζονται στο 1024· η συμπλήρωση προσθέτει byte.

C:\Tools\LockBox\LockBox.Cli.exe     /opt/lockbox/LockBox.Cli
C:\LockBox\secrets\master.txt       /srv/lockbox/secrets/master.txt
C:\LockBox\secrets\layer1.txt       /srv/lockbox/secrets/layer1.txt
C:\LockBox\backup.ps1               /srv/lockbox/backup.sh
D:\Data\report.csv                 /srv/data/report.csv
E:\Backups\20260910-020000\data.lbx  /backup/20260910-020000/data.lbx
D:\Restore\Data\report.csv         /restore/data/report.csv

& 'C:\Tools\LockBox\LockBox.Cli.exe' create --source 'D:\Data' --output 'E:\Backups\data.lbx' --master-file 'C:\LockBox\secrets\master.txt' --layer-file 'AES-128-GCM=C:\LockBox\secrets\layer1.txt'

/opt/lockbox/LockBox.Cli create --source /srv/data --output /backup/data.lbx --master-file /srv/lockbox/secrets/master.txt --layer-file AES-128-GCM=/srv/lockbox/secrets/layer1.txt

Προετοιμασία αρχείων μυστικών

Δημιουργήστε τα μυστικά μία φορά, φυλάξτε προστατευμένο αντίγραφο και περιορίστε την πρόσβαση στα αρχεία. Τα παραδείγματα αρνούνται αντικατάσταση υπαρχόντων κλειδιών. Τα αρχεία UTF-8 διατηρούν κενά, αλλά αφαιρούν τελικές αλλαγές γραμμής. Κρατήστε τα αρχικά κλειδιά για παλιά αντίγραφα.

$ErrorActionPreference = 'Stop'
$cli = 'C:\Tools\LockBox\LockBox.Cli.exe'
$secretDir = 'C:\LockBox\secrets'
New-Item -ItemType Directory -Force -Path $secretDir | Out-Null
$files = @('master.txt', 'layer1.txt')
foreach ($name in $files) {
    if (Test-Path -LiteralPath (Join-Path $secretDir $name)) {
        throw "Secret already exists: $name"
    }
}
foreach ($name in $files) {
    $key = & $cli keygen --count 1
    if ($LASTEXITCODE -ne 0) { throw 'Key generation failed' }
    [IO.File]::WriteAllText((Join-Path $secretDir $name), [string]$key, [Text.UTF8Encoding]::new($false))
}

set -eu
umask 077
mkdir -p /srv/lockbox/secrets
test ! -e /srv/lockbox/secrets/master.txt
test ! -e /srv/lockbox/secrets/layer1.txt
set -C
/opt/lockbox/LockBox.Cli keygen --count 1 > /srv/lockbox/secrets/master.txt
/opt/lockbox/LockBox.Cli keygen --count 1 > /srv/lockbox/secrets/layer1.txt

Ενεργοποίηση και κατάσταση άδειας

Το κλειδί άδειας συνδέεται με το αναγνωριστικό συσκευής που εμφανίζεται από την ίδια έκδοση CLI. Εάν μια άδεια αντιγραφεί σε άλλο υπολογιστή, το LockBox την απορρίπτει και επιστρέφει στη δωρεάν έκδοση.

Το Windows ελέγχει τις υπάρχουσες τοποθεσίες δεδομένων εφαρμογής LockBox. Το Linux αποθηκεύει την ενεργοποίηση στο $XDG_CONFIG_HOME/lockbox/.lockbox.license, στη συνέχεια ~/.config/lockbox/.lockbox.license, με ~/.lockbox/.lockbox.license ως εναλλακτική λύση.

.\LockBox.Cli.exe device-id

.\LockBox.Cli.exe license

Ενεργοποίηση από αρχείο άδειας

.\LockBox.Cli.exe activate --license-file "C:\Licenses\lockbox-license.txt"

Ενεργοποίηση από μεταβλητή περιβάλλοντος

$env:LBX_LICENSE = "LBX-LIC-..."
.\LockBox.Cli.exe activate --license-env LBX_LICENSE

Άμεση ενεργοποίηση

Η άμεση ενεργοποίηση λειτουργεί, αλλά μπορεί να διαρρεύσει μέσω ιστορικού shell ή logs διαδικασιών.

.\LockBox.Cli.exe activate --license "LBX-LIC-..."

Ενεργοποίηση στο Linux

export LBX_LICENSE="LBX-LIC-..."
./LockBox.Cli activate --license-env LBX_LICENSE
./LockBox.Cli license

Διαχείριση μυστικών

Προτιμήστε μεταβλητές περιβάλλοντος ή αρχεία. Τα ενσωματωμένα μυστικά είναι χρήσιμα μόνο για δοκιμές. Ο κύριος κωδικός και τα κλειδιά επιπέδων πρέπει να διατηρούνται: χωρίς αυτά το κοντέινερ δεν μπορεί να ανοιχτεί.

Μυστικά βασισμένα σε αρχεία

Set-Content -Path ".\master.txt" -Value "master-password" -Encoding UTF8
Set-Content -Path ".\layer1.txt" -Value "layer-key-1" -Encoding UTF8

.\LockBox.Cli.exe create `
  -s "D:\Data" `
  -o "E:\Backups\data.lbx" `
  --master-file ".\master.txt" `
  --layer-file AES-128-GCM=.\layer1.txt

Αλγόριθμοι και δημιουργία κλειδιών

Χρησιμοποιήστε algorithms για να δείτε όλα τα υποστηριζόμενα προφίλ και τις ελάχιστες εκδόσεις. Χρησιμοποιήστε keygen για τα κλειδιά επιπέδων.

.\LockBox.Cli.exe algorithms
.\LockBox.Cli.exe keygen
.\LockBox.Cli.exe keygen --count 9
.\LockBox.Cli.exe generate-keys -n 20

Υποστηριζόμενες ψευδωνυμίες εντολών:

algorithms
list-algorithms
profiles

keygen
generate-key
generate-keys

Δημιουργία κοντέινερ

create πακετάρει έναν φάκελο προέλευσης, εφαρμόζει προαιρετική συμπίεση και συμπλήρωση, κρυπτογραφεί το περιεχόμενο μέσω ενός ή περισσότερων επιπέδων και γράφει ένα .lbx κοντέινερ.

Απαιτούμενες επιλογές

• --source ή -s: φάκελος προέλευσης.
• --output ή -o: διαδρομή εξόδου .lbx.
• --master, --master-env ή --master-file.
• Τουλάχιστον ένα επίπεδο: --layer, --layer-env ή --layer-file.

Ελάχιστο AES κοντέινερ

.\LockBox.Cli.exe create `
  -s "D:\Data" `
  -o "E:\Backups\data.lbx" `
  --master-env LBX_MASTER `
  --layer-env AES-128-GCM=LBX_L1

Συμπιεσμένο κοντέινερ

.\LockBox.Cli.exe create `
  --source "D:\Exports" `
  --output "E:\Backups\exports.lbx" `
  --master-env LBX_MASTER `
  --layer-env AES-256-GCM=LBX_L1 `
  --compress

Κρυπτογραφική συμπλήρωση

.\LockBox.Cli.exe create `
  -s "D:\Contracts" `
  -o "E:\Backups\contracts.lbx" `
  --master-env LBX_MASTER `
  --layer-env AES-256-GCM=LBX_L1 `
  --padding 2GB

Διαμοιρασμός κοντέινερ σε τμήματα

.\LockBox.Cli.exe create `
  -s "D:\Media" `
  -o "E:\Backups\media.lbx" `
  --master-env LBX_MASTER `
  --layer-env AES-256-GCM=LBX_L1 `
  --split 700MB

Το πρώτο τμήμα διατηρεί .lbx. Τα επιπλέον τμήματα χρησιμοποιούν .lbx1, .lbx2 και ούτω καθεξής. Κρατήστε όλα τα τμήματα στον ίδιο φάκελο.

Παράδειγμα Nine-layer Max

$env:LBX_MASTER = "use-a-long-master-password"
$env:LBX_L1 = "layer-1-key"
$env:LBX_L2 = "layer-2-key"
$env:LBX_L3 = "layer-3-key"
$env:LBX_L4 = "layer-4-key"
$env:LBX_L5 = "layer-5-key"
$env:LBX_L6 = "layer-6-key"
$env:LBX_L7 = "layer-7-key"
$env:LBX_L8 = "layer-8-key"
$env:LBX_L9 = "layer-9-key"

.\LockBox.Cli.exe create `
  --source "D:\Data" `
  --output "E:\Backups\data-max.lbx" `
  --master-env LBX_MASTER `
  --compress `
  --padding 2GB `
  --split 700MB `
  --layer-env AES-256-GCM=LBX_L1 `
  --layer-env CHACHA20-POLY1305=LBX_L2 `
  --layer-env AES-256-CCM=LBX_L3 `
  --layer-env SERPENT-256-CTR-HMACSHA512=LBX_L4 `
  --layer-env TWOFISH-256-CTR-HMACSHA512=LBX_L5 `
  --layer-env CAMELLIA-256-CTR-HMACSHA512=LBX_L6 `
  --layer-env ARIA-256-CTR-HMACSHA512=LBX_L7 `
  --layer-env AES-256-CBC-HMACSHA512=LBX_L8 `
  --layer-env AES-192-OFB-HMACSHA384=LBX_L9

Εναλλακτική σύνταξη αλγορίθμου/κλειδιού

.\LockBox.Cli.exe create `
  -s "D:\Data" `
  -o "E:\Backups\data.lbx" `
  --master-env LBX_MASTER `
  --algorithm AES-128-GCM --key-env LBX_L1 `
  --algorithm AES-128-CTR-HMACSHA256 --key-env LBX_L2

Διαγραφή προέλευσης μετά από επιτυχή χειροκίνητη δημιουργία

.\LockBox.Cli.exe create `
  -s "D:\TempToEncrypt" `
  -o "E:\Backups\temp.lbx" `
  --master-env LBX_MASTER `
  --layer-env AES-256-GCM=LBX_L1 `
  --delete-source

Ο --delete-source διαγράφει τον φάκελο προέλευσης μόνο αφού δημιουργηθεί το κοντέινερ με επιτυχία. Ο προγραμματιστής έχει διαφορετική επιλογή: --delete-source-contents.

Κωδικός καταστροφής κοντέινερ

Η έκδοση Max μπορεί να προσθέσει έναν ξεχωριστό κωδικό καταστροφής σε ένα κοντέινερ. Εάν αυτός ο κωδικός εισαχθεί αργότερα ως κύριος κωδικός, το LockBox αντικαθιστά αμέσως το κοντέινερ χωρίς επιβεβαίωση. Αυτό προορίζεται για σενάρια πίεσης-αναγκασμού. Κρατήστε τον ξεχωριστά από τον πραγματικό κύριο κωδικό.

Η εντολή ελέγχει τον ελεύθερο χώρο στο δίσκο, κρυπτογραφεί τα αρχικά δεδομένα του κοντέινερ με ένα φρέσκο τυχαίο μυστικό και AES-256-GCM σε ένα προσωρινό αρχείο, κανονικοποιεί το αποτέλεσμα στο ακριβές αρχικό μέγεθος, αντικαθιστά το αρχικό αρχείο και ξεχνάει το τυχαίο μυστικό. Για διασπασμένα κοντέινερ, κάθε μέρος .lbx, .lbx1, .lbx2 στον ίδιο φάκελο αντικαθίσταται ενώ διατηρούνται τα αρχικά μεγέθη των μερών.

Δημιουργία με κωδικό καταστροφής

$env:LBX_MASTER = "real-master-password"
$env:LBX_L1 = "layer-key-1"
$env:LBX_DESTROY = "pressure-password"

.\LockBox.Cli.exe create `
  --source "D:\Data" `
  --output "E:\Backups\data.lbx" `
  --master-env LBX_MASTER `
  --layer-env AES-256-GCM=LBX_L1 `
  --destruction-password-env LBX_DESTROY

Προκαλέστε καταστροφή χωρίς κλειδιά επιπέδου

.\LockBox.Cli.exe open `
  --container "E:\Backups\data.lbx" `
  --output "D:\Restore" `
  --master-env LBX_DESTROY

Προκάλεση στο Linux

export LBX_DESTROY="pressure-password"
./LockBox.Cli open \
  --container "/backup/data.lbx" \
  --output "/restore" \
  --master-env LBX_DESTROY

Μετά από επιτυχή καταστροφή, το κοντέινερ δεν είναι πλέον έγκυρο αρχείο LockBox. Το CLI επιστρέφει κωδικό εξόδου 0 επειδή η ζητούμενη ενέργεια καταστροφής ολοκληρώθηκε επιτυχώς.

Άνοιγμα κοντέινερ

open εξάγει ένα κοντέινερ στο φάκελο εξόδου. Για κανονική εξαγωγή, τα κλειδιά επιπέδου πρέπει να περαστούν με την ίδια σειρά που χρησιμοποιήθηκε κατά τη δημιουργία. Για ροή εργασίας με κωδικό καταστροφής, απαιτείται μόνο η διαδρομή του κοντέινερ, η διαδρομή εξόδου και ο κωδικός καταστροφής ως κύριος κωδικός.

Άνοιγμα κοντέινερ ενός επιπέδου

.\LockBox.Cli.exe open `
  --container "E:\Backups\data.lbx" `
  --output "D:\Restore" `
  --master-env LBX_MASTER `
  --key-env LBX_L1

Άνοιγμα διασπασμένου κοντέινερ

.\LockBox.Cli.exe open `
  -c "E:\Backups\data.lbx" `
  -o "D:\Restore" `
  --master-env LBX_MASTER `
  --key-env LBX_L1

Άνοιγμα πολυεπίπεδου κοντέινερ

.\LockBox.Cli.exe open `
  -c "E:\Backups\data-max.lbx" `
  -o "D:\Restore" `
  --master-env LBX_MASTER `
  --key-env LBX_L1 `
  --key-env LBX_L2 `
  --key-env LBX_L3 `
  --key-env LBX_L4 `
  --key-env LBX_L5 `
  --key-env LBX_L6 `
  --key-env LBX_L7 `
  --key-env LBX_L8 `
  --key-env LBX_L9

Ψευδώνυμα

open
decrypt
extract

Έλεγχος αντιγράφου με επαναφορά

Δημιουργήστε μικρό δοκιμαστικό report.csv. Εξαγάγετε σε νέο φάκελο· το όνομα του φακέλου πηγής διατηρείται μέσα του. Κρατήστε όλα τα μέρη μαζί και συγκρίνετε με αμετάβλητη πηγή. Η εξαγωγή απαιτεί εγγράψιμο προσωρινό χώρο δίπλα στο κοντέινερ. Προστατέψτε και τα επαναφερμένα μη κρυπτογραφημένα αρχεία.

$ErrorActionPreference = 'Stop'
$cli = 'C:\Tools\LockBox\LockBox.Cli.exe'
$container = 'E:\Backups\data.lbx'
$restore = Join-Path 'D:\RestoreChecks' ([guid]::NewGuid().ToString('N'))
& $cli open --container $container --output $restore --master-file 'C:\LockBox\secrets\master.txt' --key-file 'C:\LockBox\secrets\layer1.txt'
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
$original = (Get-FileHash -LiteralPath 'D:\Data\report.csv' -Algorithm SHA256).Hash
$restored = (Get-FileHash -LiteralPath (Join-Path $restore 'Data\report.csv') -Algorithm SHA256).Hash
if ($original -ne $restored) { throw 'SHA256 mismatch' }
Write-Output $restore

set -eu
umask 077
mkdir -p /restore
restore=$(mktemp -d /restore/check-XXXXXX)
/opt/lockbox/LockBox.Cli open --container /backup/data.lbx --output "$restore" --master-file /srv/lockbox/secrets/master.txt --key-file /srv/lockbox/secrets/layer1.txt
cmp /srv/data/report.csv "$restore/data/report.csv"
sha256sum /srv/data/report.csv "$restore/data/report.csv"

Προγραμματιστής

Οι εντολές του προγραμματιστή είναι διαθέσιμες στην έκδοση Max. Αποθηκεύουν πλήρη μεταδεδομένα εργασίας σε ένα κρυπτογραφημένο αρχείο .lbxjobs, συμπεριλαμβανομένου του διαδρομής προέλευσης, διαδρομής εξόδου, κωδικών πρόσβασης, κωδικού καταστροφής, κλειδιών επιπέδου, συμπίεσης, συμπλήρωσης, διαχωρισμού και ρύθμισης διαγραφής περιεχομένων πηγής.

Οι προγραμματισμένες εργασίες εκτελούνται μόνο ενώ LockBox.Cli.exe schedule run είναι σε λειτουργία. Χρησιμοποιήστε το Windows Task Scheduler, το Linux systemd, το cron, μια υπηρεσία wrapper ή μια μακροχρόνια συνεδρία κονσόλας αν χρειάζεστε ο εργαζόμενος να ξεκινά αυτόματα μετά την επανεκκίνηση.

Τιμές συχνότητας

once
30m
hourly
2h
3h
6h
9h
12h
18h
daily
2d
3d
5d
weekly
2w
monthly
2mo
3mo
6mo
9mo
yearly

Προσθήκη ημερήσιας κρυπτογραφημένης εργασίας αντιγράφων ασφαλείας

$env:LBX_JOBS_PASSWORD = "jobs-file-password"
$env:LBX_MASTER = "master-password"
$env:LBX_L1 = "layer-key-1"
$env:LBX_DESTROY = "pressure-password"

.\LockBox.Cli.exe schedule add `
  --tasks "E:\Backups\jobs.lbxjobs" `
  --password-env LBX_JOBS_PASSWORD `
  --name "Nightly data backup" `
  --frequency daily `
  --start ((Get-Date).AddDays(1).ToString("o")) `
  --source "D:\Data" `
  --output "E:\Backups\nightly-data.lbx" `
  --master-env LBX_MASTER `
  --layer-env AES-256-GCM=LBX_L1 `
  --destruction-password-env LBX_DESTROY `
  --compress

Προσθήκη εργασίας που διαγράφει τα περιεχόμενα του φακέλου προέλευσης μετά την επιτυχία

.\LockBox.Cli.exe schedule add `
  --tasks "E:\Backups\jobs.lbxjobs" `
  --password-env LBX_JOBS_PASSWORD `
  --name "Encrypt outgoing folder" `
  --frequency 30m `
  --start ((Get-Date).AddDays(1).ToString("o")) `
  --source "D:\Outgoing" `
  --output "E:\Backups\outgoing.lbx" `
  --master-env LBX_MASTER `
  --layer-env AES-256-GCM=LBX_L1 `
  --delete-source-contents

Προσθήκη μηνιαίου αρχείου με συμπλήρωση και διαχωρισμένα μέρη

.\LockBox.Cli.exe schedule add `
  --tasks "E:\Backups\jobs.lbxjobs" `
  --password-env LBX_JOBS_PASSWORD `
  --name "Monthly legal archive" `
  --frequency monthly `
  --start ((Get-Date).AddDays(1).ToString("o")) `
  --source "D:\Legal" `
  --output "E:\Archives\legal-monthly.lbx" `
  --master-env LBX_MASTER `
  --layer-env AES-256-GCM=LBX_L1 `
  --compress `
  --padding 4GB `
  --split 2GB

Λίστα αποθηκευμένων εργασιών

.\LockBox.Cli.exe schedule list `
  --tasks "E:\Backups\jobs.lbxjobs" `
  --password-env LBX_JOBS_PASSWORD

Εκτέλεση του εργαζομένου προγραμματιστή

.\LockBox.Cli.exe schedule run `
  --tasks "E:\Backups\jobs.lbxjobs" `
  --password-env LBX_JOBS_PASSWORD `
  --state "E:\Backups\jobs.status.json" `
  --poll-seconds 30

Εκτέλεση προγραμματισμένων εργασιών μία φορά και έξοδος

.\LockBox.Cli.exe schedule run-once `
  --tasks "E:\Backups\jobs.lbxjobs" `
  --password-env LBX_JOBS_PASSWORD `
  --state "E:\Backups\jobs.status.json"

Προβολή της τελευταίας κατάστασης εκτέλεσης

.\LockBox.Cli.exe schedule status --state "E:\Backups\jobs.status.json"

Οι δείκτες κατάστασης είναι [OK], [RUNNING] και [FAILED]. Μια αποτυχημένη εργασία περιλαμβάνει το λόγο και ενημερώνει τον χρήστη να επικοινωνήσει με την υποστήριξη αν το πρόβλημα επαναλαμβάνεται.

Σενάρια JSON

Χρησιμοποιήστε --script όταν μια ροή εργασίας έχει διάφορα βήματα. Ο εκτελεστής σεναρίων υποστηρίζει create, open, keygen, algorithms, device-id, license και activate.

Δημιουργία και άνοιγμα σε ένα σενάριο

{
  "stopOnError": true,
  "commands": [
    {
      "command": "create",
      "source": "D:\\Data",
      "output": "E:\\Backups\\data.lbx",
      "masterPasswordEnv": "LBX_MASTER",
      "destructionPasswordEnv": "LBX_DESTROY",
      "compression": true,
      "padding": "512MB",
      "split": "700MB",
      "layers": [
        { "algorithm": "AES-256-GCM", "keyEnv": "LBX_L1" },
        { "algorithm": "CHACHA20-POLY1305", "keyEnv": "LBX_L2" }
      ]
    },
    {
      "command": "open",
      "container": "E:\\Backups\\data.lbx",
      "output": "D:\\Restore",
      "masterPasswordEnv": "LBX_MASTER",
      "keyEnvs": [ "LBX_L1", "LBX_L2" ]
    }
  ]
}

.\LockBox.Cli.exe --script ".\backup.lockbox.json"

Συνέχιση μετά από αποτυχημένο βήμα

{
  "stopOnError": false,
  "commands": [
    { "command": "license" },
    { "command": "algorithms" },
    {
      "command": "create",
      "source": "D:\\BuildOutput",
      "output": "E:\\Artifacts\\build.lbx",
      "masterPasswordEnv": "LBX_MASTER",
      "layers": [
        { "algorithm": "AES-128-GCM", "keyEnv": "LBX_L1" }
      ]
    }
  ]
}

Ενεργοποίηση από σενάριο

{
  "commands": [
    {
      "command": "activate",
      "licenseKeyFile": "C:\\Licenses\\lockbox-license.txt"
    },
    { "command": "license" }
  ]
}

Πεδία JSON και κανόνες εκτέλεσης

Ο πίνακας αντιστοιχίζει πεδία create και πίνακες κλειδιών open στις επιλογές CLI. Οι σχετικές διαδρομές ξεκινούν από τον κατάλογο εργασίας της διεργασίας· μεταβλητές και ημερομηνίες δεν αντικαθίστανται. Χρησιμοποιήστε μία πηγή μυστικού ανά πεδίο. Το open διαβάζει keys, έπειτα keyEnvs και keyFiles. Προτιμήστε stopOnError: true· με false μεταγενέστερη επιτυχία μπορεί να κρύψει σφάλμα. Τα σενάρια JSON δεν υποστηρίζουν εντολές χρονοπρογραμματιστή.

{
  "stopOnError": true,
  "commands": [
    {
      "command": "create",
      "source": "/srv/data",
      "output": "/backup/data.lbx",
      "masterPasswordFile": "/srv/lockbox/secrets/master.txt",
      "layers": [
        { "algorithm": "AES-128-GCM", "keyFile": "/srv/lockbox/secrets/layer1.txt" }
      ]
    },
    {
      "command": "open",
      "container": "/backup/data.lbx",
      "output": "/restore/check",
      "masterPasswordFile": "/srv/lockbox/secrets/master.txt",
      "keyFiles": ["/srv/lockbox/secrets/layer1.txt"]
    }
  ]
}

/opt/lockbox/LockBox.Cli --quiet script /srv/lockbox/backup.lockbox.json

Συνταγές αυτοματοποίησης

Αντίγραφο ασφαλείας κρυπτογραφημένης βάσης δεδομένων

$stamp = Get-Date -Format "yyyyMMdd-HHmmss"
$dump = "D:\DbDumps\$stamp"
New-Item -ItemType Directory -Path $dump | Out-Null

Copy-Item "D:\DatabaseExports\*" $dump -Recurse

.\LockBox.Cli.exe create `
  -s $dump `
  -o "E:\Backups\db-$stamp.lbx" `
  --master-env LBX_MASTER `
  --layer-env AES-256-GCM=LBX_L1 `
  --compress `
  --padding 512MB

Προστασία αντικειμένων CI

.\LockBox.Cli.exe create `
  --source "$env:BUILD_ARTIFACTSTAGINGDIRECTORY" `
  --output "$env:AGENT_TEMPDIRECTORY\protected-artifacts.lbx" `
  --master-env LBX_MASTER `
  --layer-env AES-128-GCM=LBX_L1

Ασφαλής μεταφορά σε συνεργάτη

.\LockBox.Cli.exe create `
  -s "D:\PartnerPackage" `
  -o "E:\Transfer\partner-package.lbx" `
  --master-env LBX_MASTER `
  --layer-env AES-256-GCM=LBX_L1 `
  --layer-env CHACHA20-POLY1305=LBX_L2 `
  --compress `
  --split 1GB

Αρχειοθέτηση μακροχρόνιας διάρκειας

.\LockBox.Cli.exe create `
  -s "D:\Records\2026" `
  -o "E:\ColdStorage\records-2026.lbx" `
  --master-file "C:\Secrets\records-master.txt" `
  --layer-file AES-256-GCM=C:\Secrets\records-layer1.txt `
  --layer-file SERPENT-256-CTR-HMACSHA512=C:\Secrets\records-layer2.txt `
  --compress `
  --padding 8GB `
  --split 4GB

Παράδειγμα αρχείου παρτίδας

@echo off
set LBX_MASTER=master-password
set LBX_L1=layer-key-1

LockBox.Cli.exe create ^
  --source "D:\Data" ^
  --output "E:\Backups\data.lbx" ^
  --master-env LBX_MASTER ^
  --layer-env AES-128-GCM=LBX_L1

if errorlevel 1 exit /b %errorlevel%
echo OK

Windows: αντίγραφα πολλών φακέλων

Αποθηκεύστε το σενάριο στην υποδεικνυόμενη διαδρομή. Δημιουργεί μοναδικό κοντέινερ και αρχείο καταγραφής ανά πηγή, σταματά σε σφάλμα και διατηρεί τον κωδικό εξόδου CLI. Το AES-128-GCM λειτουργεί στο Free· συμπίεση και διαχωρισμός απαιτούν Pro ή Max.

C:\LockBox\backup.ps1

param(
    [string[]]$Source = @('D:\Data'),
    [string]$Destination = 'E:\Backups'
)
$ErrorActionPreference = 'Stop'
$cli = 'C:\Tools\LockBox\LockBox.Cli.exe'
$secretDir = 'C:\LockBox\secrets'
try {
    foreach ($folder in $Source) {
        $sourcePath = (Resolve-Path -LiteralPath $folder).Path
        $stamp = (Get-Date).ToUniversalTime().ToString('yyyyMMdd-HHmmss-fff')
        $runId = [guid]::NewGuid().ToString('N')
        $runDir = Join-Path $Destination "$stamp-$runId"
        New-Item -ItemType Directory -Path $runDir | Out-Null
        $container = Join-Path $runDir 'data.lbx'
        $log = Join-Path $runDir 'create.log'
        $cliArgs = @(
            '--quiet', 'create', '--source', $sourcePath, '--output', $container,
            '--master-file', (Join-Path $secretDir 'master.txt'),
            '--layer-file', ('AES-128-GCM=' + (Join-Path $secretDir 'layer1.txt'))
        )
        $ErrorActionPreference = 'Continue'
        & $cli @cliArgs > $log 2>&1
        $result = $LASTEXITCODE
        $ErrorActionPreference = 'Stop'
        if ($result -ne 0) {
            Get-Content -LiteralPath $log
            exit $result
        }
        if (-not (Test-Path -LiteralPath $container -PathType Leaf)) {
            throw "Container missing: $container"
        }
        Write-Output $container
    }
    exit 0
} catch {
    Write-Error $_ -ErrorAction Continue
    exit 1
}

& 'C:\LockBox\backup.ps1' -Source 'D:\Data', 'D:\Reports' -Destination 'E:\Backups'
# 0 = success; 1 = runtime error; 2 = usage error; 3 = edition restriction
$LASTEXITCODE

Linux: αντίγραφα χωρίς επίβλεψη

Αποθηκεύστε το σενάριο Bash με αλλαγές γραμμής LF. Προετοιμάστε CLI και μυστικά στις αναφερόμενες διαδρομές και δώστε τους φακέλους πηγής ως ορίσματα. Κάθε εκτέλεση αποκτά δικό της κατάλογο. Τα σφάλματα αφήνουν καταγραφή και επιστρέφουν μη μηδενικό κωδικό· οι πηγές διατηρούνται.

/srv/lockbox/backup.sh

#!/bin/bash
set -eu
umask 077
cli=/opt/lockbox/LockBox.Cli
secret_dir=/srv/lockbox/secrets
backup_root=/backup
mkdir -p "$backup_root"
if [ "$#" -eq 0 ]; then
    set -- /srv/data
fi
for source in "$@"; do
    run_dir=$(mktemp -d "$backup_root/$(date -u +%Y%m%d-%H%M%S)-XXXXXX")
    container="$run_dir/data.lbx"
    log="$run_dir/create.log"
    "$cli" --quiet create \
        --source "$source" \
        --output "$container" \
        --master-file "$secret_dir/master.txt" \
        --layer-file "AES-128-GCM=$secret_dir/layer1.txt" > "$log" 2>&1 || {
        result=$?
        cat "$log" >&2
        exit "$result"
    }
    test -s "$container"
    printf '%s\n' "$container"
done

/bin/bash /srv/lockbox/backup.sh /srv/data /srv/reports

Προγραμματισμός από το λειτουργικό

Οι εργασίες εκκινούν τα προηγούμενα σενάρια· αυτή η χρήση του create δεν απαιτεί Max. Η εγγραφή Windows εκτελείται μόνο με συνδεδεμένο χρήστη· ρυθμίστε εκτέλεση χωρίς σύνδεση στον Χρονοπρογραμματιστή αν χρειάζεται. Προσθέστε cron στο crontab του λογαριασμού αντιγράφων αφού ελέγξετε το flock. Και τα δύο παραδείγματα εκτελούνται στις 02:00 τοπική ώρα και αποτρέπουν επικαλυπτόμενες προγραμματισμένες εκτελέσεις. Ελέγξτε δικαιώματα και δοκιμάστε χειροκίνητα.

Windows

$action = New-ScheduledTaskAction -Execute 'powershell.exe' -Argument '-NoProfile -NonInteractive -File "C:\LockBox\backup.ps1"' -WorkingDirectory 'C:\LockBox'
$trigger = New-ScheduledTaskTrigger -Daily -At '02:00'
$settings = New-ScheduledTaskSettingsSet -StartWhenAvailable -MultipleInstances IgnoreNew -ExecutionTimeLimit ([TimeSpan]::Zero)
$principal = New-ScheduledTaskPrincipal -UserId ([Security.Principal.WindowsIdentity]::GetCurrent().Name) -LogonType Interactive
Register-ScheduledTask -TaskName 'LockBox backup' -Action $action -Trigger $trigger -Settings $settings -Principal $principal
Start-ScheduledTask -TaskName 'LockBox backup'
Get-ScheduledTaskInfo -TaskName 'LockBox backup'

New-ScheduledTaskSettingsSet · New-ScheduledTaskPrincipal

Linux: cron

crontab -e

0 2 * * * /usr/bin/flock -n /srv/lockbox/backup.lock /bin/bash /srv/lockbox/backup.sh >> /srv/lockbox/cron.log 2>&1

crontab(5)

Max: λειτουργία χρονοπρογραμματιστή

Δημιουργήστε λογαριασμό υπηρεσίας lockbox με τα απαιτούμενα δικαιώματα, ενεργοποιήστε Max γι’ αυτόν και ετοιμάστε ξεχωριστό αρχείο κωδικού UTF-8 jobs.txt. Το add προσθέτει, δεν ενημερώνει: χρησιμοποιήστε το μία φορά ανά εργασία. Εκτελέστε μία διεργασία ανά αρχείο εργασιών και επανεκκινήστε μετά από αλλαγές. Το JSON κατάστασης δεν επαναφέρει ιστορικό: ληξιπρόθεσμες επαναλήψεις παραλείπονται, ενώ μια ληξιπρόθεσμη once μπορεί να ξανατρέξει. Για περιοδικές εκκινήσεις του συστήματος χρησιμοποιήστε create αντί επαναλαμβανόμενου run-once. Ο χρονοπρογραμματιστής επαναχρησιμοποιεί το όνομα εξόδου.

/opt/lockbox/LockBox.Cli schedule add \
  --tasks /srv/lockbox/jobs.lbxjobs \
  --password-file /srv/lockbox/secrets/jobs.txt \
  --name nightly-data --frequency daily \
  --start "$(date -d 'tomorrow 02:00' --iso-8601=seconds)" \
  --source /srv/data --output /backup/nightly-data.lbx \
  --master-file /srv/lockbox/secrets/master.txt \
  --layer-file AES-128-GCM=/srv/lockbox/secrets/layer1.txt

/opt/lockbox/LockBox.Cli schedule list --tasks /srv/lockbox/jobs.lbxjobs --password-file /srv/lockbox/secrets/jobs.txt

/etc/systemd/system/lockbox-scheduler.service

[Unit]
Description=LockBox scheduler
After=local-fs.target
RequiresMountsFor=/srv/data /srv/lockbox /backup

[Service]
Type=simple
User=lockbox
WorkingDirectory=/srv/lockbox
UMask=0077
ExecStart=/opt/lockbox/LockBox.Cli schedule run --tasks /srv/lockbox/jobs.lbxjobs --password-file /srv/lockbox/secrets/jobs.txt --state /srv/lockbox/jobs.status.json --poll-seconds 30
Restart=on-failure
RestartSec=10
KillSignal=SIGINT
TimeoutStopSec=300

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now lockbox-scheduler.service
systemctl status lockbox-scheduler.service
journalctl -u lockbox-scheduler.service -n 50 --no-pager
/opt/lockbox/LockBox.Cli schedule status --state /srv/lockbox/jobs.status.json

systemd.service

Αναφορά εντολών

Δημιουργία επιλογών

Επιλογές ανοίγματος

Επιλογές χρονοπρογραμματιστή

Χρησιμοποιήστε --language ή --lang για επιλογή γλώσσας κονσόλας και --quiet για απόκρυψη της συνήθους προόδου· τα σφάλματα εξακολουθούν να αποστέλλονται στην τυπική ροή σφαλμάτων. Το Ctrl+C ζητά ακύρωση και επιστρέφει κωδικό 1. Ο κωδικός 2 σημαίνει μη έγκυρη σύνταξη εντολής· ο κωδικός 3 σημαίνει ότι μια δυνατότητα δημιουργίας δεν είναι διαθέσιμη στην τρέχουσα έκδοση. Ο κωδικός 0 καλύπτει και τη σκόπιμη ενεργοποίηση κωδικού καταστροφής, επομένως από μόνος του δεν αποδεικνύει ότι εξήχθησαν αρχεία. Επαληθεύστε την αναμενόμενη έξοδο πριν από τα επόμενα βήματα αυτοματοποίησης.

Κωδικοί εξόδου και παρακολούθηση

Το schedule run-once μπορεί να επιστρέψει μηδέν παρά αποτυχίες εργασιών· το schedule status και χωρίς κατάσταση. Ελέγξτε savedAt, lastSuccessAt και lastError· το [OK] μπορεί να σημαίνει μόνο Ready. Ο έλεγχος αναμένει ημερήσια αντίγραφα, ερωτήματα ανά 30 δευτερόλεπτα και επιτυχία εντός 26 ωρών. Προσαρμόστε τα όρια. Οι καταστάσεις JSON είναι αριθμοί· το --quiet κρύβει τη συνήθη έξοδο επιτυχημένων create/open.

$ErrorActionPreference = 'Stop'
try {
    $status = Get-Content -LiteralPath 'E:\Backups\jobs.status.json' -Raw | ConvertFrom-Json
    if (@($status.tasks).Count -eq 0) { throw 'No tasks in status file' }
    if ([DateTimeOffset]$status.savedAt -lt [DateTimeOffset]::Now.AddMinutes(-2)) {
        throw 'Worker status is stale'
    }
    foreach ($task in $status.tasks) {
        if ($task.state -eq 3 -or $task.lastError) { throw "Task failed: $($task.name)" }
        if (-not $task.lastSuccessAt -or [DateTimeOffset]$task.lastSuccessAt -lt [DateTimeOffset]::Now.AddHours(-26)) {
            throw "No recent successful backup: $($task.name)"
        }
    }
    exit 0
} catch {
    Write-Error $_ -ErrorAction Continue
    exit 1
}

0 -> Ready
1 -> Running
2 -> Completed
3 -> Failed

Αντιμετώπιση προβλημάτων