Архивы

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

Проверяет имена файлов, блокирует path traversal и не перезаписывает существующие файлы.

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

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

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

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

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

python extract_zip_safe.py backup.zip ./restore

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

Примеры

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

  • python extract_zip_safe.py backup.zip ./restore
  • python extract_zip_safe.py backup.zip ./restore --force
  • python extract_zip_safe.py backup.zip ./restore --dry-run
Зависимости

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

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

extract_zip_safe.py

#!/usr/bin/env python3
"""Безопасная распаковка zip."""
from __future__ import annotations

import argparse
import os
import shutil
import stat
import zipfile
from pathlib import Path, PurePosixPath, PureWindowsPath


def safe_parts(name: str) -> tuple[str, ...]:
    normalized = name.replace("\\", "/")
    path = PurePosixPath(normalized)
    if path.is_absolute() or PureWindowsPath(normalized).drive:
        raise ValueError(f"абсолютный путь: {name}")
    parts = tuple(part for part in path.parts if part not in ("", "."))
    if not parts:
        raise ValueError(f"пустое имя: {name!r}")
    if any(part == ".." for part in parts):
        raise ValueError(f"выход из папки: {name}")
    return parts


def is_symlink(info: zipfile.ZipInfo) -> bool:
    mode = (info.external_attr >> 16) & 0o170000
    return mode == stat.S_IFLNK


def main() -> int:
    parser = argparse.ArgumentParser(description="Безопасно распаковать zip")
    parser.add_argument("archive", type=Path, help="Zip-архив")
    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()

    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}")

    with zipfile.ZipFile(archive_path) as archive:
        plan: list[tuple[zipfile.ZipInfo, Path]] = []
        errors: list[str] = []
        skipped: list[str] = []
        for info in archive.infolist():
            try:
                parts = safe_parts(info.filename)
            except ValueError as error:
                errors.append(str(error))
                continue
            if info.flag_bits & 0x1:
                skipped.append(f"{info.filename}: зашифрован")
                continue
            if is_symlink(info):
                skipped.append(f"{info.filename}: символическая ссылка")
                continue
            target = destination.joinpath(*parts)
            if not target.resolve().is_relative_to(destination.resolve()):
                errors.append(f"путь вне папки: {info.filename}")
                continue
            plan.append((info, target))

        if errors:
            print("Распаковка отменена, найдены небезопасные элементы:")
            for error in errors:
                print(f"  {error}")
            return 2

        for name in skipped:
            print(f"Пропуск: {name}")

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

        if args.dry_run:
            for info, target in plan:
                kind = "папка" if info.is_dir() else "файл"
                print(f"{kind}: {target.relative_to(destination)}")
            print("Режим проверки: ничего не записано.")
            return 0

        destination.mkdir(parents=True, exist_ok=True)
        files = 0
        for info, target in plan:
            if info.is_dir():
                target.mkdir(parents=True, exist_ok=True)
                continue
            target.parent.mkdir(parents=True, exist_ok=True)
            with archive.open(info) as source, target.open("wb") as handle:
                shutil.copyfileobj(source, handle)
            try:
                mode = (info.external_attr >> 16) & 0o777
                if mode:
                    os.chmod(target, mode)
            except OSError:
                pass
            files += 1

    print(f"Распаковано файлов: {files} в {destination}")
    return 0


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

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

CLI 1.0.0

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

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

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

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

Категория

Архивы

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