Восстановление в отдельную папку
Распаковывает tar-архив только в новую папку и блокирует опасные пути внутри архива.
Что делает скрипт
Скрипт проверяет имена элементов, отказывается от абсолютных путей, переходов вверх и ссылок, затем создаёт файлы в указанной пустой папке. Существующая непустая папка не используется. После распаковки можно сверить результат с 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/sitepython restore_backup.py --archive /mnt/backup/site.tar.gz --dest ~/restore/site --dry-runpython restore_backup.py --archive /mnt/backup/site.tar.gz --dest ~/restore/site --manifest /mnt/backup/site.sha256
Что понадобится
winget install Python.Python.3.12
brew install python
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.