Конфиг VLESS: как устроена ссылка и как добавить её в Happ
Конфиг — это одна строка, в которой записано всё, что клиенту нужно знать про один сервер: куда подключаться, каким протоколом и с какими параметрами. Разбираем строку по частям, показываем, как добавить её в Happ вручную, и объясняем, почему такие строки живут недолго.
Что такое конфиг VLESS
VLESS — протокол передачи данных, с которым работают Happ и другие клиенты того же класса; что такое VLESS и зачем ему Reality — в отдельном разборе. Конфиг VLESS — это текстовое описание одного подключения, упакованное в ссылку, которая начинается с vless. Формат придуман так, чтобы описание сервера можно было переслать одним сообщением или зашить в QR-код: ни файлов, ни программ для распаковки не требуется.
Файл, ссылка или QR-код — разница только в упаковке
Иногда конфиг присылают файлом, иногда картинкой с QR-кодом, иногда просто строкой в чате. Внутри во всех трёх случаях один и тот же текст. Happ принимает его и из буфера обмена, и камерой с экрана — на результат это не влияет.
Поэтому искать отдельно «конфиг файл для Happ» не нужно: если у вас есть строка, начинающаяся с vless, конфиг у вас уже есть.
Один конфиг — один сервер
Это главное свойство формата и источник большинства разочарований. Строка описывает ровно одну серверную точку и ничего не знает про остальные. Чтобы иметь выбор локаций, конфигов нужно столько же, сколько локаций, и каждый добавляется отдельно.
Именно из-за этого свойства сервисы выдают не набор строк, а ссылку-подписку: она отдаёт весь список разом и переживает замену серверов. Как это устроено — на отдельной странице.
Из чего состоит ссылка vless://
Разберём условную строку вида vless://f1c2a7…@server.example:443?type=tcp&security=reality&sni=example.com#Amsterdam-01 по частям.
| Часть строки | Что она означает |
|---|---|
| vless:// | Название протокола. По нему клиент понимает, как читать всё остальное, и отличает строку от ss:// или vmess:// |
| f1c2a7… до знака @ | Идентификатор пользователя (UUID) — фактически пароль подключения. Сервер пускает только тех, чей идентификатор ему заранее известен |
| server.example:443 | Адрес сервера и порт. 443 берут потому, что это обычный порт HTTPS: соединение на нём выглядит как рядовое обращение к сайту |
| параметры после знака вопроса | Транспорт и маскировка: type, security, sni, flow, pbk и прочие. Ошибка в любом из них ломает подключение целиком — поэтому строку не редактируют руками |
| текст после решётки | Просто имя записи, которое вы увидите в списке приложения. На работу не влияет, можно менять как угодно |
Как добавить одиночный конфиг в Happ
Порядок одинаковый на всех платформах, отличаются только названия кнопок.
-
1Скопируйте строку целикомОт vless до конца, включая имя после решётки. Обрезанная строка не заработает, а сообщение об ошибке будет неочевидным — клиент просто скажет, что конфиг некорректен.
-
2Откройте Happ и нажмите «+»Кнопка добавления на главном экране. Приложение предложит выбрать источник: буфер обмена, QR-код или ручной ввод полей.
-
3Выберите добавление из буфераКлиент сам разберёт строку на поля — вводить адрес и идентификатор руками не нужно. Если конфиг у вас в виде картинки, выбирайте сканирование QR и наводите камеру.
-
4Убедитесь, что запись появиласьВ списке возникнет ровно одна новая строка — один сервер. Если её нет, строка была скопирована не полностью или потеряла символы при пересылке через мессенджер.
-
5Подключитесь и проверьтеПервое подключение потребует системного разрешения на VPN — без него клиент работать не сможет. Если соединение не поднимается, смотрите разбор частых причин.
Почему одиночные конфиги быстро перестают работать
Строку, которую вам прислали или которую вы взяли из открытой подборки, стоит воспринимать как расходник: она работает ровно до первого изменения на стороне сервера. Причин три, и ни одна не лечится со стороны пользователя.
- Сервер меняется. Машину переносят, меняют адрес или параметры — и старая строка указывает в никуда. Клиент при этом обычно молчит и просто не подключается.
- Публичный список означает нагрузку. Один и тот же конфиг из открытой подборки одновременно добавляют себе тысячи человек. Полоса делится на всех, и скорость падает до значений, при которых не открывается даже текстовая страница.
- Владелец неизвестен. Через сервер проходит весь ваш трафик. Если за машину никто явно не платит, разумно исходить из того, что она окупается как-то иначе. Подробнее — про бесплатный доступ.
Когда одиночный конфиг всё-таки уместен
Когда сервер ваш собственный или его дал человек, которому вы доверяете, и точка при этом ровно одна. Во всех остальных случаях удобнее ссылка-подписка: она отдаёт все серверы разом и переживает их замену без вашего участия.
Вопросы про конфиги
Чем конфиг отличается от подписки?
Конфиг — описание одного сервера, зафиксированное навсегда. Подписка — адрес, по которому клиент сам забирает список серверов и обновляет его. В приложение и то и другое добавляется одинаково, а ведут они себя по-разному.
Happ пишет, что конфиг некорректен
Чаще всего строка скопирована не полностью или в неё попал перенос строки при пересылке через мессенджер. Вставьте её в любой текстовый редактор, убедитесь, что это одна строка без пробелов и переносов, и скопируйте заново.
Я поменял параметр в строке, и всё сломалось
Так и будет: параметры должны совпадать с настройками сервера символ в символ, подобрать их со стороны клиента невозможно. Возьмите исходную строку заново — редактировать имеет смысл только текст после решётки, то есть название записи.
Можно собрать свою подписку из конфигов?
Технически да: подписка — это и есть список конфигов, выложенный по какому-то адресу. Практического смысла в этом нет, если у вас нет собственного сервера, откуда его раздавать.
Сколько конфигов можно добавить в приложение?
Ограничения нет, но каждую строку придётся обслуживать вручную: следить, какая умерла, и заменять её. Ровно поэтому мы выдаём подписку, а не набор строк.
Ваш ключ — это конфиг или подписка?
Подписка: одна ссылка, за которой стоят все наши серверы. Что в неё входит и как она выдаётся — на странице про ключ для Happ.
Подписка вместо охоты за конфигами
Одна ссылка, которая отдаёт весь список серверов и обновляется сама. Приложение Happ бесплатное — платный только доступ к серверам, и он начинается со 169 ₽.
- Не нужно искать строки — список приходит в приложение целиком
- Замена сервера незаметна — конфиги внутри подписки обновляются на нашей стороне
- 4 устройства на одну ссылку, трафик без счётчика
- Без автосписаний — платёж разовый, за выбранный срок