macOS: как снять атрибут карантина с файла (xattr)

  • Обновлено
  • Чтение ≈ 3 минуты

Краткий ответ

Атрибут com.apple.quarantine ставится macOS на скачанные файлы и вызывает проверки Gatekeeper. Просмотреть его можно командой xattr -l, снять — xattr -d или -dr для папки. Применяйте только к файлам, в происхождении которых уверены.

В этой статье
  1. Что такое карантин
  2. Как посмотреть и снять
  3. Когда это помогает и когда нет
App is damaged and can't be opened
«Файл» повреждён и не может быть открыт. Его следует переместить в Корзину.
По-русскиАтрибут карантина или недействительная подпись блокирует запуск программы.

#Что такое карантин

Когда браузер, почтовая программа или мессенджер сохраняет файл, macOS добавляет к нему расширенный атрибут com.apple.quarantine. Он содержит название программы-загрузчика, время и идентификатор. Пока атрибут присутствует, Gatekeeper проверяет файл при первом запуске. Сообщение «повреждён и не может быть открыт» часто означает, что программа не подписана или подпись нарушена, но проблему иногда решает снятие карантина, особенно для утилит с открытым кодом.

Возможная причинаКак узнатьЧто делать
Программа без подписи с открытым кодомУтилита с GitHub.Сообщение о повреждении при корректной загрузке.Снимите карантин, если доверяете источнику.
Файл действительно повреждёнЗагрузка прервана.Размер или контрольная сумма не совпадают.Скачайте заново и сверьте shasum -a 256 файл.
Подпись нарушена после распаковкиАрхиватор изменил файл.codesign --verify выдаёт ошибку.Распакуйте встроенной утилитой «Архиватор».
Приложение архитектуры Intel на Apple SiliconТребуется Rosetta.Другое сообщение.Установите Rosetta (отдельная статья).
Файл заблокирован политикой организацииMDM-профиль.Атрибут возвращается.Обратитесь к администратору.
Файл помечен как вредоносныйСообщение о вредоносном ПО.Программа в списке XProtect.Не открывайте, удалите.

#Как посмотреть и снять

  1. Посмотрите все атрибуты файлаОткройте Finder → «Программы» → «Утилиты» → «Терминал». Введите xattr -l (с пробелом в конце), затем перетащите нужный файл из Finder в окно Терминала: путь вставится с экранированием пробелов. Нажмите Enter. Команда только читает расширенные атрибуты. Если видите com.apple.quarantine, это отметка загруженного файла, но не признак того, что файл безопасен или опасен.
  2. Проверьте подписьСкачивайте программу с официального сайта разработчика или из App Store. В Finder выделите файл и нажмите Command+I, проверьте имя и источник. Если macOS предупреждает о неизвестном разработчике или повреждении приложения, не отключайте Gatekeeper и не снимайте атрибуты карантина без независимой проверки подлинности и подписи. При сомнениях удалите загрузку и получите новую официальную версию.
  3. Убедитесь в источнике файлаВ Finder выделите файл → Command+I, проверьте имя и откуда он скачан. Найдите официальный сайт разработчика и, если опубликована контрольная сумма или цифровая подпись, сверьте её. Если программа повреждена, неизвестного происхождения или macOS сообщает о вредоносном ПО, удалите загрузку и не пытайтесь обходить проверку. Для приложений из App Store изменение атрибутов обычно не требуется.
  4. Снимите атрибут с одного файла или программыУдаление com.apple.quarantine обходит часть проверок macOS и не рекомендуется для устранения обычных предупреждений. Для заведомо доверенного приложения сначала используйте предусмотренный macOS способ: Control+щелчок по приложению → «Открыть» либо меню Apple  → «Системные настройки» → «Конфиденциальность и безопасность» → «Всё равно открыть» (только если такая кнопка действительно появилась). Если macOS сообщает о вредоносном или повреждённом файле, не обходите запрет; обратитесь к разработчику.
  5. Для вложенных файлов в папке или .appРекурсивная команда xattr -dr com.apple.quarantine снимает отметки сразу со многих объектов, включая неизвестные вложенные файлы. Не выполняйте её ради запуска программы: сначала скачайте установщик с официального сайта и проверьте подпись. Если возникла техническая необходимость работать с атрибутами, покажите специалисту вывод xattr -l для конкретного файла; системную защиту массово не отключайте.
  6. Запустите программу сноваЗакройте программу через её меню → «Завершить» или сочетанием Command+Q. Затем откройте Finder → «Программы» и запустите её снова; повторите то же действие, которое приводило к ошибке. При новом сбое запишите текст сообщения и время; не удаляйте приложение вместе с пользовательскими данными без резервной копии.
  7. Команды для отдельных ситуацийВыберите только подходящий вариант. Это не одна последовательность: часть команд диагностирует проблему, а часть меняет настройки или данные.
    Выберите подходящий вариант — это не команды для последовательного выполнения
    Вариант 1Диагностический пример читает атрибуты папки «Загрузки»; для конкретного приложения выберите файл в Finder,…
    Linux · Терминал (Bash)Команда
    Диагностический пример читает атрибуты папки «Загрузки»; для конкретного приложения выберите файл в Finder, скопируйте его точный путь в Терминал перетаскиванием после команды xattr -l (с пробелом). Не удаляйте quarantine ради обхода проверки неизвестной программы.
    xattr -l "$HOME/Downloads"
    Вариант 2Показывает, включена ли проверка Gatekeeper.
    Linux · Терминал (Bash)Команда
    Показывает, включена ли проверка Gatekeeper. Для анализа конкретного приложения понадобится его фактический путь, а не условный Example.app; не отключайте системную защиту.
    spctl --status
    Вариант 3Найти файлы с карантином в папке загрузок
    Linux · Терминал (Bash)Команда
    Найти файлы с карантином в папке загрузок
    find ~/Downloads -maxdepth 2 -exec sh -c 'xattr -p com.apple.quarantine "$1" >/dev/null 2>&1 && echo "$1"' _ {} \;

Перетаскивание файла в окно Терминала подставляет правильный путь вместе с экранированием, что исключает опечатки.

#Когда это помогает и когда нет

Для проверки целостности скачанного файла сравнивайте хеш с опубликованным на сайте разработчика: shasum -a 256 ~/Downloads/файл.dmg. Совпадение значений доказывает, что файл не повреждён при загрузке.

Так эту ошибку тоже называют

Источники и обновления

Последнее обновление статьи: 2 ноября 2026. Версии программ и интерфейсы меняются — если шаги не совпадают с вашей версией, сверяйтесь с документацией производителя.