Безопасно распаковать 7z
Распаковывает 7z через временную папку, проверяет пути и не терпит символические ссылки.
Что делает скрипт
Скрипт читает список элементов через py7zr и отклоняет абсолютные пути и переходы через две точки. Распаковка идёт во временную папку рядом с целью, затем проверяется отсутствие символических ссылок. Только после этого файлы переносятся в указанный каталог, а существующие файлы перезаписываются лишь с --force.
- Существующие файлы перезаписываются только с флагом --force.
- Пароль не сохраняется на диск.
Быстрый старт
python extract_7z_safe.py backup.7z ./restore
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python extract_7z_safe.py backup.7z ./restoreARCHIVE_PASSWORD=demo python extract_7z_safe.py secret.7z ./restorepython extract_7z_safe.py backup.7z ./restore --dry-run
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
py -m pip install py7zr
python3 -m pip install py7zr
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.