ru Installation

Установка

Нужна macOS 14 или новее на Apple Silicon или Intel. Для Apple Silicon выберите обычный DMG, для Intel — Intel DMG (-intel.dmg). Для безопасной песочницы нужны Apple Silicon и macOS 26 или новее. Liquid Glass и Пункт управления требуют macOS 26; в macOS 14/15 используются стандартные элементы. Подсказки доменов Apple Intelligence требуют macOS 26 и доступную локальную модель; индексирование серверов в Spotlight требует macOS 15.

Требования

• macOS 14 или новее
• Apple Silicon или Intel.

Homebrew (рекомендуется)

brew install --cask v2macapp/tap/v2mac

Homebrew обходит предупреждение Gatekeeper. Дальше V2Mac обновляется сама, даже если установлена через Homebrew (см. Обновление).

Ручная загрузка

1. Скачайте V2Mac-<version>.dmg из последнего релиза. К каждому релизу приложен файл .sha256 для проверки.
2. Откройте DMG и перетащите V2Mac в Applications.
3. Приложение не нотаризовано, поэтому macOS блокирует первый запуск. Откройте его один раз, затем нажмите Всё равно открыть в Системные настройки → Конфиденциальность и безопасность, или выполните:

   xattr -dr com.apple.quarantine /Applications/V2Mac.app

Проверка загрузки

V2Mac пока не нотаризован, поэтому macOS не может поручиться за DMG. Что можно проверить самому:

shasum -a 256 ~/Downloads/V2Mac-<version>.dmg

• Сравните результат с файлом .sha256 из релиза и с sha256 в cask Homebrew. Совпадение показывает, что файл не повредили и не подменили по дороге. Оба значения берутся из одного релиза, поэтому подлинность самого релиза это не доказывает.
• После установки codesign --verify --deep --strict /Applications/V2Mac.app проверяет, что в приложении ничего не меняли после сборки.
• Обновления внутри приложения надёжнее: каждое подписано ключом обновлений V2Mac, и приложение отклоняет неподписанные.

Первое подключение

1. Нажмите Add Subscription (⌘N) и вставьте адрес подписки или одну ссылку vless://, vmess://, trojan://, ss://, hy2://.
2. Дважды щёлкните сервер (или выберите и нажмите Return).
3. Укажите в приложениях socks5://127.0.0.1:10808 или http://127.0.0.1:10808, либо включите System Proxy или TUN.

V2Mac живёт в строке меню. Закрытие окна не останавливает прокси; чтобы остановить, выйдите через ⌘Q.

При первом запуске V2Mac попросит разрешение на уведомления. См. Строка меню и быстрые команды.

Обновление

• Приложение: V2Mac раз в день проверяет GitHub и сама устанавливает новые версии. В фоне загружаются только изменившиеся файлы (часто меньше 1 МБ), а обновление устанавливается при выходе из приложения. Пока обновление ждёт, на значке в строке меню видна маленькая точка, а панель и Settings → General показывают Restart Now, чтобы установить его сразу (VPN прервётся на несколько секунд). Кольцо на значке означает, что новая версия найдена, но ещё не загружена. После обновления придёт уведомление «V2Mac обновлена до …».
• Чтобы решать самим, выключите Install updates automatically в Settings → General: тогда V2Mac только показывает Update Now. Check for app updates полностью отключает проверку.
• Перед установкой каждое обновление сверяется с подписью проекта.
• Ядро Xray: Settings → Core → Check for Update. Загрузка сверяется по SHA-256 и проверяется перед заменой. Revert to Bundled возвращает ядро из комплекта приложения.

Удаление

1. Выйдите из V2Mac (⌘Q). Это выключит TUN, системный прокси и kill switch.
2. Если вы включали привилегированный помощник, удалите его: Settings → General → Privileged helper → Remove Helper.
3. Удалите /Applications/V2Mac.app (или brew uninstall --cask v2mac).
4. Чтобы удалить данные: ~/Library/Application Support/v2mac.