#!/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())