Happ VPN
Тарифы

Настройка Happ на macOS

Автор
Дмитрий Соколов, ведущий технический автор
Проверил:
Артём Волков
Проверено:
Опубликовано:
Версия гайда:
1.0

Коротко

Чтобы настроить Happ на macOS, скопируйте ключ или ссылку на подписку, нажмите «+» и импортируйте её из буфера обмена, выберите сервер и подключитесь. При первом подключении macOS попросит разрешение, его нужно подтвердить.

Порядок настройки одинаков для обеих сборок: импорт через «+», выбор сервера, подключение, проверка пинга. Различается то, как macOS пускает приложение в сеть. Версии из App Store система разрешает создать VPN-конфигурацию, а DMG-сборка на Qt 6 работает в режиме TUN или как системный прокси. На macOS 15 и новее для раздачи по локальной сети дополнительно понадобится разрешение на доступ к локальной сети.

Перед настройкой

Настройка Happ на macOS зависит от сборки. Версия из App Store работает через VPN-конфигурацию macOS, DMG-сборка на Qt 6 предлагает режим TUN и системный прокси.

Сам импорт одинаков: кнопка «+» вверху справа, затем буфер обмена, диплинк или «Ручной ввод». Серверы появятся в «Список серверов».

Перед началом получите ключ или подписку у провайдера либо подготовьте конфигурацию своего сервера. Happ сам серверов не предоставляет.

Пошаговая настройка

  1. Откройте Happ и дайте системные разрешения

    Запустите Happ из папки «Программы» или Launchpad. Если macOS спросит разрешение на уведомления или доступ к сети, ответьте по ситуации: для подключения важны разрешения, связанные с VPN и сетью.

    Результат: Открывается главное окно без серверов.

  2. Скопируйте ключ или подписку

    Скопируйте строку сочетанием Cmd+C: ключ vless://, vmess://, trojan://, ss://, socks://, hysteria2:// или hy2://, адрес обычной подписки или зашифрованную ссылку happ://crypt.

    Результат: Строка целиком в буфере обмена.

  3. Импортируйте через «+»

    Нажмите «+» вверху справа и выберите вставку из буфера обмена. Ссылка-диплинк от провайдера откроет Happ сама. Для своего сервера подойдёт «Ручной ввод»: выберите протокол, заполните поля и нажмите «Готово».

    Результат: Серверы появились в «Список серверов», у подписки видно её название.

  4. Выберите сервер и подключитесь

    Выберите сервер и нажмите кнопку подключения. В версии из App Store подтвердите добавление VPN-конфигурации паролем или Touch ID. В DMG выберите режим TUN или системный прокси и подтвердите запрос прав, если macOS его покажет.

    Результат: Статус в окне Happ меняется на подключено, сайты открываются через выбранный сервер.

  5. Проверьте задержку

    Нажмите иконку спидометра в шапке подписки, чтобы измерить все серверы. Для проверки через сам прокси подходит способ Via Proxy HEAD, ICMP требует временно отключить туннель. Затем выполните «Проверить текущее соединение».

    Результат: Видна задержка в мс или зелёная иконка состояния, в зависимости от настройки «Настройки» → Ping.

  6. Настройте маршрутизацию и LAN при необходимости

    Для раздельного туннелирования импортируйте профиль ссылкой happ://routing/onadd/ или соберите его в routing.happ.su. Для раздачи на другие устройства включите «Разрешить LAN-подключения» в «Расширенные настройки».

    Результат: Профиль активен, при включённом LAN видны IP Mac и порты SOCKS5 и HTTP.

Режимы подключения

VPN-конфигурация macOS (версия из App Store)
Приложение из App Store создаёт туннель через системный механизм VPN macOS. Подключение видно в разделе VPN системных настроек, трафик приложений идёт через туннель по правилам маршрутизации подписки.
TUN (DMG)
Десктопная сборка создаёт виртуальный сетевой интерфейс и направляет в него трафик всех программ, включая Терминал. В пререлизе 4.4.6 режимом TUN по умолчанию стал Xray TUN.
Системный прокси (DMG)
Happ прописывает локальный прокси в сетевых настройках macOS. Его используют браузеры и приложения с системным сетевым стеком. В пререлизе 4.4.6 появилась настройка исключений системного прокси.

Что поддерживает Happ на macOS

ВозможностьПоддержка
TUN-режим (весь трафик устройства)Да
Системный проксиДа
Прокси для отдельных приложенийНет данных
Раздача подключения по локальной сетиДа
МаршрутизацияПрофили маршрутизации

Советы

Если после отключения Happ в браузере не открываются сайты, проверьте «Системные настройки» → «Сеть» → Wi-Fi → «Подробнее» → «Прокси». Там не должно остаться включённых прокси от завершённого сеанса.

Не запускайте одновременно версию из App Store и DMG. Два туннеля на одном Mac конфликтуют за маршруты и DNS.

Встроенный брандмауэр macOS может спросить, разрешить ли Happ принимать входящие подключения. Для LAN-раздачи ответьте «Разрешить», иначе другие устройства не подключатся.

Для корпоративных ресурсов держите их домены в DirectSites или ProxySites в зависимости от того, где они доступны. Так рабочие системы не будут зависеть от выбранного сервера.

Связанные инструкции

Главное

  • Импорт ключа и подписки в Happ на Mac выполняется кнопкой «+», из буфера обмена или по диплинку.
  • При первом подключении macOS запрашивает разрешение, без него туннель не поднимется.
  • DMG-сборка поддерживает режим TUN и системный прокси, как версии для Windows и Linux.
  • В релизе 4.3.0 исправлена потеря туннеля после выхода Mac из сна.
  • Для раздачи по LAN на macOS 15 и новее проверьте разрешение Happ на доступ к локальной сети.

Частые вопросы

macOS просит разрешить добавление конфигурации VPN. Это нормально?

Да. Приложения для Mac, которые создают туннель через системный механизм Apple, при первом подключении просят разрешение на добавление VPN-конфигурации и подтверждение паролем или Touch ID. Конфигурация хранится в разделе VPN системных настроек. Если нажать «Не разрешать», подключиться не получится, пока вы не повторите попытку и не согласитесь.

Почему после сна Mac Happ не восстанавливает соединение?

В десктопной сборке эта проблема исправлена в релизе 4.3.0: туннель больше не теряется после сна на macOS и Linux. Проверьте версию и при необходимости обновите DMG. Если соединение всё равно пропало, отключитесь и подключитесь снова: после смены сети или сна Xray-core заново устанавливает соединение с сервером.

Как в Happ на Mac исключить сайт из прокси?

Добавьте домен в DirectSites или адрес в DirectIp активного профиля маршрутизации. Профиль можно импортировать ссылкой happ://routing/add/ или собрать в генераторе routing.happ.su. В DMG-сборке пререлиза 4.4.6 есть ещё настройка исключений системного прокси. Изменения маршрутизации применяются при следующем подключении к серверу.

Как раздать подключение с Mac на другие устройства?

Откройте «Настройки» → «Расширенные настройки» и включите «Разрешить LAN-подключения», затем подключитесь к серверу. Happ покажет IP Mac и порты SOCKS5 и HTTP. На macOS 15 и новее система может спросить разрешение на доступ к локальной сети: его статус виден в «Конфиденциальность и безопасность» → «Локальная сеть».

Почему браузер работает, а Терминал идёт мимо прокси?

Системный прокси macOS учитывают Safari, Chrome и большинство приложений с системным сетевым стеком, но не консольные утилиты вроде curl и git. Им нужны переменные окружения http_proxy и https_proxy или режим TUN. Переключите DMG-сборку в TUN, и трафик Терминала пойдёт через туннель вместе с остальным.

Можно ли перенести подписки из Happ на iPhone в Happ на Mac?

Если подписка не зашифрована и не скрыта, откройте её сервер в Happ на iPhone, смахните вправо и нажмите иконку со стрелкой: доступны «В буфер обмена», «QR-код» и «JSON». Скопированную ссылку передайте на Mac, например через универсальный буфер обмена, и импортируйте кнопкой «+». Зашифрованную подписку проще добавить заново исходной ссылкой.

Упомянутые темы

Похожие материалы

Разделы по теме

Источники

  1. Системные требования Happ — обращение 27 сентября 2026
  2. Документация Happ: таблица загрузок — обращение 27 сентября 2026
  3. Happ - Proxy Utility в App Store — обращение 27 сентября 2026
  4. Релизы happ-desktop на GitHub — обращение 27 сентября 2026
  5. Добавление конфигурации и подписки — обращение 27 сентября 2026
  6. Пинг в Happ — обращение 27 сентября 2026
  7. Подключения по локальной сети — обращение 27 сентября 2026
  8. Маршрутизация в Happ — обращение 27 сентября 2026