Что такое конфигурация для Happ, где взять конфиги и как их добавить

Конфигурация для Happ — это описание одного сервера: протокол, адрес, порт, идентификатор и параметры шифрования, по которым приложение подключается. В интерфейсе каждая конфигурация — отдельный пункт в списке серверов. Приходят они тремя способами: ссылкой-ключом (vless://, vmess://, trojan://, ss://, socks://, hysteria2://), подпиской — ссылкой на целый список конфигураций, который обновляется, — или файлом JSON. Ещё их можно ввести вручную. Сами разработчики конфиги не раздают: их выдаёт сервис с серверами, обычно в боте или кабинете. Ниже — чем конфигурация отличается от подписки и ключа, где взять конфиги, что не так с бесплатными, как импортировать конфигурацию от оператора, как работать с JSON, что значат ошибки вроде «Конфигурация не валидная» и «Ни одна конфигурация не была выбрана».

Что такое конфигурация в Happ

Слово «конфигурация» в приложении означает настройки одного подключения к одному серверу. В ней записано, куда подключаться и как: протокол, адрес сервера, порт, идентификатор пользователя или пароль, способ шифрования и маскировки. Приложение читает конфигурацию и передаёт её ядру Xray, которое устанавливает соединение. Пользователю разбирать эти параметры не нужно.

Разные сервисы называют одно и то же по-разному: конфигурация, конфиг, ключ, сервер, профиль. Если сервис прислал «конфиг для Happ», это обычно та же ссылка-ключ, что и в других сервисах. Добавляется она одинаково. Не ищите разницу там, где её нет: важен не термин, а протокол и то, умеет ли приложение с ним работать.

Конфигурации бывают для разных протоколов. По документации приложение работает с VLESS, в том числе с маскировкой Reality, VMess, Trojan, Shadowsocks, Socks5 и Hysteria2. Конфиги WireGuard и OpenVPN приложение не принимает. Для них нужны другие программы, а сервис обычно может выдать конфиг подходящего протокола.

Форматы конфигов: ключ, подписка и JSON

Первый формат — ссылка-ключ. Это одна строка с одним сервером, начинается с названия протокола. Её копируют и вставляют через «+». Ключ не обновляется: если сервер заменят, нужен новый ключ.

Второй формат — подписка. Это ссылка, обычно начинающаяся с https://, по которой приложение загружает сразу много конфигураций и регулярно обновляет их. Когда сервис меняет серверы, новые конфигурации появляются сами. Подписка может быть зашифрованной — happ://crypt4/ или happ://crypt5/. Подробнее о видах ссылок — в статье про ссылки для Happ.

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

Где взять конфигурацию для VPN

Конфигурации выдают сервисы, у которых есть серверы. Обычно это Telegram-бот: после оплаты или в пробном периоде он присылает ссылку подписки или отдельные ключи, а также кнопку «Добавить в Happ». Бывают сайты с личным кабинетом, где конфиги лежат в разделе подключений. Разработчики приложения конфиги не продают — они прямо пишут, что не предоставляют доступ к серверам.

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

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

Бесплатные конфиги и их проблемы

Бесплатные конфиги публикуют Telegram-каналы, сайты и репозитории на GitHub. Поиски бесплатных конфигов ведут именно туда. Технически это обычные ключи или подписки, они добавляются так же. Разница в том, сколько людей ими пользуется и кто владелец сервера.

Публичным конфигом пользуются сотни людей одновременно. Сервер перегружается и быстро попадает под блокировку, поэтому бесплатный конфиг обычно живёт день-два. Каналы публикуют новые, и круг повторяется. Для постоянного пользования это неудобно: каждые пару дней нужно искать новый конфиг, добавлять его и проверять, жив ли он.

Владелец публичного сервера неизвестен, а через его сервер идёт весь ваш трафик. Сайты с HTTPS он не прочитает, но увидит, куда вы ходите. Через бесплатные конфиги не входите в банк и почту. Честный способ попробовать бесплатно — пробный период у сервиса.

Конфиги с GitHub

На GitHub есть репозитории, которые собирают бесплатные конфиги из открытых источников и публикуют списки. Их часто находят через поиск. Это не официальные материалы разработчиков приложения. Официальная организация разработчиков на GitHub — Happ-proxy, и конфигов там нет.

Списки на GitHub часто обновляются автоматически, но живых серверов в них немного. Это те же публичные конфиги с теми же проблемами: перегрузка, быстрая блокировка, неизвестные владельцы. Некоторые списки оформлены как подписка — их можно добавить ссылкой. Используйте такие списки только для проверки, что приложение работает, а не для постоянного подключения.

Кроме конфигов, на GitHub лежат наборы правил маршрутизации. Это не серверы, а списки сайтов для прямого подключения. Официальный способ получить профиль маршрутизации — routing.happ.su. Чужие правила могут быть устаревшими.

Как добавить конфигурацию в Happ

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

Можно добавить QR-кодом: выберите в приложении сканирование и наведите камеру на код в боте или кабинете. Можно нажать кнопку «Добавить в Happ» в боте — это диплинк, он откроет приложение и добавит конфигурацию сам. Все способы дают одинаковый результат. Выбирайте удобный: на телефоне быстрее кнопка в боте, на компьютере — вставка из буфера, а между устройствами — QR-код.

Для ручного ввода: «+» → «Ручной ввод» → протокол → поля → «Готово». Это нужно, если у вас есть только параметры сервера, а не готовая ссылка. Ошибка в одном поле — и подключения не будет, а найти её среди десятка параметров непросто. Если можно получить ссылку, лучше вставить её.

Как импортировать конфигурацию от оператора VPN

Обычно так бывает, когда сервис («оператор VPN») прислал конфиг и инструкцию со словом «импорт». Импорт — это то же самое добавление: скопировать и вставить через «+», отсканировать QR или нажать кнопку в боте. Если оператор прислал файл, откройте его и скопируйте содержимое. Если это ссылка, просто скопируйте её.

Если оператор прислал файл JSON, его содержимое можно скопировать целиком и вставить из буфера — приложение понимает конфигурации в формате JSON. Если приложение пишет «Невалидная (массив) конфигурация JSON», формат файла не тот, который ожидает приложение. Попросите у оператора ссылку-ключ или подписку. Это проще и надёжнее, чем разбираться с форматом файла.

Если оператор прислал конфиг для WireGuard или OpenVPN — файл с расширением .conf или .ovpn, — приложение его не примет. Эти протоколы не поддерживаются. Попросите у оператора конфиг VLESS, Trojan или Shadowsocks. Если оператор работает только с WireGuard или OpenVPN, нужна другая программа.

Конфигурации для Happ Plus

Happ Plus — то же приложение под другим названием в российском App Store. Конфигурации для него те же, что для обычного приложения: ключи, подписки и JSON добавляются одинаково. Особых «конфигов для Plus» не существует. Если их продают дороже обычных, это маркетинг или обман.

Особенность Plus — он мог давно не обновляться, если его убрали из магазина. Тогда новые конфигурации с обновлёнными параметрами могут не подключаться или не добавляться с ошибкой «Конфигурация не валидная». Попросите у сервиса конфиги, совместимые со старыми версиями. Если доступен TestFlight, обновите приложение.

Зашифрованные подписки crypt5 старые версии тоже могут не понимать. Подписка от сервиса работает во всех версиях приложения, если версия достаточно свежая. Подробнее о Plus — в отдельной статье. Там же — как обновить его без App Store.

Конфигурация обычного прокси

Иногда нужен конфиг обычного прокси-сервера. Приложение понимает прокси Socks5 — ссылкой socks:// или ручным вводом. Вручную: «+» → «Ручной ввод» → Socks → адрес, порт, логин и пароль → «Готово». HTTP-прокси в качестве сервера приложение не принимает.

Socks5 сам по себе трафик не шифрует, поэтому в сетях с ограничениями такие конфиги часто не работают. Протоколы VLESS, Trojan и Shadowsocks шифруют трафик и маскируют его. Для постоянного пользования лучше они. Socks5 имеет смысл, если сервис выдал именно его.

Иногда запрос означает обратное — как сделать устройство с приложением прокси для другого устройства. Для этого есть функция «Разрешить LAN-подключения» в расширенных настройках. Приложение покажет IP-адрес и порты SOCKS5 и HTTP. Их указывают на другом устройстве в той же сети.

Есть ли у Happ конфигуратор

Многие ищут инструмент, который соберёт конфигурацию сам. Для серверов такого официального инструмента нет: конфигурации создаёт сервис или панель управления вашего сервера. Пользователь получает готовую ссылку. Собирать её вручную нет смысла.

Официальный «конфигуратор» есть для маршрутизации — сайт routing.happ.su. На нём собирают профиль правил: какие сайты идут через сервер, какие напрямую. Сайт выдаёт ссылку, которую добавляют в приложение из буфера, диплинком или QR-кодом. Подробнее — в статье про маршрутизацию Happ.

Для провайдеров у разработчиков есть кабинет на happ-proxy.com, где создают лимитированные и HWID-ссылки, и сервис crypto.happ.su для шифрования ссылок. Обычным пользователям они не нужны. Если сайт называет себя «конфигуратором Happ» и просит оплату, будьте осторожны. Это не инструмент разработчиков, и платить за «сборку конфигурации» не нужно.

Конфигурация не валидная: что делать

Ошибка «Конфигурация не валидная» означает, что приложение не смогло прочитать конфиг. Чаще всего ключ скопирован не целиком — длинные ключи VLESS с Reality легко обрезать при выделении. Скопируйте ключ заново кнопкой в боте. Проверьте, что в буфере нет лишнего текста до или после ключа.

Вторая причина — неподдерживаемый формат: конфиг WireGuard, OpenVPN или протокола, которого нет в списке. Третья — устаревшая версия приложения, которая не понимает новые параметры. Обновите приложение до последней версии. Четвёртая — ошибка в поле при ручном вводе.

Если ошибка «Невалидная (массив) конфигурация JSON», формат JSON не тот, что ожидает приложение. Если «Url подписки не валидна», вставлена не ссылка подписки. Если «Буфер обмена пуст», ничего не скопировано. Если ничего не помогает, попросите у сервиса конфигурацию заново. Обычно поддержка присылает её за несколько минут.

«Ни одна конфигурация не была выбрана»

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

Если список пустой, конфигураций нет вовсе: подписка не добавлена, не загрузилась или закончилась. Добавьте подписку через «+». Если подписка есть, но пустая, обновите её и проверьте срок в боте. Если лимит устройств исчерпан, сервис может отдавать пустой список.

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

Как поделиться конфигурацией

Отдельной конфигурацией из обычной подписки можно поделиться: проведите вправо по серверу и нажмите фиолетовую иконку со стрелкой. Приложение предложит скопировать в буфер обмена, показать QR-код или экспортировать в JSON. Другой человек добавит конфигурацию в своё приложение. Она не будет обновляться, как подписка.

Конфигурациями из зашифрованных подписок crypt4 и crypt5 поделиться нельзя — это защита сервиса. Скрытые подписки тоже не дают делиться. Если сервис ограничивает число устройств, переданная конфигурация может занять место в вашем лимите. Учитывайте правила сервиса.

Экспорт в JSON полезен, если нужно перенести конфигурацию в другой клиент, который принимает JSON. Для обычного переноса проще ссылка или QR. Подробнее — в статье о том, как поделиться Happ. Там же — как раздать подключение через LAN.

Конфигурация есть, а подключения нет

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

Если задержка есть, а подключение не устанавливается, проверьте дату и время на устройстве, закройте другие VPN-приложения и обновите приложение. Старая версия может не понимать новые параметры конфигурации. На компьютере запустите приложение от имени администратора. На iPhone проверьте конфигурацию VPN в настройках системы.

Не путайте конфигурацию сервера в приложении с конфигурацией VPN в настройках iPhone. Вторая — это системная запись, которую iOS создаёт при первом подключении. Если её удалить, приложение предложит добавить заново. Без неё подключение на iPhone не работает, даже если конфигурация сервера в приложении в полном порядке.

Итог

Конфигурация для Happ — настройки одного сервера, которые приходят ключом, подпиской или JSON. Берут их у сервиса, добавляют через «+» и вставку из буфера, QR-кодом или кнопкой в боте. Бесплатные конфиги из каналов и GitHub живут недолго. «Конфигурация не валидная» обычно значит неполный ключ, «ни одна конфигурация не была выбрана» — не выбран сервер.

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

Где взять конфигурацию для Happ?

У сервиса с серверами — в его боте или кабинете, лучше в виде подписки.

Что значит «Конфигурация не валидная»?

Ключ скопирован не целиком, в неподдерживаемом формате или версия приложения устарела.

Что делать, если пишет «Ни одна конфигурация не была выбрана»?

Выберите сервер в списке подписки и снова нажмите кнопку подключения.