Happ на Mac

Happ на Mac OS бывает в двух вариантах: версия из App Store для macOS 15 и новее, перенесённая с iPhone по технологии Catalyst, и универсальный файл DMG из официального репозитория Happ-proxy на GitHub для macOS 13 и новее, который работает и на процессорах Intel, и на Apple Silicon. Если у вас свежая система и App Store доступен, удобнее версия из магазина — она обновляется сама; если магазин недоступен, что бывает в российском регионе, или система старше 15-й версии, берите DMG. Само приложение бесплатное и своих серверов не имеет, поэтому после установки нужно добавить подписку или ключ от вашего сервиса. Ниже — какие версии есть для Mac, как выбрать, установка из App Store и из DMG, предупреждение при первом запуске, разрешения системы, добавление подписки, подключение, режимы работы, маршрутизация, раздача подключения по сети, старые Mac, обновление, удаление и решение частых проблем.

Какие версии есть для Mac

Две версии

По официальной документации, для Mac есть версия из App Store и версия в виде DMG. Версия из App Store написана на родном для Apple языке и перенесена с iPhone по технологии Catalyst. Версия DMG построена на кроссплатформенном фреймворке Qt 6, как версии для Windows и Linux. Функции у них близкие. Но выглядят и устанавливаются они по-разному.

Требования

Версия из App Store работает на macOS 15 и новее. Версия DMG — на macOS 13 и новее. Обе поддерживают Mac на процессорах Apple Silicon, а DMG — универсальный и для Intel. Проверьте версию системы в меню «Об этом Mac». От неё зависит выбор.

Бесплатно

Обе версии бесплатные. За приложение не нужно платить ни в магазине, ни на GitHub. Платной «версии для Mac» не существует. Если кто-то продаёт Happ для Mac, это обман. Скачивайте только из официальных источников.

Какую выбрать

App Store

Выбирайте версию из App Store, если у вас macOS 15 или новее и приложение доступно в вашем регионе. Она обновляется автоматически через магазин. Интерфейс похож на iPhone. Это удобно, если вы уже пользуетесь Happ на телефоне. Установка занимает минуту.

DMG

Выбирайте DMG, если система старше macOS 15 или App Store недоступен. В российском App Store Happ несколько раз удаляли по требованию Роскомнадзора, а DMG от магазина не зависит. Он лежит на GitHub разработчиков. Обновлять его придётся вручную. Но работает он стабильно.

Можно ли обе

Технически можно установить обе версии, но смысла в этом мало: функции близкие, а одновременно работать может только одно подключение. Каждая установка может занять место в лимите устройств провайдера. Лучше выбрать одну. Так меньше путаницы. Подписку переносить не придётся.

Установка из App Store

Открыть страницу

Откройте ссылку на App Store с официального сайта Happ или из описания репозитория на GitHub. Так вы попадёте на настоящую страницу приложения. Проверьте разработчика и описание. В магазине встречаются клоны с похожими названиями. Ставьте только оригинал.

Загрузить

Нажмите «Загрузить» и подтвердите паролем Apple ID или Touch ID. Приложение установится в папку «Программы». Оно появится в Launchpad. Запустите его. Список серверов будет пустым.

Если недоступно

Если App Store пишет, что приложение недоступно в вашем регионе, используйте DMG с GitHub. Он работает на macOS 13 и новее. Менять регион Apple ID ради этого не нужно. DMG — официальная сборка разработчиков. Подробнее — ниже.

Установка DMG

Где скачать

Файл Happ.macOS.universal.dmg лежит в релизах репозитория happ-desktop организации Happ-proxy на GitHub. Ссылка latest/download ведёт на последнюю версию. Ссылка есть и на официальном сайте. Подробнее о GitHub — в статье про Happ на GitHub. Не скачивайте DMG со сторонних сайтов.

Установка

Откройте скачанный DMG двойным щелчком. Появится окно с иконкой Happ и папкой «Программы». Перетащите иконку Happ в папку «Программы». Дождитесь копирования. Затем извлеките образ диска.

Запуск

Откройте папку «Программы» и запустите Happ. При первом запуске macOS может показать предупреждение. О нём — в следующем разделе. После запуска список серверов будет пустым. Добавьте подписку.

Предупреждение при первом запуске

Gatekeeper

При первом запуске программ не из App Store macOS проверяет их системой Gatekeeper и может показать предупреждение. Это стандартная защита. Для файла из официального репозитория Happ-proxy запуск безопасен. Если система спрашивает, открыть ли приложение, подтвердите. Для файлов из других источников так делать не стоит.

Если не открывается

Если macOS не даёт открыть приложение, откройте «Системные настройки» → «Конфиденциальность и безопасность». Там может быть сообщение о заблокированной программе с кнопкой «Всё равно открыть». Нажмите её для Happ из официального источника. Подтвердите паролем. После этого приложение запустится.

Проверка источника

Прежде чем подтверждать запуск, убедитесь, что DMG скачан с github.com/Happ-proxy или по ссылке с официального сайта. Если файл получен из чата или со стороннего сайта, не открывайте его. Удалите и скачайте заново. Gatekeeper защищает от подделок. Не отключайте его без причины.

Разрешения системы

Сетевые настройки

Чтобы направлять трафик через прокси, приложению нужны разрешения на изменение сетевых настроек или добавление VPN-конфигурации. macOS может спросить пароль администратора. Это нормально для прокси-клиентов. Разрешите, если приложение из официального источника. Без этого подключение может не работать.

Версия из App Store

Версия из App Store, как и на iPhone, добавляет VPN-конфигурацию при первом подключении. macOS покажет запрос — нажмите «Разрешить». Конфигурацию можно увидеть в системных настройках сети. Удалять её не нужно. Иначе подключение перестанет работать.

Брандмауэр

Если на Mac включён брандмауэр, система может спросить, разрешить ли Happ входящие соединения. Это особенно актуально для функции раздачи по локальной сети. Разрешите для частных сетей. Без разрешения раздача может не работать. Для обычного подключения это обычно не требуется.

Добавление подписки

Из буфера обмена

Скопируйте ссылку подписки из кабинета или бота сервиса. В Happ нажмите кнопку добавления и выберите вставку из буфера обмена. Подписка появится в списке отдельной группой. Если буфер пуст, появится ошибка «Буфер обмена пуст». Скопируйте ссылку заново.

Где взять подписку

Подписку или ключ выдаёт сервис, который продаёт доступ к серверам. Например, ключи для Happ можно получить в VPNType — ссылка приходит сразу после оформления. Разработчики Happ подписок не продают. Учтите лимит устройств: Mac займёт отдельное место. Основы работы с приложением — в статье о том, как пользоваться Happ.

С iPhone

Если подписка уже есть на iPhone, её ссылку можно взять в кабинете сервиса и добавить на Mac. Если подписка не зашифрована, сервером можно поделиться через QR-код или буфер: свайп по серверу, иконка со стрелкой. Из зашифрованных подписок делиться нельзя. Тогда возьмите ссылку у провайдера.

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

Выбор сервера

Проверьте пинг: нажмите иконку спидометра в шапке подписки. Рядом с серверами появится задержка в миллисекундах. Серверы с «Тайм-аутом» недоступны. Выберите быстрый сервер. Нажмите подключение.

Проверка соединения

Нажмите «Проверить текущее соединение» — приложение покажет задержку через активное подключение. Если сервер недоступен, появится «Тайм-аут». Откройте сайты в браузере. Если не открываются, выберите другой сервер. Подробная инструкция — в статье о том, как подключить Happ.

Отключение

Отключиться можно той же кнопкой. Трафик снова пойдёт напрямую. Если после закрытия приложения сайты не открываются, проверьте настройки прокси в системных настройках сети. Отключите прокси, если он остался включённым. Это бывает после аварийного закрытия.

Режимы работы

Системный прокси

На компьютерах прокси-клиенты обычно работают как системный прокси: через него идут браузеры и программы, которые учитывают системные настройки. Это простой режим для большинства задач. Некоторые программы игнорируют системный прокси. Для них нужен туннель. Названия режимов зависят от версии.

Туннель

Режим туннеля перенаправляет весь трафик Mac через подключение, включая программы, не понимающие системный прокси. Обычно для него нужны дополнительные разрешения. Включайте его, если обычный режим не помогает конкретной программе. Подробнее — в статье о режиме TUN. Без необходимости не включайте.

Версия из App Store

Версия из App Store работает через VPN-конфигурацию, как на iPhone, и направляет трафик всей системы. Режимов там меньше, но и настраивать почти ничего не нужно. Это удобно для простого использования. Для тонкой настройки удобнее DMG. Выбирайте под задачи.

Маршрутизация на Mac

Зачем

Маршрутизация позволяет пускать российские сайты и банки напрямую, а остальное — через сервер. На Mac это удобно, чтобы не отключаться ради банка или госуслуг. Правила часто приходят вместе с подпиской от провайдера. У каждой подписки свои правила. Если правил нет, всё идёт через сервер.

Добавление правил

Правила можно добавить ссылкой с официального сайта routing.happ.su — из буфера, диплинком или по QR-коду. Изменения применяются только после переподключения. Если ничего не изменилось, отключитесь и подключитесь снова. Подробнее — в статье о маршрутизации. Меняйте правила постепенно.

Ошибки геофайлов

Профили маршрутизации используют геофайлы, которые загружаются в фоне. Если загрузка не завершилась за 3 минуты, появится сообщение об ошибке и красный восклицательный знак у профиля. Проверьте интернет и подождите. Ошибка исчезнет после успешной загрузки. Или удалите проблемный профиль.

Раздача подключения с Mac

LAN-подключения

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

Настройка второго устройства

На втором устройстве в настройках сети укажите прокси вручную: IP Mac и HTTP-порт. Сохраните. Устройство будет выходить в интернет через подключение на Mac. Это удобно для консолей и телевизоров без Happ. Mac должен оставаться включённым.

Ограничения

Если выключить функцию или отключить Happ, другие устройства потеряют доступ. Включайте раздачу только в домашней сети. Учтите правила провайдера о раздаче доступа. После использования функцию можно выключить. Это безопаснее.

Старые Mac

Ниже macOS 13

На Mac с системой старше macOS 13 современный DMG не запустится: фреймворк Qt 6 требует новых версий системы. Версия из App Store требует ещё более новую систему. Для старых систем разработчики оставили Legacy-версию 1.0.2. Она лежит в релизах GitHub под тегом 1.0.2. Ссылка на неё есть в разделе системных требований.

Ограничения Legacy

Legacy-версия не получает новых функций и может не поддерживать новые форматы подписок, например зашифрованные ссылки нового типа. Если подписка не добавляется, причина может быть в этом. Попросите у провайдера обычную ссылку. Или обновите систему, если Mac позволяет. Это лучший вариант.

Обновление системы

Проверьте, можно ли обновить macOS на вашем Mac: «Системные настройки» → «Основные» → «Обновление ПО». Новые версии системы дают доступ к свежим версиям Happ. И к обновлениям безопасности. Если Mac не поддерживает новые версии, используйте Legacy. Или другое устройство.

Обновление

Из App Store

Версия из App Store обновляется автоматически, если включены автообновления. Можно обновить вручную на странице приложения в магазине. Подписки сохраняются. Если приложение удалили из российского магазина, обновления перестанут приходить. Тогда переходите на DMG.

DMG

Для DMG следите за релизами на GitHub. Скачайте новый DMG и перетащите приложение в «Программы», заменив старое. Подписки обычно сохраняются. На всякий случай сохраните ссылки заранее. Закройте приложение перед заменой.

Номер версии

Номер установленной версии виден в настройках приложения. Сравните его с последним релизом на GitHub. Если ваш меньше, обновитесь. Старые версии могут не поддерживать новые подписки. Это частая причина ошибок.

Удаление

Версия из App Store

Удалите приложение через Launchpad: зажмите иконку и нажмите крестик. Или перетащите приложение из «Программ» в Корзину. VPN-конфигурация может остаться в настройках сети — её можно удалить вручную. Перед удалением отключитесь от сервера. Сохраните ссылки подписок.

DMG

Перетащите Happ из папки «Программы» в Корзину и очистите её. Если после удаления сайты не открываются, проверьте системные настройки прокси и выключите прокси. Это бывает, если приложение закрыли аварийно. Перезагрузите Mac при необходимости. Интернет заработает.

Лимит устройств

После удаления место в лимите провайдера может остаться занятым. Освободите его в кабинете сервиса, если планируете ставить подписку на другое устройство. Иначе новое устройство может не добавить подписку. Это правило провайдера. Проверьте кабинет.

Частые проблемы

Не запускается

Проверьте версию macOS: DMG требует 13+, App Store — 15+. Проверьте, не заблокировал ли запуск Gatekeeper, и разрешите в настройках безопасности. Переустановите приложение из официального источника. Для старых систем используйте Legacy-версию. Подробнее о сообщениях — в статье про ошибки Happ.

Не добавляется подписка

«Url подписки не валидна» — скопируйте ссылку заново целиком. «Timeout при добавлении подписки» — сервер подписки не ответил за 9 секунд, подождите. Если подписка не добавляется на Mac, а на телефоне работает, возможно, исчерпан лимит устройств. Освободите место в кабинете. Или обновите приложение, если ссылка нового формата.

Подключено, но не работает

Проверьте пинг и выберите другой сервер. Обновите подписку и проверьте её срок. Попробуйте режим туннеля, если не работает конкретная программа. Проверьте системные настройки прокси. Если ничего не помогло, обратитесь к провайдеру.

Пример 1: App Store недоступен

Алексей хотел поставить Happ на MacBook с macOS 15, но в российском App Store приложения не оказалось. Менять регион Apple ID он не хотел.

Он скачал Happ.macOS.universal.dmg из релизов Happ-proxy на GitHub и перетащил приложение в «Программы». При первом запуске подтвердил открытие в настройках безопасности.

Алексей добавил подписку из буфера и подключился. Раз в месяц он проверяет обновления на GitHub. Магазин ему не понадобился.

Пример 2: старый iMac

У Марины был iMac с macOS 12, и современный DMG не запускался. Она решила, что Happ на её компьютере не работает.

В разделе системных требований официального сайта она нашла ссылку на Legacy-версию 1.0.2. Установила её и добавила подписку, которую оформила в VPNType.

Приложение заработало. Позже Марина собирается обновить компьютер. Тогда перейдёт на современную версию.

Итог

Версии

App Store для macOS 15+ и универсальный DMG с GitHub для macOS 13+.

Установка

Перетащить Happ в «Программы» и подтвердить запуск в настройках безопасности.

Старые Mac

Для систем старше macOS 13 — Legacy-версия 1.0.2.

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

Где скачать Happ для Mac?

В App Store или DMG из репозитория Happ-proxy на GitHub.

Работает ли Happ на Mac с Intel?

Да, DMG универсальный — для Intel и Apple Silicon.

Почему macOS не даёт открыть Happ?

Срабатывает Gatekeeper — разрешите запуск в настройках безопасности для официального файла.