Сканировать карантин Gatekeeper
Ищет файлы с атрибутом com.apple.quarantine и показывает источник загрузки
Что делает скрипт
Скрипт обходит указанную папку и читает расширенный атрибут com.apple.quarantine, не открывая файлы. В отчёте видны дата, приложение-загрузчик и UUID события, а также распределение по источникам. Очистка атрибута выполняется только с --clear и подтверждением.
- Снятие атрибута карантина снижает защиту Gatekeeper для этих файлов.
- Не очищайте карантин у файлов, происхождение которых неизвестно.
Быстрый старт
python3 quarantine_scan.py --path ~/Downloads
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python3 quarantine_scan.py --path ~/Downloadspython3 quarantine_scan.py --path ~/Downloads --json quarantine.jsonpython3 quarantine_scan.py --path ~/Downloads --clear
Что понадобится
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.