Что сделать сначала после загрузки клиента
Сначала выберите сборку Happ под операционную систему вашего устройства и установите приложение. После первого запуска список серверов останется пустым, и это нормальное состояние программы.
Само приложение Happ выступает только как клиент. Адреса серверов, срок действия доступа, лимит устройств и правила оплаты определяет ваш поставщик подписки, а не разработчик утилиты.
Дальше получите у поставщика ссылку подписки, отдельный ключ или QR-код и импортируйте данные в приложение. После этого проверьте задержку до серверов и выполните пробное подключение.
Если вы уже скачали программу, но не видите доступных узлов, не переустанавливайте её сразу. Сначала проверьте импорт конфигурации и наличие сети на самом устройстве.
- Определите операционную систему и архитектуру устройства.
- Скачайте подходящую сборку Happ и завершите установку.
- Откройте приложение и убедитесь, что интерфейс запускается без ошибок.
- Подготовьте ссылку подписки, ключ или QR-код от поставщика.
- Импортируйте данные в клиент и проверьте список серверов.
Как выбрать сборку Happ под своё устройство
Happ выпускается для Windows, macOS, Linux, Android, iOS, Android TV и Apple TV. Для части платформ доступно несколько вариантов распространения: установщик, пакет, карточка в магазине приложений или тестовая сборка.
Перед загрузкой посмотрите характеристики устройства в системных настройках. На компьютере важны тип системы и архитектура процессора, а на мобильных устройствах и телевизорах — версия ОС и доступность магазина.
Подробный список сборок и инструкцию по установке смотрите в разделе /download/ или на официальной странице [https://www.happ.su/main/ru](https://www.happ.su/main/ru). Если ставите программу впервые, начните с базовой стабильной сборки для вашей платформы.
| Вариант | Когда подходит | Ограничение |
|---|---|---|
| Установщик или пакет для ПК | Работа на Windows, macOS или Linux | Нужно выбрать подходящую архитектуру системы |
| Мобильная сборка Android | Смартфон или планшет на Android | Зависит от версии ОС и способа установки пакета |
| Сборка для iOS | iPhone или iPad с актуальной системой | Доступность зависит от магазина и региона аккаунта |
| Сборка для Android TV | Телевизор или приставка на Android TV | Удобнее передавать данные с другого устройства |
| Сборка для Apple TV | Приставка Apple TV на tvOS | Управление пультом требует аккуратного ввода данных |
| Отдельная или бета-сборка | Проверка новых функций по задаче | Поведение может отличаться от основной сборки |
Смартфоны и планшеты на Android и iOS
На Android выберите установщик или пакет, подходящий вашему устройству, и разрешите установку из выбранного источника, если система попросит подтверждение. После запуска проверьте права на создание сетевого подключения.
На iOS установите приложение через доступный вам вариант распространения и откройте его с главного экрана. Если вход в магазин требует проверки аккаунта, сначала завершите её в настройках системы.
Компьютеры на Windows, macOS и Linux
На Windows и Linux проверьте разрядность и архитектуру процессора в параметрах системы, чтобы не запустить неподходящий файл. На macOS выберите сборку под вашу систему и следуйте подсказкам установщика.
После установки откройте окно Happ и убедитесь, что клиент видит сетевые интерфейсы. При первом включении туннеля система может запросить разрешение на изменение сетевых настроек.
Как добавить подписку, ключ или QR-код
Чтобы в приложении появились серверы, импортируйте данные от поставщика подписки. В Happ поддерживаются ссылка подписки, отдельный ключ вроде VLESS или Trojan, QR-код, локальная передача на ТВ и Web Import с временным кодом.
Ссылка подписки обычно обновляет список серверов и параметры профиля автоматически. Отдельный ключ добавляет конкретную запись, поэтому при изменении настроек у поставщика его приходится обновлять вручную.
Пошаговые примеры импорта разобраны в разделе /import/ и в справочнике [https://www.happ.su/main/ru/faq/adding-configuration-subscription](https://www.happ.su/main/ru/faq/adding-configuration-subscription). Если после вставки список пуст, проверьте, не попали ли лишние пробелы в начало или конец строки.
- Скопируйте ссылку подписки или отдельный ключ в кабинете поставщика либо откройте QR-код.
- Откройте Happ и перейдите в раздел добавления конфигурации или подписки.
- Выберите способ импорта: вставьте строку, отсканируйте код или используйте Web Import.
- Сохраните профиль и дождитесь загрузки списка серверов.
- Проверьте, что в списке появился хотя бы один сервер и нет ошибки разбора.
Импорт на телевизоры Android TV и Apple TV
Набирать длинную ссылку подписки с пульта телевизора неудобно и легко ошибиться в символах. Для телевизоров используйте локальную передачу или временный код через Web Import, если этот способ доступен в вашей сборке.
Дополнительные детали для приставок приведены в руководствах [https://www.happ.su/main/ru/faq/android-tv](https://www.happ.su/main/ru/faq/android-tv) и [https://www.happ.su/main/ru/faq/apple-tv-tvos](https://www.happ.su/main/ru/faq/apple-tv-tvos). После импорта проверьте, что профиль сохранился после перезапуска приложения.
Как выбрать режим подключения на компьютере
На компьютере в Happ доступны режимы системного прокси и TUN. Наличие конкретного режима зависит от сборки приложения и операционной системы.
Режим системного прокси меняет настройки системы, поэтому через него работает трафик браузера и программ, которые учитывают системные параметры прокси. Режим TUN перехватывает трафик тех программ, которые системный прокси игнорируют.
Сначала включите системный прокси и проверьте работу нужных программ. Если часть приложений продолжает идти мимо сервера, переключитесь на TUN и проверьте результат в той же сети.
Системный прокси и режим TUN на практике
Системный прокси подходит для базовой проверки подключения и работы стандартных браузеров. Если программа использует собственные сетевые настройки и не смотрит на системный прокси, она не пойдёт через него.
Режим TUN охватывает более широкий круг программ на уровне сетевого интерфейса. Если при включении TUN соединение не поднимается, верните системный прокси и проверьте права доступа и конфликты с другими сетевыми утилитами.
Как настроить маршрутизацию и профили
Профили маршрутизации определяют, какой трафик пойдёт через выбранный сервер, а какой пойдёт напрямую. Иногда готовый профиль приходит вместе с подпиской от поставщика, а иногда его нужно выбрать или настроить вручную.
Если часть ресурсов должна открываться напрямую без сервера, проверьте активный профиль маршрутизации перед началом диагностики. Ошибка в правилах часто выглядит как сбой подключения, хотя сам сервер работает.
Больше подробностей о правилах собрано в разделе /marshrutizaciya-happ/ и в документации [https://www.happ.su/main/ru/dev-docs/routing](https://www.happ.su/main/ru/dev-docs/routing). При изменении профиля сначала переключите его, затем проверьте открытие тестового адреса.
- Откройте настройки маршрутизации или раздел профилей в Happ.
- Посмотрите, какой профиль активен сейчас и пришёл ли профиль вместе с подпиской.
- Переключитесь на другой профиль, если часть адресов работает не так, как ожидается.
- Повторно установите подключение и проверьте работу нужных сайтов и программ.
Как понять задержку и выбрать сервер
Задержка показывает время ответа на проверочный запрос, а не реальную скорость передачи данных. Низкое значение задержки не гарантирует высокую пропускную способность канала под нагрузкой.
Если вместо числа отображается значение N/A, значит замер не получен. Причина может быть в недоступности узла, ограничениях сети, ошибке конфигурации или временном сбое проверки.
Подробности о замере задержки описаны на странице [https://www.happ.su/main/ru/faq/ping](https://www.happ.su/main/ru/faq/ping). Сравнивайте два сервера в одной и той же сети и при схожей нагрузке на устройство, иначе цифры будут некорректными.
- Откройте список серверов в выбранной подписке.
- Запустите проверку задержки для нужного сервера или всей подписки.
- Сравните показатели двух серверов в одной сети без фоновых загрузок.
- Выберите сервер с устойчивым откликом и проверьте реальное открытие страниц.
Почему подключение есть, а сайты не открываются
Статус активного подключения в интерфейсе означает только то, что локальный туннель или прокси-режим запущен. Это не гарантирует, что выбранный сервер отвечает и пропускает трафик до нужного ресурса.
Сначала переключитесь на другой сервер из той же подписки и проверьте открытие страницы. Если второй сервер работает, проблема связана с первым узлом или маршрутом до него в текущей сети.
Если не открывается ни один ресурс, проверьте режим подключения на компьютере, активный профиль маршрутизации и актуальность самой подписки. Общие шаги по настройке доступны в разделе /nastroit-happ/.
Что проверять при ошибках импорта и обрывах
При сбое импорта чаще всего встречается неполная ссылка подписки, лишний символ при копировании или неподдерживаемый формат строки. Сначала проверьте строку в буфере обмена и повторите вставку в чистом поле.
При обрывах связи во время работы сначала отключите подключение, подождите несколько секунд и включите его снова. После этого проверьте, не менялась ли сеть с Wi-Fi на мобильную передачу данных.
Если подписка перестала обновляться или закончился срок доступа, обратитесь к поставщику через /login или посмотрите условия в разделе /tariffs/. Само приложение не продлевает подписки и не меняет ссылки доступа.
| Симптом | Первое действие | Если повторилось |
|---|---|---|
| Пустой список после установки | Импортируйте ссылку или ключ | Проверьте строку и формат данных |
| Задержка отображается как N/A | Повторите замер в той же сети | Проверьте другой сервер из списка |
| Подключение есть, сайты не грузятся | Переключитесь на второй сервер | Проверьте маршрутизацию и режим |
| Не обновляется подписка | Проверьте сеть и повторите вход | Уточните ссылку у поставщика |
| Часть программ не идёт через прокси | Проверьте режим на компьютере | Сверьте профиль маршрутизации |
| Ошибка при вставке ключа или QR | Скопируйте данные заново без пробелов | Попробуйте другой способ импорта |
Как обновлять подписку и следить за доступом
Когда поставщик меняет адреса серверов или параметры конфигурации, актуальный список приходит при обновлении подписки. Если вы добавляли только отдельный ключ, изменения придётся внести вручную новым импортом.
Срок действия подписки, лимит устройств и замену ссылки подписки контролирует поставщик. Если ссылка перестала работать после изменений на стороне поставщика, запросите новую ссылку в его кабинете.
Полезные заметки о работе с клиентом публикуются в разделе /blog/. Перед тем как менять несколько параметров подряд, фиксируйте исходное состояние, чтобы можно было быстро вернуть прежний профиль.
Что подготовить перед обращением в поддержку
Когда проблема не решается переключением сервера и проверкой профиля, соберите исходные данные перед обращением в поддержку. Точные сведения экономят время и помогают быстрее локализовать сбой.
Укажите версию Happ и операционную систему, модель устройства, тип сети и точное время с часовым поясом, когда возникла ошибка. Обязательно добавьте результат проверки на втором сервере.
Куда обратиться за помощью по работе клиента, смотрите на странице /podderzhka-happ/. По вопросам оплаты, срока доступа и лимита устройств обращайтесь напрямую к поставщику подписки.
- Запишите версию приложения Happ и версию операционной системы.
- Укажите тип устройства и текущую сеть, например домашний Wi-Fi или мобильную сеть.
- Зафиксируйте время сбоя вместе с вашим часовым поясом.
- Проверьте работу на втором сервере и запишите результат.
- Опишите обратимые действия, которые вы уже выполнили.