macOS

Сканировать карантин Gatekeeper

Ищет файлы с атрибутом com.apple.quarantine и показывает источник загрузки

Python macOS Продвинутый
Скачать quarantine_scan.py
Описание

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

Скрипт обходит указанную папку и читает расширенный атрибут com.apple.quarantine, не открывая файлы. В отчёте видны дата, приложение-загрузчик и UUID события, а также распределение по источникам. Очистка атрибута выполняется только с --clear и подтверждением.

Перед запуском
  • Снятие атрибута карантина снижает защиту Gatekeeper для этих файлов.
  • Не очищайте карантин у файлов, происхождение которых неизвестно.
Запуск

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

python3 quarantine_scan.py --path ~/Downloads

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

Примеры

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

  • python3 quarantine_scan.py --path ~/Downloads
  • python3 quarantine_scan.py --path ~/Downloads --json quarantine.json
  • python3 quarantine_scan.py --path ~/Downloads --clear
Зависимости

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

Python 3.10+ Только стандартная библиотека
macOS brew install python
Исходник

quarantine_scan.py

#!/usr/bin/env python3
"""Поиск и очистка атрибута com.apple.quarantine."""
from __future__ import annotations

import argparse
import json
import os
import stat
import sys
from collections import Counter
from datetime import datetime
from pathlib import Path

ATTRIBUTE = "com.apple.quarantine"
PROTECTED = {Path("/System"), Path("/Library"), Path("/Applications")}


def parse_value(value: bytes) -> dict:
    text = value.decode("utf-8", "replace")
    parts = text.split(";")
    flags = parts[0] if parts else ""
    timestamp = ""
    if len(parts) > 1:
        try:
            timestamp = datetime.fromtimestamp(int(parts[1], 16)).isoformat(sep=" ", timespec="seconds")
        except ValueError:
            timestamp = parts[1]
    return {
        "flags": flags,
        "timestamp": timestamp,
        "agent": parts[2] if len(parts) > 2 else "",
        "uuid": parts[3] if len(parts) > 3 else "",
    }


def scan(root: Path) -> list[dict]:
    rows = []
    for directory, subdirs, files in os.walk(root):
        subdirs[:] = [name for name in subdirs if not os.path.islink(os.path.join(directory, name))]
        for name in files:
            path = Path(directory) / name
            try:
                if path.is_symlink():
                    continue
                value = os.getxattr(path, ATTRIBUTE)
            except (OSError, AttributeError):
                continue
            metadata = parse_value(value)
            metadata["path"] = str(path)
            metadata["size"] = path.stat().st_size
            rows.append(metadata)
    return rows


def main() -> int:
    parser = argparse.ArgumentParser(description="Сканировать карантин Gatekeeper")
    parser.add_argument("--path", type=Path, default=Path.home() / "Downloads")
    parser.add_argument("--clear", action="store_true", help="Снять атрибут карантина")
    parser.add_argument("--yes", action="store_true")
    parser.add_argument("--json", type=Path)
    args = parser.parse_args()

    root = args.path.expanduser().resolve()
    if not root.is_dir():
        parser.error(f"Папка не найдена: {root}")
    if root == Path("/") or any(root == item or item in root.parents for item in PROTECTED):
        parser.error("Нельзя сканировать системный каталог с очисткой.")

    rows = scan(root)
    agents = Counter(row["agent"] or "неизвестно" for row in rows)
    report = {
        "root": str(root),
        "total": len(rows),
        "agents": dict(agents),
        "items": rows,
    }

    if args.json:
        args.json.write_text(json.dumps(report, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")

    print(f"Папка: {root}")
    print(f"Файлов с карантином: {len(rows)}.")
    for agent, count in agents.most_common():
        print(f"  {agent}: {count}")

    for row in sorted(rows, key=lambda item: item["timestamp"])[:20]:
        print(f"\n{row['path']}")
        print(f"  дата: {row['timestamp'] or 'неизвестно'}")
        print(f"  источник: {row['agent'] or 'неизвестно'}")
        print(f"  флаги: {row['flags'] or 'нет'}")
        print(f"  размер: {row['size']} байт")

    if not args.clear:
        return 0
    if not rows:
        print("Нечего очищать.")
        return 0
    if not args.yes:
        answer = input(f"Снять карантин с {len(rows)} файлов? [y/N]: ").strip().lower()
        if answer not in {"y", "yes", "д", "да"}:
            print("Отменено.")
            return 1

    errors = 0
    for row in rows:
        try:
            os.removexattr(row["path"], ATTRIBUTE)
        except OSError as error:
            errors += 1
            print(f"Ошибка для {row['path']}: {error}", file=sys.stderr)
    print(f"Очищено: {len(rows) - errors}. Ошибок: {errors}.")
    return 0 if errors == 0 else 1


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

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

CLI 1.0.0

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

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

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

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

Категория

macOS

Shell, Python и автоматизация macOS без лишних приложений.