Tutorial do Debian 13 / Criar backups com tar e comprovar a restauração de arquivos e serviços

Criar um arquivo tar no Debian 13 não prova que seu conteúdo pode ser recuperado. Este exemplo cria um arquivo não compactado. Você precisa restaurá-lo em um caminho vazio para verificar o conteúdo, IDs numéricos de usuário e grupo (UID/GID), permissões, listas de controle de acesso (ACLs), atributos estendidos e links, e verificar se os serviços executados a partir da cópia restaurada respondem normalmente. Este tutorial faz backup e restaura um pequeno serviço HTTP e dados, preservando o original, e rejeita uma cópia corrompida antes da extração.

Escolher o escopo do backup e um ponto consistente no tempo

tar é uma ferramenta que arquiva múltiplos arquivos e seus metadados. Arquivar arquivos é diferente de preservar consistentemente o estado de um serviço em um ponto específico no tempo. Copiar um arquivo de banco de dados que está sendo escrito não garante consistência de transações, então você deve escolher uma ferramenta de backup própria do aplicativo, um snapshot consistente ou um método de interrupção das gravações.

Este exercício envolve um servidor HTTP em Python usando apenas a biblioteca padrão e arquivos de dados somente leitura. Após parar o serviço, o código e os dados são arquivados, e a unidade systemd também é armazenada separadamente. Não é um exemplo de verificação de recuperação de banco de dados, recuperação completa do SO, ou replicação de armazenamento externo.

Item Critérios de preservação e verificação
Conteúdo do arquivo e código Comparação de bytes entre as cópias original e restaurada e comparação de respostas HTTP
UID/GID e modo Manter ID numérico e permissões 640
ACL Manter itens de leitura de usuário específicos e máscara
Atributos estendidos Manter user.lf-course=backup30
Links Manter relacionamentos de link físico interno e alvos de link simbólico relativo do backup
Configuração de serviço Unidade systemd, caminhos do programa e dos dados, e inicialização a partir da cópia restaurada

Preparar o ambiente e os dados dedicados

É necessária uma VM separada Debian 13 com acesso sudo, Python 3, GNU tar e um sistema de arquivos que suporte ACL e atributos estendidos. O ambiente de verificação usou tar 1.35, acl 2.3.2, attr 2.5.2 e ext4. Um usuário comum lfstudent existia, usando um ambiente com UID/GID 1000. Se estiver usando uma conta diferente, ajuste o proprietário e as diretivas User e Group da unidade para a conta real abaixo.

A pasta de backup é somente para root, e o caminho de prática será recém-criado. Pare se qualquer verificação de conta, instalação ou caminho falhar. Não exclua dados existentes para ajustar ao exercício. Execute esses blocos Bash em um shell de laboratório dedicado; uma saída no mecanismo de prevenção de colisão termina esse shell. Se a porta 8080 estiver sendo usada por outro serviço, escolha uma porta dedicada e reflita-a de maneira consistente em todo o exemplo.

sudo apt install tar acl attr python3 curl
id lfstudent
ss -ltn
for p in /srv/lf-backup30 /var/backups/lf-debian13-30 /etc/systemd/system/lf-backup30.service /etc/systemd/system/lf-backup30.service.d; do
    if test -e "$p"; then echo "Already exists: $p" >&2; exit 1; fi
done
sudo install -d -m 755 /srv/lf-backup30/source /srv/lf-backup30/restore
sudo install -d -m 700 /var/backups/lf-debian13-30
printf 'backup payload 30\n' | sudo tee /srv/lf-backup30/source/message.txt
sudo chown lfstudent:lfstudent /srv/lf-backup30/source/message.txt
sudo chmod 640 /srv/lf-backup30/source/message.txt
sudo setfacl -m u:nobody:r-- /srv/lf-backup30/source/message.txt
sudo setfattr -n user.lf-course -v backup30 /srv/lf-backup30/source/message.txt
sudo ln /srv/lf-backup30/source/message.txt /srv/lf-backup30/source/message-hard.txt
sudo ln -s message.txt /srv/lf-backup30/source/current.txt

ACL (Lista de Controle de Acesso) é uma lista que especifica acesso para usuários específicos além das permissões padrão de proprietário, grupo e outros usuários. Aqui, uma entrada de leitura para nobody é adicionada para fins de comparação durante a restauração. As permissões de travessia de diretório e a máscara de ACL também afetam o acesso real, portanto, não julgue a acessibilidade apenas por uma única entrada de ACL.

Atributos estendidos são um recurso que anexa informações adicionais em forma de nome-valor a um arquivo. Este exemplo testa um atributo no namespace user.*. Ele não se generaliza para preservar atributos security.*, rótulos SELinux ou capacidades de arquivo. O exemplo também cria dois tipos de link de arquivo. Um hard link é outro nome para o mesmo objeto de arquivo, e um symlink aponta para o caminho de destino.

Salvar o exemplo HTTP completo e a resposta normal

Salve o programa completo a seguir em app.py. Ele lê current.txt do LF_DATA_DIR e o retorna como está, e se o arquivo não puder ser lido, retorna 503. Este é um exercício de loopback não exposto externamente.

sudo tee /srv/lf-backup30/source/app.py > /dev/null <<'PY'
import os,pathlib
from http.server import BaseHTTPRequestHandler,HTTPServer
data=pathlib.Path(os.environ['LF_DATA_DIR'])
class Handler(BaseHTTPRequestHandler):
    def do_GET(self):
        try:
            body=(data/'current.txt').read_bytes()
            status=200
        except OSError:
            body=b'data unavailable\n'
            status=503
        self.send_response(status)
        self.send_header('Content-Type','text/plain; charset=utf-8')
        self.send_header('Content-Length',str(len(body)))
        self.end_headers()
        self.wfile.write(body)
HTTPServer(('127.0.0.1',8080),Handler).serve_forever()
PY
sudo tee /etc/systemd/system/lf-backup30.service > /dev/null <<'UNIT'
[Unit]
Description=LF backup restore HTTP lab 30
[Service]
Type=exec
User=lfstudent
Group=lfstudent
Environment=LF_DATA_DIR=/srv/lf-backup30/source
ExecStart=/usr/bin/python3 /srv/lf-backup30/source/app.py
UNIT
sudo chmod 644 /srv/lf-backup30/source/app.py
sudo systemctl daemon-reload
sudo systemctl start lf-backup30.service
curl --noproxy '*' -fsS http://127.0.0.1:8080/ | sudo tee /var/backups/lf-debian13-30/http-before.txt
sudo cmp /var/backups/lf-debian13-30/http-before.txt /srv/lf-backup30/source/message.txt

A resposta é o texto exato backup payload 30 e, se o cmp tiver sucesso, ele sai sem gerar saída. Se não estiver pronto logo após iniciar, solicite novamente após um curto período de espera. Se continuar a falhar, verifique o caminho real do arquivo, permissões e erros de porta com systemctl status e journalctl -u lf-backup30.service. Não ignore falhas de solicitação e não use um arquivo de resposta vazio como referência normal.

Armazenar metadados e o arquivo tar com o serviço parado

Após parar o serviço, preserve a unidade original e os metadados do arquivo. O registro serve como base para comparação com os resultados da restauração. A opção -cn mostra os itens com IDs numéricos, omitindo os cabeçalhos de caminho ACL e descrição do proprietário.

sudo systemctl stop lf-backup30.service
sudo cp -a /etc/systemd/system/lf-backup30.service /var/backups/lf-debian13-30/
sudo getfacl -cn /srv/lf-backup30/source/message.txt | sudo tee /var/backups/lf-debian13-30/acl-before.txt
sudo getfattr --only-values -n user.lf-course /srv/lf-backup30/source/message.txt | sudo tee /var/backups/lf-debian13-30/xattr-before.txt
sudo stat -c '%u:%g:%a' /srv/lf-backup30/source/message.txt | sudo tee /var/backups/lf-debian13-30/stat-before.txt
sudo tar --format=posix --acls --xattrs --xattrs-include='user.*' --numeric-owner -cpf /var/backups/lf-debian13-30/source.tar -C /srv/lf-backup30 source

-c especifica a criação, -f especifica o caminho do arquivo e -C especifica o diretório base. Este comando preserva o caminho relativo source e armazena o arquivo de backup fora dele. Use --acls e --xattrs para lidar com os metadados correspondentes e restrinja o escopo para incluir apenas user.*. As opções usadas podem ser encontradas no manual Debian de GNU tar.

Não adicione -h: isso seguiria links simbólicos e arquivaria seus destinos em vez dos próprios links. Neste exemplo, current.txt é mantido como o próprio link. Qual nome de um link físico é registrado primeiro com o conteúdo pode variar, mas o que importa é que a relação de que os dois nomes são o mesmo objeto seja preservada.

O hash é criado com base na pasta de backup em um shell administrativo separado. O bloco abaixo é executado apenas dentro do shell root, com os caminhos entre aspas, e não modifica o arquivo tar íntegro.

sudo bash <<'ROOT'
set -euo pipefail
cd /var/backups/lf-debian13-30
sha256sum source.tar > source.tar.sha256
sha256sum -c source.tar.sha256
tar -tvf source.tar
ROOT

A verificação de hash serve como um critério para detectar alterações durante o armazenamento e transmissão. Se o backup e o arquivo de hash forem adulterados juntos, a autenticidade não pode ser garantida, portanto, é distinguida de restrições de acesso, armazenamento independente ou procedimentos de assinatura necessários. O fato de que uma lista tar pode ser lida não significa que todos os conteúdos de arquivo e a recuperação de serviço foram verificados.

Rejeitar uma cópia danificada antes da extração

O seguinte é um exercício em preservar o arquivo normal e inverter apenas um byte de uma cópia. Se uma cópia com o mesmo nome existir, ela não é sobrescrita. Não tentamos forçadamente recuperar cópias corrompidas, e se o hash diferir da referência normal, ele não é extraído.

sudo test ! -e /var/backups/lf-debian13-30/source-corrupt.tar && sudo cp -a /var/backups/lf-debian13-30/source.tar /var/backups/lf-debian13-30/source-corrupt.tar

Execute o bloco Python somente se o comando de cópia anterior for bem-sucedido. Se o destino já existir ou a cópia falhar, pare e inspecione-o; não modifique uma cópia mais antiga.

sudo python3 - <<'PY'
import hashlib,pathlib
bad=pathlib.Path('/var/backups/lf-debian13-30/source-corrupt.tar')
with bad.open('r+b') as f:
    f.seek(1024)
    old=f.read(1)
    if len(old)!=1:raise SystemExit('Too short')
    f.seek(1024);f.write(bytes([old[0]^1]))
good_hash=pathlib.Path('/var/backups/lf-debian13-30/source.tar.sha256').read_text().split()[0]
if hashlib.sha256(bad.read_bytes()).hexdigest()==good_hash:raise SystemExit('Corruption not detected')
print('CORRUPT_COPY_REJECTED_WITHOUT_EXTRACTION')
PY

O resultado da verificação foi CORRUPT_COPY_REJECTED_WITHOUT_EXTRACTION. Isso indica que uma cópia corrompida foi encontrada e não significa sucesso na recuperação do backup normal. Na próxima seção, o hash do arquivo íntegro source.tar será verificado novamente antes de prosseguir.

Restaurar em um caminho vazio e comparar conteúdo e metadados

Restaure apenas os backups que você criou e verificou a origem com privilégios de root, conforme mostrado abaixo. Não extraia como root sem verificar os caminhos e links de arquivos recebidos de outras fontes. Em vez de sobrescrever diretamente o diretório de serviço existente, use um caminho de restauração dedicado vazio.

sudo bash <<'ROOT'
set -euo pipefail
cd /var/backups/lf-debian13-30
sha256sum -c source.tar.sha256
test -z "$(find /srv/lf-backup30/restore -mindepth 1 -maxdepth 1 -print -quit)"
tar --acls --xattrs --xattrs-include='user.*' --numeric-owner --same-owner -xpf source.tar -C /srv/lf-backup30/restore
cmp /srv/lf-backup30/source/message.txt /srv/lf-backup30/restore/source/message.txt
cmp /srv/lf-backup30/source/app.py /srv/lf-backup30/restore/source/app.py
getfacl -cn /srv/lf-backup30/restore/source/message.txt > acl-after.txt
getfattr --only-values -n user.lf-course /srv/lf-backup30/restore/source/message.txt > xattr-after.txt
stat -c '%u:%g:%a' /srv/lf-backup30/restore/source/message.txt > stat-after.txt
cmp acl-before.txt acl-after.txt
cmp xattr-before.txt xattr-after.txt
cmp stat-before.txt stat-after.txt
test "$(readlink /srv/lf-backup30/restore/source/current.txt)" = message.txt
test "$(stat -c %i /srv/lf-backup30/restore/source/message.txt)" = "$(stat -c %i /srv/lf-backup30/restore/source/message-hard.txt)"
test "$(stat -c %h /srv/lf-backup30/restore/source/message.txt)" = 2
echo RESTORE_METADATA_PASSED
ROOT

-x é para extração, -p aplica as permissões salvas, e --same-owner e --numeric-owner são usados para preservar a propriedade numérica. Ao mover para outro servidor, o número 1000 pode pertencer à conta de outra pessoa, então determine primeiro o mapeamento de ID de usuário e grupo. Preservar mapeamentos incorretos não constitui uma restauração adequada.

Itens de verificação Resultados reais
message.txt e app.py Bytes idênticos ao original
Propriedade numérica e modo 1000:1000:640 mantido
ACL user:65534:r-- e itens, incluindo máscara, idênticos
user.lf-course backup30 idêntico
link físico O inode dos dois nomes restaurados é idêntico, contagem de links 2
symlink current.txt → message.txt mantido

Não é necessário que o inode restaurado tenha o mesmo número que o inode original. Ele compara se os dois links físicos dentro da cópia restaurada compartilham o mesmo objeto. Para os itens numéricos e interpretação de máscara dos resultados de ACL, consulte a documentação do getfacl , e para consultar atributos estendidos, consulte a documentação do getfattr .

Executar o serviço apenas com a cópia restaurada

Mova o diretório original para source-held sem excluí-lo para liberar o caminho original. Em seguida, adicione apenas um drop-in a esta unidade de prática para alterar tanto os caminhos do código quanto os dados para a cópia restaurada. Antes de mover o original, confirme que o serviço está parado e que source-held não existe. Se o teste ou a movimentação falhar, interrompa o procedimento antes de criar o drop-in; não prossiga com o estado dos caminhos indefinido.

sudo test ! -e /srv/lf-backup30/source-held && sudo mv /srv/lf-backup30/source /srv/lf-backup30/source-held
sudo install -d /etc/systemd/system/lf-backup30.service.d
sudo tee /etc/systemd/system/lf-backup30.service.d/20-restored.conf > /dev/null <<'DROP'
[Service]
Environment=LF_DATA_DIR=/srv/lf-backup30/restore/source
ExecStart=
ExecStart=/usr/bin/python3 /srv/lf-backup30/restore/source/app.py
DROP
sudo systemctl daemon-reload
sudo systemctl start lf-backup30.service
curl --noproxy '*' -fsS http://127.0.0.1:8080/ | sudo tee /var/backups/lf-debian13-30/http-after.txt
sudo cmp /var/backups/lf-debian13-30/http-before.txt /var/backups/lf-debian13-30/http-after.txt
sudo systemctl is-active lf-backup30.service

Na verificação real, o serviço restaurado estava ativo e os bytes de resposta eram os mesmos mesmo quando o caminho de origem original estava ausente. A restauração para esta prática só é considerada completa quando a restauração do arquivo, a verificação de metadados, o início do processo e a resposta HTTP forem todos aprovados. Imediatamente após a inicialização, se as solicitações falharem, verifique o status e os logs e tente novamente, mas não considere como concluído até que as respostas tenham sido comparadas com sucesso.

Se houver um problema ao executar a versão restaurada, pare o serviço, mantendo o original, e remova apenas o drop-in 20-restored.conf deste exercício. Você pode mover source-held de volta para source, desde que source não exista, e voltar para a configuração original executando daemon-reload, iniciando o serviço e verificando a resposta. Se o diretório source já existir, não a sobrescreva e primeiro verifique o status do caminho.

Preservar os backups e limpar apenas o exercício

Execute a limpeza a seguir somente quando a verificação da restauração estiver concluída e os arquivos de prática das versões original e restaurada não forem mais necessários. Os registros de comparação com o arquivo normal são mantidos. Se outros arquivos tiverem sido adicionados a cada caminho, deixe rmdir falhar e verifique o motivo.

sudo systemctl stop lf-backup30.service
sudo rm -- /etc/systemd/system/lf-backup30.service.d/20-restored.conf /etc/systemd/system/lf-backup30.service
sudo rmdir /etc/systemd/system/lf-backup30.service.d
sudo systemctl daemon-reload
for d in /srv/lf-backup30/source-held /srv/lf-backup30/restore/source; do
    sudo rm -- "$d/current.txt" "$d/message-hard.txt" "$d/message.txt" "$d/app.py"
    sudo rmdir "$d"
done
sudo rmdir /srv/lf-backup30/restore /srv/lf-backup30
ss -ltn
sudo ls -lh /var/backups/lf-debian13-30

Após a verificação, o serviço dedicado, os caminhos de prática e a porta de escuta 8080 foram removidos, enquanto o arquivo tar íntegro, seu hash e os metadados e registros de resposta foram preservados. Como este backup local também está no mesmo disco do host, para se preparar para a perda total do host, devem ser estabelecidos local de armazenamento separado, teste de restauração, controle de acesso e cronograma de retenção em conjunto.