$ sudo teach IT

Пароль, вывеска и два тормоза

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

ВВОДНАЯ

Держите открытой страницу полного серверного конфига и спецификацию протокола. Файл целиком соберём в модуле 6. Сейчас каждое поле - отдельно, чтобы потом не перепутать два пароля. Поля объясняют протокол. Заглушки не являются готовым узлом.

ВЫ УЗНАЕТЕ

  • как сервер узнаёт своего и что будет, если пароль пустой;
  • чем masquerade задаёт HTTP-ответ без пароля и что отвечает сервер без этой секции;
  • когда полоса включает Brutal, а когда остаётся BBR.

2.1 Аутентификация паролем

Аутентификация здесь - проверка, что стучащийся знает секрет. Спецификация протокола описывает её как HTTP/3-запрос уже внутри QUIC. Свой клиент обязан послать POST на путь /auth, хост hysteria, и заголовки Hysteria-Auth, Hysteria-CC-RX, Hysteria-Padding. В первом - сам секрет. Во втором - скорость приёма клиента в байтах в секунду. Ноль значит «не знаю». Третий - случайная подкладка, её можно игнорировать.

Успех - статус 233 с фразой HyOK. Любой другой статус клиент считает отказом и отключается. Чужому, у кого секрета нет, сервер не имеет права ответить фирменной ошибкой «это Hysteria, пароль не тот». Спецификация не велит отдавать фирменную ошибку протокола на неверный секрет. Настройте ответ как у вашего обычного HTTP/3-сайта: свой каталог или свой сайт. Курс не учит делать процесс «неотличимым» на чужом пути.

В файле базового курса секрет - один пароль:

auth:
  type: password
  password: REPLACE_WITH_PASSWORD

Поле type обязательно. Пустой тип сервер отвергает. Пустой пароль при типе password тоже. Сборка v2.14.0 на такой файл ответила invalid config: auth.password: empty auth password. Заглушку короче четырёх символов вы тоже не обрадуете, но это уже порог salamander, урок 2.3. Пароль входа и пароль обфускации - разные строки. Одинаковыми их делать не обязательно и не стоит: кто увидит одну, не должен автоматически получить вторую.

Рядом в той же секции документация показывает userpass: карта имён и паролей. Клиент тогда пишет секрет как имя:пароль. Учебный файл карту не заводит. Один двор, один ключ. Несколько имён - уже другое хозяйство, его легко принять за обязательное.

Типы http и command на той же странице отдают проверку чужой программе. Это следующая часть курса. В базовый файл их не кладите, даже «на потом»: пустой URL или пустая команда конфиг не спасут, а живой URL легко забыть выключить.

В журнале успешного входа с типом password идентификатор один на всех. Код аутентификатора возвращает строку user. На прогоне v2.14.0 сервер так и записал поле id. Отдельного имени у этого режима нет. Не ищите в логе логин, которого вы не задавали.

- То есть пароль можно отправить открытым текстом? - Нет. Запрос /auth едет уже внутри QUIC, а QUIC несёт TLS. Пароль не заменяет сертификат. Сертификат не заменяет пароль. Одно закрывает дорогу, другое узнаёт своих.

2.2 Masquerade: ответ без пароля

Masquerade задаёт HTTP-ответ на запрос без пароля. Шифрованием он не занимается. Шифрование уже сделал TLS внутри QUIC.

Без секции сервер отвечает 404. Для своего сервера, который должен отдавать ваш сайт, поставьте file со своим каталогом или proxy на свой сайт, либо сайт с письменным разрешением. Пересылку на произвольный чужой сайт курс не рекомендует. Пустая фирменная страница сама по себе сообщает, какой процесс слушает порт.

Если секции masquerade в файле нет, документация говорит жёстко: на все HTTP-запросы сервер отвечает 404 Not Found. Для учебного разбора полей так можно. Для сервера, который должен отдавать ваш сайт, так не оставляют.

Три режима на странице полного конфига:

Тип Что отдаёт
file Файлы из каталога
proxy HTTP со своего сайта или сайта с разрешением, поле url
string Одну и ту же строку

Быстрый старт и образец скрипта установки берут тип proxy. Поле rewriteHost: true нужно, когда верхний сайт выбирает страницу по заголовку Host. Без переписывания он может ответить не тем домом. Учебный файл указывает на https://example.com: имя зарезервировано под примеры. Чужой URL из образца установщика в учебный файл и на свой сервер не копируйте. Подставьте свой сайт или сайт с разрешением владельца. Это объяснение поля, не готовая вывеска для чужой машины.

Режим string проще. В нём есть content, необязательные заголовки и statusCode. Если код не задан, страница ставит 200. На прогоне v2.14.0 сервер с type: string поднялся без выхода в сеть. Режим proxy на https://example.com тоже поднялся сразу: верхний сайт опрашивается, когда приходит HTTP-запрос, а не в момент старта.

Проверка из документации - Chrome с флагом --origin-to-force-quic-on= и вашим именем. Перед запуском Chrome нужно закрыть целиком, иначе флаг не подхватится. Эта проверка имеет смысл, пока сервер ещё говорит обычным QUIC. Salamander, урок 2.3, эту речь ломает: зонд с обычным QUIC до HTTP-ответа не доходит.

ВЫВЕСКА НЕ ПРОВЕРЯЕТ ПАРОЛЬ

Masquerade отвечает на зондирование без секрета. Пароль проверяется на пути /auth. Пустая вывеска пароль не усиливает. Сильный пароль вывеску не рисует.

2.3 Salamander: соль, не второй шифр

Salamander - необязательный слой под QUIC. Пароль на клиенте и на сервере один и тот же. Слой меняет вид датаграммы до разбора QUIC. Это приватность формы пакета и разбор поля obfs, не второй шифр. Курс не обещает, что поток «пройдёт» или станет неотличим, и не сравнивает виды UDP на чужих фильтрах. Это не второй TLS и не замена сертификата.

Спецификация и код описывают один и тот же конверт. Спереди 8 байт соли. Дальше полезная нагрузка. На каждый пакет считают BLAKE2b-256 от общего ключа и этой соли. Хеш длиной 32 байта складывают по XOR с нагрузкой, по кругу. Обратная сторона повторяет расчёт. Пакет, который не разобрался, выбрасывают.

Соль едет открыто, ключ заранее известен обоим концам. Кто ключ не знает, не собирает QUIC и не видит рукопожатие HTTP/3. Кто ключ знает, снимает XOR и получает обычный пакет QUIC. Шифрование сессии по-прежнему делает TLS внутри QUIC.

obfs:
  type: salamander
  salamander:
    password: REPLACE_WITH_OBFS_PASSWORD

Пустой тип обфускации в коде значит «не трогать пакеты». Пустой пароль при типе salamander сборка v2.14.0 отвергла: PSK must be at least 4 bytes. Четыре байта - порог кода, не совет. Страница просит сильный пароль. Заглушка в учебном файле длинная нарочно, и её всё равно меняют.

Неверный пароль на клиенте документация описывает как таймаут, будто сервера нет. На прогоне клиент с чужим паролем за отведённые три секунды строку connected to server не написал, и сервер этого клиента не увидел. Ждать «ошибку пароля» в журнале здесь нечего. Журнал молчит, потому что пакеты не доходят до QUIC.

Включение обфускации, по странице конфига, делает сервер несовместимым с обычными соединениями QUIC. Обычным HTTP/3-сервером он больше не является. Chrome с флагом из урока 2.2 такой адрес как сайт не откроет. Вывеска masquerade при этом в файле остаётся: она описывает ответ на HTTP-запрос, который уже разобран. До разбора запроса salamander не пускает чужой QUIC. Это разбор поля, не обещание незаметности.

Рядом в документации есть второй тип, Gecko. Он помечен экспериментальным и дробит рукопожатие поверх Salamander. Учебный файл его не включает. Два типа сразу дают кашу, в которой легко оставить пароль не в том поле.

ДВА ПАРОЛЯ, ДВЕ ДВЕРИ

Пароль в auth пускает в туннель. Пароль в obfs снимает обёртку. Перепутанные места выглядят как мёртвый сервер, а не как «неверный логин». Сверьте строки на обеих сторонах до того, как менять порт.

2.4 Brutal и BBR на пальцах

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

BBR страница описывает как алгоритм Google, перенесённый на QUIC с небольшими правками. У него есть медленный старт и оценка полосы по тому, как меняется время круга. Число в конфиге ему не нужно. Если секцию congestion не писать, тип по умолчанию - bbr, профиль - standard.

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

Число включается секцией bandwidth, поля up и down. Единицы на странице - от bps до tbps, в том числе короткие m и mbps. На сервере эти числа - предел на каждого клиента. Исходящая сервера - это входящая клиента, и наоборот. Пусто или ноль - предела нет. Предел сервера, по той же странице, сейчас действует на Brutal и не действует на BBR.

Кто выбирает алгоритм, страница рисует так. Если на сервере включён ignoreClientBandwidth, оба конца игнорируют числа и берут свой не-Brutal контроллер. Если клиент полосу не задал, тоже не-Brutal. Если задал - Brutal, а при числе и на сервере берётся меньшее из двух. Для личного сервера страница предлагает упрощение: на сервере не писать ни bandwidth, ни ignoreClientBandwidth, а число при желании поставить только у клиента.

Учебный сервер так и делает. Полосы в файле нет. Клиент без полосы тоже остаётся на BBR. Образец быстрого старта клиента показывает 20 mbps вверх и 100 mbps вниз. Это числа страницы, не замер вашей линии. В учебный файл они не скопированы. Когда будете включать Brutal, подставите свою оценку и помните предупреждение: больше не значит лучше.

Профиль BBR и тип reno в документации есть. Reno страница называет контроллером по умолчанию библиотеки quic-go, проще и обычно осторожнее BBR. Менять профиль и переходить на Reno базовый файл не учит. Это уже тонкая настройка, её заберёт следующая часть.

Ядро Linux умеет свой BBR для TCP, ключ net.ipv4.tcp_congestion_control. К контроллеру QUIC внутри Hysteria этот ключ отношения не имеет. Включать его «чтобы сессия поехала» не нужно. Курс его не трогает.

ПРАКТИКА

  1. Выпишите два пароля учебного сервера и подпишите, какой пускает в туннель, а какой снимает обёртку.
  2. Откройте страницу полного конфига и найдите фразу, что будет с HTTP-запросами, если секции masquerade нет.
  3. Не записывая число: при каком условии направление переходит на Brutal, если сервер полосу не задавал?

ВЫВОД МОДУЛЯ

Своих узнаёт пароль в auth, успех протокола - статус 233. На запрос без пароля отвечает masquerade, а без секции - 404. Salamander - общий ключ и XOR под QUIC, не обещание незаметности. Пока полоса не задана, едет BBR. Дальше посмотрим, какими программами к этому серверу подключаются и из каких полей собирается ссылка.

ПРОВЕРЬТЕ СЕБЯ

  1. Клиент получил статус не 233. Что он обязан сделать по спецификации?
  2. Почему Chrome с флагом принудительного QUIC не годится как проверка вывески, если salamander уже включён?
  3. Сервер без bandwidth, клиент тоже без bandwidth. Какой контроллер выберет направление, если секцию congestion никто не писал?

Ответы

  1. Считать аутентификацию неуспешной и отключиться.
  2. Страница конфига говорит: обфускация делает сервер несовместимым с обычным QUIC, обычным HTTP/3 он больше не является. Зонд без пароля обёртки до HTTP-ответа не доходит.
  3. BBR. Это значение по умолчанию для не-Brutal контроллера, а пустая полоса как раз оставляет не-Brutal.