Архивы

Безопасно распаковать 7z

Распаковывает 7z через временную папку, проверяет пути и не терпит символические ссылки.

Python Windows macOS Linux Продвинутый
Скачать extract_7z_safe.py
Описание

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

Скрипт читает список элементов через py7zr и отклоняет абсолютные пути и переходы через две точки. Распаковка идёт во временную папку рядом с целью, затем проверяется отсутствие символических ссылок. Только после этого файлы переносятся в указанный каталог, а существующие файлы перезаписываются лишь с --force.

Перед запуском
  • Существующие файлы перезаписываются только с флагом --force.
  • Пароль не сохраняется на диск.
Запуск

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

python extract_7z_safe.py backup.7z ./restore

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

Примеры

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

  • python extract_7z_safe.py backup.7z ./restore
  • ARCHIVE_PASSWORD=demo python extract_7z_safe.py secret.7z ./restore
  • python extract_7z_safe.py backup.7z ./restore --dry-run
Зависимости

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

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
py7zr Чтение и запись 7z
Windows py -m pip install py7zr
macOS python3 -m pip install py7zr
Linux python3 -m pip install py7zr
Исходник

extract_7z_safe.py

#!/usr/bin/env python3
"""Безопасная распаковка 7z через временную папку."""
from __future__ import annotations

import argparse
import getpass
import os
import shutil
import sys
import tempfile
from pathlib import Path, PurePosixPath, PureWindowsPath

try:
    import py7zr
    from py7zr.exceptions import Bad7zFile, PasswordRequired
except ImportError:
    py7zr = None
    Bad7zFile = Exception
    PasswordRequired = Exception


def safe_relative(name: str) -> Path:
    normalized = name.replace("\\", "/")
    path = PurePosixPath(normalized)
    if path.is_absolute() or PureWindowsPath(normalized).drive:
        raise ValueError(f"абсолютный путь: {name}")
    parts = [part for part in path.parts if part not in ("", ".")]
    if not parts or any(part == ".." for part in parts):
        raise ValueError(f"небезопасный путь: {name}")
    return Path(*parts)


def open_archive(path: Path, password: str | None):
    try:
        return py7zr.SevenZipFile(path, mode="r", password=password)
    except PasswordRequired:
        if password is not None:
            raise
        entered = getpass.getpass("Пароль архива: ")
        return py7zr.SevenZipFile(path, mode="r", password=entered)


def main() -> int:
    parser = argparse.ArgumentParser(description="Безопасно распаковать 7z")
    parser.add_argument("archive", type=Path, help="7z-архив")
    parser.add_argument("destination", type=Path, help="Папка для распаковки")
    parser.add_argument("--force", action="store_true", help="Перезаписать существующие файлы")
    parser.add_argument("--dry-run", action="store_true", help="Только проверить и показать план")
    args = parser.parse_args()

    if py7zr is None:
        print("Нужен py7zr: python3 -m pip install py7zr", file=sys.stderr)
        return 2

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

    password = os.environ.get("ARCHIVE_PASSWORD") or None
    try:
        archive = open_archive(archive_path, password)
    except PasswordRequired:
        print("Не удалось получить пароль архива.", file=sys.stderr)
        return 2
    except Bad7zFile as error:
        print(f"Файл не похож на 7z: {error}", file=sys.stderr)
        return 2

    with archive:
        try:
            names = archive.getnames()
        except PasswordRequired:
            print("Для просмотра содержимого нужен пароль.", file=sys.stderr)
            return 2

        plan = []
        for name in names:
            try:
                relative = safe_relative(name)
            except ValueError as error:
                print(f"Распаковка отменена: {error}", file=sys.stderr)
                return 2
            target = destination / relative
            if not target.resolve().is_relative_to(destination.resolve()):
                print(f"Распаковка отменена: путь вне папки {name}", file=sys.stderr)
                return 2
            plan.append((name, target, name.endswith("/")))

        existing = [str(target) for _, target, is_dir in plan if not is_dir and target.exists()]
        if existing and not args.force:
            print("Эти файлы уже существуют, используйте --force:")
            for name in existing:
                print(f"  {name}")
            return 1

        if args.dry_run:
            for name, _, _ in plan:
                print(name)
            print("Режим проверки: ничего не записано.")
            return 0

        destination.parent.mkdir(parents=True, exist_ok=True)
        temp = Path(tempfile.mkdtemp(prefix=".archives-7z-", dir=str(destination.parent)))
        try:
            try:
                archive.extractall(path=str(temp))
            except Exception as error:
                print(f"Не удалось распаковать архив: {error}", file=sys.stderr)
                return 1
            links = [str(path) for path in temp.rglob("*") if path.is_symlink()]
            if links:
                print("Найдены символические ссылки, распаковка отменена:", file=sys.stderr)
                for name in links[:20]:
                    print(f"  {name}", file=sys.stderr)
                return 2
            destination.mkdir(parents=True, exist_ok=True)
            shutil.copytree(temp, destination, dirs_exist_ok=True)
        finally:
            shutil.rmtree(temp, ignore_errors=True)

    print(f"Распаковано элементов: {len(plan)} в {destination}")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

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

CLI 1.0.0

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

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

scriptdock get archives-extract-7z-safe
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

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

Категория

Архивы

Упаковка, распаковка, проверка целостности и безопасная работа с архивами.