Резервные копии

Восстановление в отдельную папку

Распаковывает tar-архив только в новую папку и блокирует опасные пути внутри архива.

Python Windows macOS Linux Средний
Скачать restore_backup.py
Описание

Что делает скрипт

Скрипт проверяет имена элементов, отказывается от абсолютных путей, переходов вверх и ссылок, затем создаёт файлы в указанной пустой папке. Существующая непустая папка не используется. После распаковки можно сверить результат с manifest.

Перед запуском
  • Восстановление выполняется только в новую или пустую папку.
Запуск

Быстрый старт

python restore_backup.py --archive /mnt/backup/site.tar.gz --dest ~/restore/site

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python restore_backup.py --archive /mnt/backup/site.tar.gz --dest ~/restore/site
  • python restore_backup.py --archive /mnt/backup/site.tar.gz --dest ~/restore/site --dry-run
  • python restore_backup.py --archive /mnt/backup/site.tar.gz --dest ~/restore/site --manifest /mnt/backup/site.sha256
Зависимости

Что понадобится

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
Исходник

restore_backup.py

#!/usr/bin/env python3
"""Безопасное восстановление tar-архива в отдельную папку."""
from __future__ import annotations

import argparse
import hashlib
import os
import shutil
import sys
import tarfile
from pathlib import Path


def file_digest(path: Path, chunk_size: int = 1024 * 1024) -> str:
    digest = hashlib.sha256()
    with path.open("rb") as handle:
        while block := handle.read(chunk_size):
            digest.update(block)
    return digest.hexdigest()


def check_member(member: tarfile.TarInfo) -> str:
    name = member.name.replace("\\", "/")
    if not name or name.startswith("/"):
        return "абсолютный путь"
    parts = Path(name).parts
    if any(part == ".." for part in parts):
        return "переход вверх"
    if member.issym() or member.islnk():
        return "ссылка"
    if member.ischr() or member.isblk() or member.isfifo():
        return "специальный файл"
    if not (member.isfile() or member.isdir()):
        return "неподдерживаемый тип"
    return ""


def parse_manifest(path: Path) -> dict[str, str]:
    result: dict[str, str] = {}
    for raw_line in path.read_text(encoding="utf-8", errors="replace").splitlines():
        line = raw_line.strip()
        if not line or line.startswith("#"):
            continue
        parts = line.split(None, 1)
        if len(parts) != 2:
            continue
        digest, name = parts
        result[name.lstrip("*").strip().lstrip("./")] = digest.lower()
    return result


def main() -> int:
    parser = argparse.ArgumentParser(description="Восстановить tar-архив в новую папку")
    parser.add_argument("--archive", type=Path, required=True)
    parser.add_argument("--dest", type=Path, required=True)
    parser.add_argument("--manifest", type=Path)
    parser.add_argument("--dry-run", action="store_true")
    args = parser.parse_args()

    archive_path = args.archive.expanduser().resolve()
    dest = args.dest.expanduser().resolve()
    if not archive_path.is_file():
        parser.error(f"Архив не найден: {archive_path}")
    if dest.exists() and not dest.is_dir():
        parser.error(f"Назначение не является папкой: {dest}")
    if dest.is_dir() and any(dest.iterdir()):
        parser.error("Папка назначения должна быть пустой")

    expected = parse_manifest(args.manifest.expanduser().resolve()) if args.manifest else {}

    extracted = 0
    skipped = 0
    problems = 0
    try:
        archive = tarfile.open(archive_path, "r:*")
    except tarfile.TarError as error:
        print(f"Не удалось открыть архив: {error}", file=sys.stderr)
        return 2

    with archive:
        members = archive.getmembers()
        for member in members:
            reason = check_member(member)
            if reason:
                print(f"Пропуск {member.name}: {reason}", file=sys.stderr)
                problems += 1
                continue
            target = dest / member.name
            try:
                target.relative_to(dest)
            except ValueError:
                print(f"Пропуск {member.name}: путь вне назначения", file=sys.stderr)
                problems += 1
                continue
            if args.dry_run:
                print(f"Будет восстановлено: {member.name}")
                continue
            if member.isdir():
                target.mkdir(parents=True, exist_ok=True)
                continue
            source = archive.extractfile(member)
            if source is None:
                problems += 1
                continue
            target.parent.mkdir(parents=True, exist_ok=True)
            try:
                with target.open("xb") as handle:
                    shutil.copyfileobj(source, handle)
                mode = member.mode & 0o777
                if mode:
                    target.chmod(mode)
                os.utime(target, (member.mtime, member.mtime))
                extracted += 1
            except OSError as error:
                problems += 1
                print(f"Ошибка {member.name}: {error}", file=sys.stderr)

    if args.dry_run:
        print(f"Элементов: {len(members)}, проблем: {problems}")
        return 1 if problems else 0

    if args.manifest:
        for relative, expected_digest in expected.items():
            candidate = dest / relative
            if not candidate.is_file():
                print(f"Нет файла из manifest: {relative}", file=sys.stderr)
                problems += 1
                continue
            if file_digest(candidate) != expected_digest:
                print(f"Хеш не совпал: {relative}", file=sys.stderr)
                problems += 1

    print(f"Восстановлено файлов: {extracted}, пропущено: {skipped}, проблем: {problems}")
    print(f"Папка: {dest}")
    return 1 if problems else 0


if __name__ == "__main__":
    sys.exit(main())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get backup-restore-folder
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Резервные копии

Резервное копирование, синхронизация, проверка и восстановление данных.