Клиенты и ссылка hysteria2://
Сервер без клиента - калитка, к которой не подошли. Сегодня три программы, у которых поддержка подтверждена текстом, а не слухом, и разбор ссылки по полям. Кнопки, которых нет в прочитанном README, курс не выдумывает.
ВВОДНАЯ
Держите страницу клиента, страницу схемы URI и README той программы, которую поставите себе. Сервер ещё не поднимаем. Ссылку собираем на бумаге из заглушек.
ВЫ УЗНАЕТЕ
- что умеет официальный клиент и какую строку журнала считать успехом;
- как выглядит исходящий
hysteria2у sing-box и какие GUI сами назвали протокол в README; - из каких частей состоит ссылка
hysteria2://и чего в ней быть не должно.
3.1 Официальный клиент
Официальный клиент - тот же бинарник, что и сервер. Страница установки говорит: готовые файлы включают оба режима. Имя на Linux в таблице - hysteria-linux-amd64, вариант с AVX помечен отдельно и требует AVX. Для скриптов есть постоянная ссылка вида https://download.hysteria.network/app/latest/ плюс имя файла: она уводит на последний выпуск. Какой файл качать в день установки, смотрите в таблице, не в памяти.
Быстрый старт кладёт рядом config.yaml. Минимальная идея такая. Поле server - адрес сервера, с портом или без. Без порта подразумевается 443. Поле auth - тот пароль, что стоит в auth.password сервера. Для режима userpass на сервере сюда пишут имя:пароль. Дальше хотя бы один локальный слушатель. Страница клиента показывает SOCKS5 на 127.0.0.1:1080 и HTTP на 127.0.0.1:8080. Полная страница клиента добавляет: без единого режима клиенту нечего делать. SOCKS5 возит TCP и UDP. HTTP возит обычный HTTP и HTTPS через CONNECT.
Запуск без аргумента и есть клиент. Форма hysteria client делает то же. Чужой файл задают флагом -c или --config. В справке сборки v2.14.0 уровень журнала по умолчанию - info.
Успех на странице клиента - строка connected to server. На прогоне v2.14.0 она была, рядом udpEnabled со значением true, и строки о том, что SOCKS5 и HTTP слушают свои адреса. Та же страница обещает ещё одну строку, use this URI to share your server. В этом прогоне её не было. Ссылку напечатала отдельная команда hysteria share -c с тем же файлом. Если у вас строка в журнале есть, хорошо. Если нет, не считайте клиент сломанным, пока есть connected to server. Команда share остаётся способом получить ссылку из файла.
Адрес IPv6 с портом YAML легко принимает за свою конструкцию. Страница клиента просит брать такое значение в кавычки: "[2001:db8::1]:443". Учебный адрес до кавычек не доходит, но привычка пригодится.
Полосу в этом файле не задаём. Пустая секция оставляет BBR, урок 2.4. Образец страницы с 20 mbps и 100 mbps - иллюстрация, не норма.
Если в поле server подставить уже готовую ссылку hysteria2://, пароль и часть настроек внутри неё. Отдельно их указать нельзя: страница говорит «не нужно и нельзя». Либо ссылка, либо поля. Учебный клиент выбирает поля, чтобы каждое было видно.
3.2 sing-box: поле hysteria2
sing-box - отдельная программа, не сборка Hysteria. Корневой README репозитория называет её универсальной платформой и отсылает к документации. Списка протоколов в самом README нет. Список исходящих в репозитории тип hysteria2 содержит. Страница этого исходящего расписывает поля.
Для базового клиента достаточно такого объекта. Он совпадает с обязательными полями страницы и с обфускацией из урока 2.3. Полоса пустая нарочно: страница пишет, что пустые up_mbps и down_mbps включают BBR, а не контроллер Hysteria.
{
"type": "hysteria2",
"tag": "hy2-out",
"server": "hy2.example.com",
"server_port": 443,
"password": "REPLACE_WITH_PASSWORD",
"obfs": {
"type": "salamander",
"password": "REPLACE_WITH_OBFS_PASSWORD"
},
"tls": {
"enabled": true,
"server_name": "hy2.example.com"
}
}
server, server_port, password и tls страница помечает как обязательные. server_name - имя для проверки сертификата, то же, что sni у официального клиента. Тип обфускации на странице - salamander или gecko. Пустой тип обфускацию выключает.
Отличие, которое страница проговаривает отдельно. Официальный сервер умеет режим userpass. sing-box отдельного алиаса не даёт. В password кладут уже склеенную строку имя:пароль. Учебный сервер на userpass не сидит, поэтому в JSON одна заглушка пароля.
На странице есть поля диапазона портов и интервала прыжка. Это следующая часть. В учебный объект их нет. Сервер на sing-box, со своим входящим hysteria2, тоже не этот курс. Здесь sing-box только клиент к официальному серверу.
3.3 Графические клиенты с hy2 в README
Графическая оболочка показывает ссылку и зовёт ядро. Ядро везёт пакет. Если README оболочки протокол не назвал, курс не достраивает поддержку по чужому блогу.
Hiddify в README описывает себя как клиент для Android, iOS, Windows, macOS и Linux, собранный на sing-box. В списке протоколов того же README есть Hysteria2. Как именно называется пункт импорта, README не пишет. Ищите это в руководстве программы в день установки. Курс кнопки не выдумает.
NekoBox For PC в README перечисляет протоколы и среди них пишет Hysteria2 ( Custom Core or sing-box ). Системы там - Windows и Linux, бэкенд - sing-box. Репозиторий на день сверки помечен как архивный. Описание на странице GitHub говорит, что сопровождение прекращено. Имя в списке протоколов от этого не исчезло. Новую машину на архивный клиент опирать не стоит. Если он уже стоит и ссылка в него заходит, поля ссылки те же, урок 3.4.
v2rayN в README назван оболочкой для Windows, Linux и macOS с ядрами Xray и sing-box. Hysteria2 в этом README нет, остальное уведено в wiki. Пока wiki вы сами не прочитали, поддержка hy2 для курса не подтверждена. Не ставьте галочку «умеет», потому что соседний клиент умеет.
Страница сторонних программ у Hysteria список ведёт и сразу предупреждает: проект эти реализации не контролирует, свежие правки до них могут не доехать, ранжира там нет. Список на сайте собирается отдельно от текста. Курс опирается на README, которые прочитаны, а не на карточку, которую страница могла поменять скриптом.
ОБОЛОЧКА НЕ ЗАМЕНЯЕТ ПОЛЯ
Красивый импорт не исправляет чужой sni и чужой пароль обфускации. Если клиент молчит, сверяйте файл, а не иконку.
3.4 Ссылка hysteria2:// по полям
Ссылка - короткая запись того, без чего клиент не подключится. Схема URI задаёт форму:
hysteria2://[auth@]hostname[:port]/?[key=value]&[key=value]...[#name]
Схема hysteria2 или короткая hy2. Пароль стоит в userinfo, до @. Если в пароле есть особые символы, их кодируют. Для userpass сюда попадает имя:пароль, и двоеточие тоже живёт по правилам кодирования. Заглушка REPLACE_WITH_PASSWORD особых символов не содержит, поэтому в учебной строке она написана как есть.
Имя хоста обязательно. Порт необязателен и по умолчанию равен 443. Учебная строка порт пишет явно, чтобы поле было видно. Часть с портом в спецификации умеет список портов. Это прыжок, его заберёт следующая часть. В базовой ссылке один порт.
Дальше query. Для нашего файла нужны три:
| Параметр | Откуда в конфиге |
|---|---|
obfs |
obfs.type, у нас salamander |
obfs-password |
пароль salamander |
sni |
имя, которое клиент отдаёт в TLS |
Ещё спецификация знает insecure со значениями 1 и 0, pinSHA256 и ech. Для сервера с ACME и нормальным именем insecure не нужен: сертификат проверяется как обычный. pinSHA256 пригодится своему самоподписанному сертификату, урок 5.3. ech в базовый файл не входит.
Фрагмент после # - имя для человека. Спецификация отсылает к RFC 3986 и говорит, что данных для соединения во фрагменте нет. Клиент может показать его в списке, а может выбросить. Команда share сборки v2.14.0 фрагмент не печатала.
Сама команда на адресе 203.0.113.10 выдала такую строку. Адрес из сети, зарезервированной под документацию. Это не чей-то сервер.
hysteria2://REPLACE_WITH_PASSWORD@203.0.113.10:443/?obfs=salamander&obfs-password=REPLACE_WITH_OBFS_PASSWORD&sni=hy2.example.com
На имени hy2.example.com та же команда файл даже не дочитала: lookup hy2.example.com закончился no such host. Клиент при загрузке конфига разрешает имя. Заглушка, которой нет в DNS, для прогона не годится. В файле курса имя всё равно hy2.example.com, потому что так видно, что его заменяют на своё. Своё имя должно резолвиться, иначе клиент отвергнет файл раньше, чем начнёт соединение.
Спецификация отдельно запрещает класть в ссылку режим клиента и полосу. Это вещи конкретного человека, их не рассылают вместе с паролем. Прогон это подтвердил с другой стороны: в клиентском файле была полоса 20 mbps и 100 mbps, в напечатанной ссылке её не было.
ССЫЛКА - ЭТО ПАРОЛЬ
Кто скопировал строку, тот знает и вход, и обёртку. Чат, скриншот и «временный» файл переживают смену намерения. Раздали не тому - меняйте оба пароля и собирайте ссылку заново.
ПРАКТИКА
- По таблице урока 3.4 выпишите, какое поле ссылки соответствует паролю salamander.
- Объясните, почему полоса
bandwidthв ссылку не входит. Хватит одной фразы со страницы схемы URI. - Откройте README клиента, которым пользуетесь. Если Hysteria2 или hy2 там не названы, не записывайте его в список поддерживаемых. Запишите, что именно README говорит вместо этого.
ВЫВОД МОДУЛЯ
Официальный клиент и сервер - один бинарник в разных режимах. sing-box подключается исходящим типа hysteria2, если верить странице конфигурации, а не только слуху. Из оболочек курс назвал те, чей README сам пишет Hysteria2. Ссылка несёт пароль, адрес, обфускацию и SNI. Полосу и локальный слушатель она не несёт. Дальше подготовим машину, на которой этот сервер будет слушать UDP.
ПРОВЕРЬТЕ СЕБЯ
- Какую строку журнала страница клиента считает признаком удачного подключения, и что делать, если строки про «use this URI» на сборке v2.14.0 не видно?
- Почему в исходящий sing-box для учебного сервера не кладут отдельное поле «логин», даже если страница упоминает userpass?
- Клиент отверг
config.yamlс ошибкойno such hostнаhy2.example.com. Это ошибка пароля, порта или имени?
Ответы
connected to server. Ссылку в таком случае даёт командаhysteria share -cс файлом клиента. Прогон v2.14.0 строку из учебника в журнале не показал.- Учебный сервер использует тип
password, неuserpass. У sing-box нет отдельного алиаса userpass: склейкуимя:паролькладут вpasswordтолько когда сервер действительно в этом режиме. - Имени. Клиент разрешает имя при загрузке файла. Пароль и порт до этой ошибки не доходят.