Конфигурация: что это

Автор: Екатерина Лебедева, редактор раздела knowledge base
Проверил:: Артём Волков
Проверено:: 28 сентября 2026
Опубликовано:: 27 сентября 2026, обновлено 28 сентября 2026
Версия гайда:: 1.0

Коротко

Конфигурация в Happ — это набор параметров одного сервера: протокол, адрес, порт и ключ доступа. Её добавляют вручную, ссылкой вида vless:// или vmess://, либо получают в составе подписки, и сервер появляется в списке серверов.

Конфигурация описывает один сервер, с которым будет работать ядро Xray-core: протокол (VLESS, VMess, Trojan, Shadowsocks, SOCKS5 или Hysteria2), адрес и порт, а также ключ доступа — UUID или пароль. Happ принимает конфигурацию тремя способами: ручным вводом по кнопке «+», ссылкой протокола из буфера обмена, QR-кода или диплинка, и в составе подписки, где таких конфигураций может быть много. Отдельно устроены JSON-конфигурации: Happ передаёт их ядру без изменений, и часть настроек приложения на них не действует.

Конфигурация — набор параметров одного сервера в Happ — протокол, адрес, порт и данные для входа, которые ядро Xray-core использует для подключения. Добавляется вручную, ссылкой протокола или в составе подписки, после чего появляется в списке серверов.

Что называют конфигурацией

Конфигурация — это данные одного сервера, а не всего набора серверов провайдера. В неё входят протокол (VLESS, VMess, Socks5, Trojan, Shadowsocks или Hysteria2), адрес и порт, а также ключ доступа — UUID или пароль, по которому сервер узнаёт клиента.

Happ построен на ядре Xray-core, поэтому конфигурация — это фактически описание одного исходящего подключения (outbound) этого ядра. Приложение читает параметры, передаёт их Xray-core и показывает сервер в общем списке под именем, которое указано после # в ссылке.

Отдельный случай — JSON-конфигурация: полноценный файл настроек Xray-core, а не короткая ссылка протокола. Ей посвящена отдельная страница — JSON-конфигурация.

Как конфигурация выглядит в Happ

Добавить конфигурацию можно тремя способами.

Вручную. Кнопка «+» в правом верхнем углу главного экрана → «Ручной ввод» → выбор протокола → заполнение полей → «Готово». Сервер появится в разделе «Список серверов».

Отдельной ссылкой. Ссылки вида vless://, vmess://, trojan://, ss://, socks://, hysteria2:// и hy2:// Happ принимает из буфера обмена, QR-кода или диплинка.

В составе подписки. Провайдер публикует список конфигураций по одному адресу; Happ запрашивает его и добавляет сразу все серверы. Если исходный список открыт, каждую конфигурацию из него можно посмотреть и переслать отдельно — свайпом вправо по серверу и иконкой со стрелкой: «В буфер обмена», «QR-код» или «JSON».

Если ссылка повреждена, Happ покажет ошибку с названием протокола, например «Конфигурация vless не валидная» — разбор причин на странице ошибки «Конфигурация не валидная».

Пример конфигурации

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

Часть ссылки	Пример	Что это
Схема	`vless://`	протокол конфигурации
Ключ доступа	`00000000-0000-0000-0000-000000000000`	UUID или пароль, по которому сервер узнаёт клиента
Адрес и порт	`example.com:443`	сервер, к которому подключается Happ
Параметры	`?type=tcp&security=reality`	транспорт и слой защиты — свои у каждого протокола
Имя	`#Example`	то, что Happ покажет в списке серверов

Сокращённый пример конфигурации VLESS с условными значениями:

Ссылка

vless://00000000-0000-0000-0000-000000000000@example.com:443?type=tcp&security=reality#Example

Подробный разбор параметров конкретных протоколов — на странице VLESS в Happ и аналогичных страницах других протоколов.

Отличия от похожих терминов

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

Термин	Что это	Отличие от конфигурации
Подписка	ссылка на список конфигураций	обновляется на стороне провайдера, содержит много конфигураций сразу
JSON-конфигурация	конфигурация в формате Xray-core	передаётся ядру без изменений, а не разбирается на параметры Happ
Ключ доступа	UUID или пароль внутри конфигурации	лишь часть конфигурации, а не всё описание сервера
QR-код	способ передать конфигурацию	форма передачи, а не сама конфигурация

Понимание этой разницы помогает быстрее находить причину проблемы: если не подключается один сервер — дело в конфигурации, если ни один сервер из списка провайдера — вероятнее проблема в подписке целиком.

Главное

Конфигурация — это данные одного сервера: протокол, адрес, порт и ключ доступа, а не подписка целиком.
Happ поддерживает конфигурации шести протоколов: VLESS, VMess, Socks5, Trojan, Shadowsocks и Hysteria2.
Добавить конфигурацию можно тремя способами: вручную, отдельной ссылкой протокола или в составе подписки.
JSON-конфигурацию Happ передаёт ядру Xray-core без изменений, минуя часть собственных настроек маршрутизации.
Повреждённая ссылка конфигурации приводит к ошибке вида «Конфигурация {название протокола} не валидная».

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

Чем конфигурация отличается от подписки в Happ?

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

Как понять, какой протокол использует моя конфигурация?

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

Можно ли редактировать конфигурацию после добавления?

Обычно да: конфигурации, добавленные вручную или ссылкой, можно открыть и изменить в списке серверов Happ. Исключение — JSON-конфигурации: Happ передаёт их ядру Xray-core без изменений, поэтому изменения удобнее вносить в сам JSON на стороне провайдера. Конфигурации из зашифрованной подписки тоже недоступны для просмотра и правки — пользователь видит только имя сервера.

Почему при импорте конфигурации появляется ошибка?

Чаще всего ссылка обрезана, потеряла символы при пересылке через мессенджер или в неё попал лишний текст из буфера обмена. Happ показывает это фразой «Конфигурация {название протокола} не валидная» — причины и проверка разобраны на странице [ошибки «Конфигурация не валидная»](/errors/invalid-config). Для JSON есть отдельная ошибка «Невалидная конфигурация JSON» со схожими причинами.

Сколько конфигураций можно добавить в Happ?

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

Нужен ли для конфигурации собственный сервер?

Да, Happ — клиентское приложение без собственных серверов: конфигурация всегда описывает чей-то сервер, свой или предоставленный провайдером. Приложение лишь устанавливает соединение по указанным параметрам через ядро Xray-core. Без адреса действующего сервера конфигурация не подключится, даже если её формат составлен правильно.

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

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

Источники

Документация Happ: добавление конфигурации и подписки — обращение 28 сентября 2026
Документация Happ: примеры ссылок и параметры — обращение 28 сентября 2026
Документация Happ: поделиться конфигурацией — обращение 28 сентября 2026