Happ на Mac: как установить на MacBook и iMac, подключить подписку и включить режим TUN

Happ на Mac — бесплатная программа на ядре Xray, та же, что на Windows и Linux. Своих серверов в ней нет: они приходят в подписке от вашего сервиса. На Mac у Happ есть одна особенность, о которой стоит знать сразу: два режима работы, и для полноценного VPN нужен режим TUN.

Какой Happ ставить на Mac

Дальше — про образ .dmg: он подходит большинству и не требует менять регион аккаунта Apple.

Как установить Happ на Mac

1. Скачайте образ: Happ для Mac (.dmg). Это официальная сборка Happ, она лежит на нашем сервере и скачивается без VPN.
2. Откройте образ и перетащите Happ в папку «Applications» («Программы»). Если Happ уже стоял — «Заменить».
3. Запустите Happ из «Программ» или через ⌘ Command + Пробел. macOS предупредит, что программа загружена из интернета, — «Открыть».

Если macOS не открывает Happ и кнопки «Открыть» нет: «Системные настройки» → «Конфиденциальность и безопасность» → внизу, в разделе безопасности, — «Всё равно открыть», затем пароль от Mac. Apple пишет, что эта кнопка доступна около часа после попытки открыть программу.

Как добавить подписку

Кнопкой сервиса. Нажмите кнопку добавления в Happ на сайте или в боте сервиса на этом же Mac. Браузер спросит «Открыть приложение “Happ”?» — «Открыть приложение “Happ”»; если macOS ещё раз спросит про программу из интернета — «Открыть». Подписка появится в «Серверах» сама.

Через буфер обмена: скопируйте ссылку-подписку, в Happ нажмите «+» вверху справа → «Добавить из буфера обмена» (на пустом экране — кнопка «Из буфера»). Подписка появится в списке — выберите её.

Как включить VPN: режим TUN

1. Вверху справа переключите режим с «Прокси» на «TUN» → «Xray TUN».
2. Нажмите большую кнопку включения. macOS попросит разрешить добавление конфигурации VPN — «Разрешить» и пароль от Mac.
3. На кнопке — «Подключён» и таймер. Готово.

Зачем переключать на TUN

В режиме «Прокси» Happ включает в macOS системный прокси, и через VPN идут только программы, которые его слушают: браузеры — да, а часть программ, например многие игры и программы из терминала, идёт мимо. В режиме «TUN» Happ создаёт виртуальный сетевой интерфейс, и через VPN идёт весь Mac. Отсюда и пароль: Happ ставит фоновую службу и добавляет конфигурацию VPN, а на такое macOS всегда спрашивает пароль администратора — с версии 4.0.5 Happ просит его одним подтверждением.

Внутри TUN можно выбрать «провайдера» — Xray TUN, sing-box, tun2proxy или Happ TUN. Основной вариант с версии 4.2.1 — Xray TUN, его и оставьте, если ваш сервис не советует другой. Сервис может прислать режим и в подписке — тогда Happ выставит его сам.

Happ на макбуке не работает: частые случаи

После сна VPN не работает или Happ снова просит пароль

Это известные ошибки, которые разработчик чинил в нескольких версиях подряд: восстановление туннеля после сна на macOS, лишние запросы пароля после пробуждения, Xray TUN, когда Mac подключён одновременно по кабелю и по Wi-Fi. Поставьте свежий .dmg поверх старого («Заменить»). А пока — выключите и включите VPN, затем Wi-Fi; не помогло — закройте крышку на минуту и откройте снова: при пробуждении Mac пересоздаёт сетевые подключения. Подробнее — Mac: VPN включён, но ничего не грузится.

Happ не запускается или завис

Закройте Happ (⌘ Command + Q) и перезагрузите Mac. Не помогло — удалите Happ из «Программ» и поставьте заново из образа. Если Happ пишет «Служба Happ Client недоступна» — переустановка как раз и нужна: так советует само сообщение. Другие сообщения на компьютере — Happ на компьютере не запускается или не обновляет подписку.

VPN включён, а зарубежные сайты не открываются

• Режим «Прокси». Проверьте переключатель вверху справа — должен быть «TUN».
• Другой VPN. «Системные настройки» → «VPN»: старые VPN — например, «Karing (system)» — выключите и удалите. Два VPN одновременно мешают друг другу.
• Файрвол или антивирус. Little Snitch, LuLu, Kaspersky и Dr.Web для Mac — разрешите Happ все соединения или добавьте его в исключения: Антивирус мешает VPN: добавьте sing-box и Happ в исключения.
• Wi-Fi с фильтрацией — в гостинице, офисе, у некоторых провайдеров. Сеть подменяет адреса зарубежных сайтов. «Системные настройки» → «Wi-Fi» → у вашей сети «Подробнее…» → вкладка «DNS» → «+» → впишите 1.1.1.1 → «ОК» и перезапустите браузер.

Не обновляется подписка, ошибки ядра и туннеля

Выключите VPN, нажмите ⟳ у подписки — должна появиться зелёная галочка — и включите VPN снова. Что значат «Ошибка запуска ядра», «Ошибка: не удалось запустить туннель», «Ошибка Geo файлов» и тайм-ауты — Ошибки Happ: что значат и что делать. Общий порядок проверки — Happ не работает или не обновляет подписку.

Как отправить лог

1. Happ → «Настройки» → «Логи» → «Уровень логирования» → Debug.
2. Выключите и включите VPN и повторите то, что не работало.
3. Слева откройте «Логи» и нажмите ⌘ Command + R — в подсказке написано Ctrl+R, на Mac это ⌘R.
4. Появится «Диагностический отчёт записан в: …/Desktop/report.zip». Пришлите этот файл с рабочего стола в поддержку своего сервиса.

Если подписка от Демьяныча

У Демьяныча на Mac основное приложение — sing-box, на Mac он называется SFM: Подключить Mac. Ему нужно разрешить системное расширение, и иногда это не получается с первого раза — тогда выручает Happ: ему системное расширение не нужно. Подписка для обоих одна.

Подписку в Happ добавляет кнопка «＋ Добавить подписку» в кабинете lk.demyan.pro (блок «Установка» → macOS → Happ) — откройте его на этом же Mac. Режим — «TUN» → «Xray TUN», как выше. Логи присылайте в @demyan_support: Как отправить логи. Ещё не с нами — Демьяныча можно попробовать 3 дня бесплатно, без карты: Как это работает: включил и забыл.

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

Источники

• Happ — системные требования
• Happ — официальные версии для всех устройств
• Happ — управление приложением: режимы Proxy и TUN, выбор ядра туннеля
• Happ для компьютера — примечания к версиям на GitHub
• Apple — открытие приложения от неизвестного разработчика на Mac