Безопасно распаковать zip
Проверяет имена файлов, блокирует path traversal и не перезаписывает существующие файлы.
Что делает скрипт
Скрипт сначала строит план распаковки и проверяет каждый элемент: абсолютные пути, диски Windows и переходы через .. отклоняются до записи. Символические ссылки и зашифрованные элементы пропускаются с предупреждением. Затем файлы аккуратно копируются в указанную папку, а существующие цели перезаписываются только с флагом --force.
- Распаковка создаёт файлы в указанной папке.
- Существующие файлы перезаписываются только с флагом --force.
Быстрый старт
python extract_zip_safe.py backup.zip ./restore
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python extract_zip_safe.py backup.zip ./restorepython extract_zip_safe.py backup.zip ./restore --forcepython extract_zip_safe.py backup.zip ./restore --dry-run
Что понадобится
winget install Python.Python.3.12
brew install python
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.