Ссылка hy2:// и QR-код Hysteria2: как импортировать профиль в клиент

Вы получили ссылку вида hy2:// или QR-код от провайдера/VPN-сервиса. Чтобы начать пользоваться Hysteria2, эту ссылку нужно импортировать в клиент. Процесс логичен: копируете строку, вставляете в приложение — и профиль появляется в списке. Но если не разобраться, из чего состоит ссылка и как её правильно обработать, легко потерять время на «битые» профили или случайно раскрыть чувствительные данные. В этой статье покажу, как импортировать hy2:// в клиент, как проверить ссылку на повреждения и что нельзя публиковать.

Мы рассмотрим два основных способа: через буфер обмена (если ссылка уже скопирована) и через QR-код (если его нужно отсканировать камерой). Разберём также, почему важно не оставлять ссылку в открытом доступе и как отличить рабочую строку от испорченной. Эти шаги подойдут для большинства современных клиентов Hysteria2 на Windows, Android, iOS, macOS и Linux.

Из чего состоит ссылка hy2://

Ссылка hy2:// — это не случайный набор символов, а структурированный URI, в котором зашифрованы параметры подключения. Понимание структуры поможет вам быстро оценить корректность строки и вручную исправить очевидную опечатку.

Типичная ссылка выглядит так:

hy2://user:password@server.example.com:443/?sni=example.com&insecure=0#ProfileName

Разберём по частям:

• hy2:// — схема URI, указывающая, что это профиль Hysteria2.
• user:password — логин и пароль (или токен аутентификации). Именно они подтверждают вашу личность на сервере.
• server.example.com:443 — адрес сервера и порт для подключения.
• ?sni=example.com — параметр SNI (Server Name Indication), который используется для TLS-рукопожатия.
• &insecure=0 — флаг проверки сертификата. 0 означает, что проверка включена, 1 — отключена. Если стоит 1, это потенциально опасно.
• #ProfileName — необязательное название профиля, которое отображается в клиенте.

В зависимости от версии протокола могут встречаться и другие параметры: alpn, obfs, pinSHA256. Они уточняют поведение клиента. Пока вам достаточно знать, что строка должна быть целой, без лишних пробелов и переносов.

Импорт через буфер обмена

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

1. Скопируйте полную строку hy2:// в буфер обмена. Лучше выделять целиком, от первой буквы h до последнего символа.
2. Откройте клиент Hysteria2. Найдите кнопку «Импорт» или «Добавить профиль». Обычно она обозначена значком «+» или пунктом меню.
3. Выберите вариант «Импорт из буфера обмена» (или «Вставить ссылку»). Приложение само распознает hy2:// и заполнит поля.
4. Сохраните профиль. Название возьмётся из части после #, если она есть. Если названия нет, придумайте понятное имя (например, «Рабочий VPN»).
5. Подключитесь. Кликните по профилю и нажмите «Подключить».

Иногда клиент требует вставить ссылку в специальное поле вручную — например, в Hysteria2 CLI. В этом случае используйте команду:

hysteria2 client import -u "hy2://..."

Не забудьте заменить многоточие на полную строку. Если вы работаете на Linux, обратите внимание на настройку клиента Hysteria2 в Linux — там есть дополнительные рекомендации по правам доступа и запуску в фоне.

После импорта проверьте, что профиль появился в списке и не отмечен ошибкой. Если клиент показывает «Invalid URI», значит ссылка повреждена — перейдите к соответствующему разделу ниже.

Импорт по QR-коду

QR-код — это графическое представление той же самой ссылки hy2://. Он удобен, когда профиль нужно перенести с экрана на телефон или с бумажного носителя. Импорт выполняется в два счёта:

1. Откройте в клиенте функцию «Сканировать QR-код» (обычно это значок QR-кода на экране добавления профиля).
2. Наведите камеру смартфона на QR-код. Держите телефон ровно, чтобы код полностью попал в рамку.
3. Дождитесь, пока приложение распознает и подставит ссылку. Подтвердите сохранение.

Если QR-код не считывается, проверьте освещение и расстояние. Если код распознаётся как обычный текст, но клиент не видит hy2:// — возможно, вы открыли его встроенной камерой, а не клиентом. В этом случае скопируйте расшифрованный текст из камеры и импортируйте его как ссылку через буфер обмена.

Помните, что QR-код — это тоже ссылка. Если вы отправляете его в чат или печатаете, он доступен всем, кто может его увидеть. Используйте сканирование только тогда, когда код показан вам лично.

Что нельзя публиковать в ссылке

Ссылка hy2:// — это по сути ключ доступа к вашему VPN-серверу. В ней содержатся логин, пароль и адрес сервера. Если кто-то получит эту ссылку, он сможет подключиться к вашему серверу и использовать его трафик.

Поэтому никогда не публикуйте её в открытых каналах:

• В чатах, комментариях, социальных сетях.
• На форумах или в публичных репозиториях.
• На скриншотах рабочего стола.

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

Отдельно предупреждение про параметр insecure=1. Если в вашей ссылке он присутствует, значит клиент не будет проверять сертификат сервера. Это снижает безопасность и делает соединение уязвимым для атак. Если вы не уверены, почему он включён, отключите его или попросите провайдера выдать ссылку с корректным сертификатом.

Как распознать повреждённую ссылку

Иногда ссылка выглядит нормально, но клиент отказывается её принимать. Повреждения возникают из-за переноса строк, потери части текста при копировании, а также из-за правок в мессенджерах, превращающих текст в ссылку с пробелами.

Вот признаки, что ссылка испорчена:

• Клиент пишет «Invalid URI» или «не удалось распознать профиль». Это значит, что структура нарушена — например, пропущен символ @ либо пароль отделён от логина неправильно.
• В строке есть пробелы. Они недопустимы в URI, если не закодированы как %20. Попробуйте очистить лишние пробелы.
• Часть ссылки заменилась на многоточие (например, из-за авторефакта в Telegram). Это часто случается с длинными строками: мессенджер обрезает их при предпросмотре. Копируйте ссылку через «Копировать» в контекстном меню, а не через выделение текста.
• В названии профиля после # есть небезопасные символы, такие как #, &, ?. Они должны быть URL-закодированы. Если профиль не добавляется, упростите название или удалите его.

Если вы сомневаетесь, попробуйте вставить ссылку в браузер (адресную строку). Браузер покажет ошибку или попытается открыть приложение, но главное — он нормально отобразит структуру ссылки, и вы сможете визуально проверить целостность. Также можно использовать онлайн-декодер URI, но не вставляйте туда ссылку с реальными паролями.

Частая ситуация — ссылка скопирована с лишними символами типа … (многоточие) или < > из HTML-разметки. Удалите их. Если вы знаете структуру ссылки, можете восстановить недостающие части вручную, но проще попросить провайдера выслать ссылку заново.

Проверка после импорта

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

• Адрес сервера указан верно (без опечаток).
• Порт соответствует ожидаемому (обычно 443, но может быть любым).
• SNI совпадает с именем сервера, если это требование вашего провайдера.
• Флаг insecure в настройках имеет ожидаемое значение. Если вы не настраивали его, лучше оставить 0.

Затем попробуйте подключиться. В случае ошибки посмотрите логи клиента — там будет указано, на каком этапе обрывается соединение. Чаще всего встречаются:

• handshake failure — проблема с TLS (неверный SNI, сертификат, устаревшая версия клиента).
• auth failed — неправильные логин или пароль.
• connection refused — сервер недоступен или закрыт порт.

Если вы используете конфигурацию, созданную вручную, сверьте её с типовым примером из нашей статьи о client config. Иногда проблема не в ссылке, а в настройках клиента — например, в параметрах разрешений.

Импорт готового профиля — это самый быстрый способ начать работу с Hysteria2. Главное — относитесь к ссылке как к паролю и всегда проверяйте её целостность. Если что-то пошло не так, вернитесь к этому руководству: почти всегда проблему можно решить за пару минут.