Аудит архивов
Проверяет zip и tar на path traversal, ссылки, исполняемые файлы и бомбы.
Что делает скрипт
Скрипт читает центральные каталоги ZIP и заголовки TAR без распаковки. Он ищет абсолютные пути, выход через .., символические ссылки наружу, устройства, исполняемые расширения, шифрование и подозрительно сильное сжатие. Для 7z и RAR выводится отдельное сообщение о неподдерживаемом формате.
Быстрый старт
python audit_archives.py --path ./downloads
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python audit_archives.py --path ./archive.zippython audit_archives.py --path . --max-ratio 500 --json archives.json
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
audit_archives.py
#!/usr/bin/env python3
"""Аудит ZIP и TAR архивов без извлечения файлов."""
from __future__ import annotations
import argparse
import json
import re
import stat
import tarfile
import zipfile
from pathlib import Path
ARCHIVE_SUFFIXES = (".zip", ".tar", ".tar.gz", ".tgz", ".tar.bz2", ".tbz2", ".tar.xz", ".txz")
UNSUPPORTED = {".7z", ".rar"}
EXECUTABLE = {".exe", ".scr", ".bat", ".cmd", ".ps1", ".sh", ".js", ".vbs", ".jar", ".msi", ".com", ".pif", ".hta"}
NESTED = {".zip", ".tar", ".tgz", ".gz", ".bz2", ".xz", ".7z", ".rar"}
def name_issues(name: str) -> list[str]:
issues = []
normalized = name.replace("\\", "/")
if normalized.startswith("/") or re.match(r"^[A-Za-z]:", normalized):
issues.append("абсолютный путь")
parts = [part for part in normalized.split("/") if part not in ("", ".")]
if ".." in parts:
issues.append("выход через ..")
if "\x00" in name:
issues.append("NUL в имени")
return issues
def inspect_zip(path: Path, max_ratio: float, max_total: int, limit: int) -> dict[str, object]:
issues: list[str] = []
entries = total = encrypted = links = executables = nested = 0
try:
with zipfile.ZipFile(path) as archive:
for info in archive.infolist():
entries += 1
issues.extend(f"{info.filename}: {item}" for item in name_issues(info.filename))
if info.flag_bits & 0x1:
encrypted += 1
mode = (info.external_attr >> 16) & 0xFFFF
if mode and stat.S_ISLNK(mode):
links += 1
if info.is_dir():
continue
total += info.file_size
suffix = Path(info.filename).suffix.lower()
if suffix in EXECUTABLE:
executables += 1
if suffix in NESTED:
nested += 1
if info.compress_size > 0:
ratio = info.file_size / info.compress_size
if ratio > max_ratio:
issues.append(f"{info.filename}: сжатие {ratio:.0f}:1")
except (zipfile.BadZipFile, OSError, RuntimeError) as error:
return {"format": "zip", "error": str(error)}
if total > max_total:
issues.append(f"распакованный размер {total} больше лимита {max_total}")
return {
"format": "zip",
"entries": entries,
"total_size": total,
"encrypted": encrypted,
"links": links,
"executables": executables,
"nested": nested,
"issues": issues[:limit],
"issue_count": len(issues),
}
def inspect_tar(path: Path, max_total: int, limit: int) -> dict[str, object]:
issues: list[str] = []
entries = total = links = executables = devices = nested = 0
try:
with tarfile.open(path, "r:*") as archive:
for member in archive:
entries += 1
issues.extend(f"{member.name}: {item}" for item in name_issues(member.name))
if member.issym() or member.islnk():
links += 1
target = member.linkname.replace("\\", "/")
target_parts = [part for part in target.split("/") if part not in ("", ".")]
if target.startswith("/") or ".." in target_parts:
issues.append(f"{member.name}: ссылка наружу {member.linkname}")
if member.isdev():
devices += 1
issues.append(f"{member.name}: файл устройства")
if member.isfile():
total += member.size
suffix = Path(member.name).suffix.lower()
if suffix in EXECUTABLE:
executables += 1
if suffix in NESTED:
nested += 1
except (tarfile.TarError, OSError, EOFError) as error:
return {"format": "tar", "error": str(error)}
if total > max_total:
issues.append(f"распакованный размер {total} больше лимита {max_total}")
return {
"format": "tar",
"entries": entries,
"total_size": total,
"links": links,
"executables": executables,
"devices": devices,
"nested": nested,
"issues": issues[:limit],
"issue_count": len(issues),
}
def archive_kind(path: Path) -> str:
lower = path.name.lower()
if lower.endswith(".zip"):
return "zip"
if lower.endswith(ARCHIVE_SUFFIXES[1:]):
return "tar"
suffix = path.suffix.lower()
if suffix in UNSUPPORTED:
return "unsupported"
return ""
def main() -> int:
parser = argparse.ArgumentParser(description="Аудит архивов")
parser.add_argument("--path", type=Path, required=True, help="Архив или каталог")
parser.add_argument("--max-ratio", type=float, default=1000.0, help="Порог коэффициента сжатия")
parser.add_argument("--max-total-mb", type=int, default=2048, help="Порог распакованного размера, МБ")
parser.add_argument("--limit", type=int, default=50, help="Максимум проблем на архив")
parser.add_argument("--json", type=Path, help="Сохранить отчёт в JSON")
args = parser.parse_args()
source = args.path.expanduser().resolve()
if not source.exists():
parser.error(f"Путь не найден: {source}")
files = [source] if source.is_file() else [item for item in sorted(source.rglob("*")) if item.is_file()]
max_total = args.max_total_mb * 1024 * 1024
reports = []
for path in files:
kind = archive_kind(path)
if not kind:
continue
if kind == "unsupported":
reports.append({"file": str(path), "format": "unsupported", "issues": ["формат не поддерживается"]})
continue
if kind == "zip":
report = inspect_zip(path, args.max_ratio, max_total, args.limit)
else:
report = inspect_tar(path, max_total, args.limit)
report["file"] = str(path)
reports.append(report)
print(f"Проверено архивов: {len(reports)}")
for report in reports:
print()
print(f" {report['file']} [{report.get('format', '?')}]")
if report.get("error"):
print(f" ошибка чтения: {report['error']}")
continue
if report.get("format") == "unsupported":
print(" формат не поддерживается, проверьте вручную")
continue
print(f" записей: {report.get('entries', 0)}, распакованный размер: {report.get('total_size', 0)} байт")
print(f" исполняемых: {report.get('executables', 0)}, ссылок: {report.get('links', 0)}, вложенных архивов: {report.get('nested', 0)}")
if report.get("encrypted"):
print(f" зашифрованных записей: {report['encrypted']}")
issue_count = report.get("issue_count", 0)
print(f" проблем: {issue_count}")
for issue in report.get("issues", [])[: args.limit]:
print(f" - {issue}")
if args.json:
args.json.write_text(json.dumps({"archives": reports}, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
print(f"JSON сохранён: {args.json}")
return 0
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.