Что такое com.apple.quarantine и кто его устанавливает
Файлы на Mac могут нести расширенные атрибуты: небольшие фрагменты метаданных, которые хранятся вместе с файлом, но отдельно от его содержимого, имени и дат. Справочная страница xattr описывает их как "arbitrary metadata stored with a file" (произвольные метаданные, хранящиеся вместе с файлом). Там хранятся теги Finder, исходный URL загрузки и флаг карантина.
Впервые их обычно замечают в Терминале. ls -l показывает @ после строки прав доступа (например, -rw-r--r--@), если у файла есть расширенные атрибуты, а ls -l@ перечисляет под ней их имена, например com.apple.quarantine, с размером в байтах.
Атрибут карантина записывает приложение, которое сохраняет файл, а не сам файл. Приложения включают это сами, и браузеры с мессенджерами так и делают. На Mac, использованном для этой статьи, Safari, Google Chrome, Brave и WhatsApp объявляют в своём Info.plist ключ LSFileQuarantineEnabled, который велит macOS помечать всё, что они сохраняют. Почта, Сообщения и AirDrop тоже помечают входящие файлы, а Утилита архивирования передаёт атрибут файлам, которые распаковывает из архива, помещённого в карантин.
Не менее полезно знать, что атрибут не получает. Файлы, которые Вы создали сами, файлы, скопированные с другого Вашего диска, и файлы, загруженные инструментами командной строки вроде curl, приходят без него, потому что эти инструменты не просят macOS помещать в карантин то, что они записывают. Поэтому скрипт, загруженный через curl, запускается без запроса Gatekeeper, а тот же файл из Safari вызывает такой запрос.
Название иногда наводит на неверную мысль. Файл в карантине не изолирован, не зашифрован и не перемещён. Как документ он работает как обычно. Атрибут имеет значение только тогда, когда macOS просят что-то из этого файла запустить, и здесь в дело вступает Gatekeeper.
Как прочитать атрибут и что означают поля
Три команды покрывают всё:
xattr fileвыводит имена всех расширенных атрибутов файла.xattr -l fileвыводит имена вместе со значениями.xattr -p com.apple.quarantine fileвыводит только значение карантина.
Типичное значение для загрузки из Safari выглядит так (пример вымышленный, но структура настоящая): 0083;6750a1b2;Safari;1F2E3D4C-5B6A-4789-9ABC-0D1E2F3A4B5C.
Четыре поля разделены точкой с запятой:
- Флаги (
0083): шестнадцатеричное число. macOS со временем его меняет. На Mac, использованном для этой статьи, свежие загрузки в папке «Загрузки» имели значения вроде0082,0083и0086, а приложения в папке «Программы», которые уже открывались и были одобрены, показывали значения вроде01c3. После одобрения атрибут остаётся. Флаги фиксируют, что проверка состоялась. - Отметка времени (
6750a1b2): время загрузки в секундах с 1 января 1970 года в шестнадцатеричной записи. В zsh командаdate -r $((16#6750a1b2))превращает его в читаемую дату. - Агент (
Safari): имя приложения, которое сохранило файл. Часто это самый быстрый способ ответить на вопрос «откуда взялся этот файл?» - Идентификатор события: UUID, который связывает файл с записью в базе истории загрузок, описанной в последнем разделе. Поле может быть пустым: на тестовом Mac у файлов, сохранённых Microsoft PowerPoint и почтовым клиентом, четвёртое поле было пустым.
Для приложений смотрите на пакет .app верхнего уровня. Именно там Gatekeeper читает атрибут, и именно этот путь Вы передали бы xattr.
Что его читает: Gatekeeper, нотаризация и XProtect
Когда Вы впервые открываете приложение, помещённое в карантин, macOS выполняет ряд проверок до того, как запустится хоть какой-то код приложения. Спусковым крючком служит атрибут карантина. Без него большинство этих проверок при первом запуске пропускается.
Gatekeeper проверяет подпись кода: подписано ли приложение действительным Developer ID и изменялось ли оно после подписания? Нотаризация добавляет собственную проверку Apple: разработчики, которые распространяют приложения вне Mac App Store, загружают их в Apple, а Gatekeeper проверяет, выдала ли Apple для приложения билет нотаризации. XProtect, встроенный в macOS сканер вредоносного ПО по сигнатурам, в тот же момент сверяет приложение с известными вредоносными программами.
Ту же оценку можно выполнить самостоятельно, не открывая приложение: spctl -a -vv /Applications/SomeApp.app. Для обычного загруженного приложения результат содержит accepted, source=Notarized Developer ID и строку origin с именем сертификата разработчика.
Диалог, который появляется при неудачной проверке, говорит, какая именно проверка не прошла. В русской локализации macOS эти сообщения звучат так:
- «Приложение „…“ повреждено, и его не удается открыть.» Несмотря на формулировку, обычно это означает, что подпись кода повреждена или отсутствует. В собственных строковых файлах Apple это сообщение стоит под ключом для неверной подписи, а не для повреждённой загрузки.
- «Apple не удалось подтвердить, что файл „…“ не содержит вредоносного ПО, которое может нанести вред Вашему Mac или конфиденциальности Ваших данных.» Приложение подписано, но не нотаризовано, или Gatekeeper не смог подтвердить билет.
- «Автор приложения „…“ не является подтвержденным разработчиком.» Приложение не подписано Developer ID, который признаёт Apple.
- «Приложение „…“ не было открыто, так как оно содержит вредоносное ПО.» XProtect нашёл совпадение с известной сигнатурой. Не пытайтесь это обойти.
Полная проверка первого запуска не повторяется при каждом следующем запуске. Эти проверки стоят у входной двери, поэтому удаление атрибута так важно: оно убирает саму дверь.
Как безопасно удалить атрибут и чего не делать
Начните со способа, который предлагает Apple. Попробуйте один раз открыть приложение и закройте диалог кнопкой Готово. Затем откройте Системные настройки, перейдите в раздел «Конфиденциальность и безопасность» и прокрутите до блока «Безопасность». macOS показывает там строку о том, что приложение заблокировано для защиты Вашего Mac, а рядом кнопку Все равно открыть. Нажмите её, подтвердите паролем, и приложение откроется. Начиная с macOS 15 Sequoia старый приём, когда по приложению щёлкали с нажатой клавишей Control и выбирали «Открыть», больше не позволяет пропустить этот шаг.
При таком способе Gatekeeper остаётся в процессе. Решение принимаете Вы, macOS его записывает, а приложение по-прежнему проверяется XProtect.
Путь через Терминал нужен в случаях, когда «Все равно открыть» не предлагается, обычно при сообщении о «повреждённом» приложении у проекта с открытым исходным кодом или любительской разработки, которая поставляется без подписи Developer ID. Если Вы доверяете источнику, удалите атрибут у этого одного приложения:
xattr -d com.apple.quarantine /Applications/SomeApp.app
Если приложение по-прежнему не запускается, некоторые руководства добавляют -r, чтобы применить изменение ко всем файлам внутри пакета. Ограничьтесь этим одним пакетом приложения. Прежде чем делать то или другое, убедитесь, что загрузка действительно получена от разработчика, в идеале сравнив контрольную сумму, опубликованную на собственном сайте проекта или на странице релиза.
Трёх вещей стоит избегать:
- Запуск
xattr -r -d com.apple.quarantineдля целой папки, например «Загрузки» или Вашей домашней папки. Это снимает проверку первого запуска со всех файлов в ней, включая те, о которых Вы забыли или которые никогда не открывали. xattr -c, который удаляет все расширенные атрибуты, а не только карантин. Это грубый инструмент для точной работы.- Отключение Gatekeeper командой
sudo spctl --global-disable. Согласно справочной странице, это открывает в разделе «Конфиденциальность и безопасность» вариант «Любых источников», а сама macOS предупреждает, что разрешение приложений из любых источников снижает безопасность Mac. Выбрав его, Вы отключаете проверку для всего, что загрузите с этого момента, ради решения проблемы с одним приложением.
Журнал загрузок за UUID и то, чего карантин не проверяет
Четвёртое поле указывает на базу данных, о которой большинство людей никогда не слышали: ~/Library/Preferences/com.apple.LaunchServices.QuarantineEventsV2. Это файл SQLite, и он есть на любом Mac, на который хоть что-то загружали. В его таблице есть столбцы для приложения, загрузившего файл, URL данных, исходной страницы и, для вложений почты, имени и адреса отправителя. Иными словами, это история загрузок, которую macOS ведёт отдельно от Вашего браузера. Она не относится к настройкам истории браузера, поэтому очистка истории в браузере не является надёжным способом её опустошить. Если Вы делите Mac с другими людьми или Вам важна эта запись, полезно знать, что она существует. Удаление атрибутов карантина с файлов тоже не удаляет их записи.
Второе ограничение связано со временем. Карантин, Gatekeeper, нотаризация и XProtect смотрят на приложение до его первого запуска. Когда приложение уже работает, ни один из них не следит за тем, что оно делает в сети. Правильно подписанное и нотаризованное приложение всё равно может отправлять аналитику, обращаться к рекламным сетям или связываться со своим сервером каждые несколько минут, и система карантина ничего Вам об этом не скажет.
Этот пробел и закрывает NetMute. Он не трогает ни Gatekeeper, ни атрибуты карантина, ни решение «Все равно открыть». Он показывает каждое приложение и системный процесс с сетевым трафиком в реальном времени и доменами, к которым обращался каждый из них, поэтому Вы можете впервые открыть только что загруженное приложение и сразу увидеть, с кем оно связывается. Если ответ окажется неожиданным, один переключатель отключит это приложение от сети, пока Вы решаете, оставлять ли его.

