$ sudo teach IT

Скрипт и config.yaml

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

ВВОДНАЯ

Держите страницу скрипта и страницу быстрого старта сервера. Команду установки скопируйте со страницы в день работы. В PDF её нет: она стареет быстрее файла.

ВЫ УЗНАЕТЕ

  • что скрипт ставит сам и какой файл после него всё равно придётся переписать;
  • чем блок ACME отличается от своего сертификата и почему в файле нельзя держать оба;
  • какие поля учебного сервера включают пароль, вывеску и salamander, не включая Brutal.

5.1 Официальный скрипт

Скрипт живёт на странице установки и подробнее - на странице «Server Installation Script». Команду в день работы копируйте оттуда: строка скачивания меняется быстрее PDF. На день сверки страница ставит или обновляет до последнего выпуска и показывает пример закреплённой версии с номером, который начинается с v. Снятие описано там же, флагом --remove. Сторонний «скрипт под ключ», который сам придумает домен, пароль и сайт для вывески, страница упоминает как чужую работу. Курс такие скрипты не проверял и команды из них не копирует.

Что делает официальный скрипт, видно по его тексту в репозитории. Бинарник оказывается в /usr/local/bin/hysteria. Каталог конфига - /etc/hysteria. Юнит - hysteria-server.service. Рядом скрипт кладёт шаблон hysteria-server@.service для файла по имени. Базовый курс пользуется одним юнитом и одним config.yaml.

Пользователь службы по умолчанию - hysteria. Домашний каталог нового пользователя скрипт задаёт как /var/lib/hysteria. Если сертификаты уже лежат так, что этот пользователь их не читает, страница скрипта предлагает переустановить с HYSTERIA_USER=root. Вернуть обычного пользователя можно той же командой с HYSTERIA_USER=hysteria. Для ACME root не нужен: файлы выпуска пишет сама служба. Root здесь - запасной выход для чужого ключа, не «так надёжнее».

Образец, который скрипт записывает в /etc/hysteria/config.yaml, повторяет быстрый старт: ACME без явных ca и type, случайный пароль, masquerade типа proxy. Домен в образце - плейсхолдер your.domain.net. Службу на этом образце запускать рано. Сначала файл из уроков 5.2-5.5.

Скрипт в конце печатает, куда смотреть дальше, и напоминает, что Hysteria 2 несовместим с конфигом 1.x. Старый YAML от первой версии в новый путь не кладите.

5.2 Каркас файла

Файл - YAML. Комментарий начинается с #. Сборка v2.14.0 файл с такими комментариями подняла. Селектор type устроен одинаково в клиенте и на сервере: он выбирает, какое вложенное поле читать. Соседние вложенные поля при этом молчат. Поэтому obfs.type: salamander не читает блок gecko, даже если вы его забыли ниже.

Слушатель можно не писать. Код и быстрый старт сходятся: пустое поле - это :443, и IPv4, и IPv6. Только IPv4 записывают как 0.0.0.0:443, только IPv6 - как [::]:443. Учебный файл оставляет строку закомментированной, чтобы было видно умолчание и чтобы она совпала с правилом 443/udp из урока 4.4.

Дальше развилка, которую сервер проверяет раньше почти всего остального. Нужен блок tls или блок acme. Оба сразу нельзя. Ни одного нельзя. Сборка v2.14.0 ответила дословно: must set either tls or acme и cannot set both tls and acme. Поле в тексте ошибки - tls, даже когда вы просто забыли оба блока. Не ищите опечатку в сертификате, если блоков два или ноль.

Пароль без типа тоже не пройдёт. Пустой auth.type - ошибка. Учебный тип - password.

5.3 ACME или свой сертификат

ACME выпускает сертификат сам, пока имя из урока 4.3 смотрит на машину и TCP 80 открыт. В коде пустой acme.ca выбирает Let’s Encrypt. Значения letsencrypt и le делают то же. zerossl включают явно. Учебный файл пишет letsencrypt, чтобы выбор был виден, а не спрятан в умолчании.

Пустой acme.type в том же коде - старый режим: ни HTTP-проверку, ни TLS-ALPN программа сама не выключает. Явный http оставляет HTTP и выключает TLS-ALPN. Явный tls делает наоборот. Явный dns уходит в API регистратора, и это уже не базовый путь: пустое имя провайдера конфиг отвергает. Учебный файл ставит type: http, чтобы дверь совпала с правилом 80/tcp. Сборка v2.14.0 на значении nope ответила unsupported ACME type сразу, без запроса в центр. Живой выпуск для hy2.example.com курс не отправлял: домен чужой.

Каталог acme.dir в коде, если поле пустое, называется просто acme и лежит относительно рабочего каталога службы. Юнит ставит рабочий каталог в домашний. У нового пользователя это /var/lib/hysteria. Учебный файл пишет абсолютный путь /var/lib/hysteria/acme, чтобы не гадать, откуда служба стартовала. Каталог должен быть доступен пользователю hysteria на запись. Если нет, выпуск остановится, и это будет в журнале, урок 6.2.

Почта и домен - ваши, не заглушки. Список domains пустым не принимают.

Свой сертификат - два файла, tls.cert и tls.key. Быстрый старт так и показывает. Команда бинарника hysteria cert выпускает самоподписанный ECDSA P-256 и печатает отпечаток. Срок в коде - 365 суток по 24 часа, справка v2.14.0 показывает 8760h0m0s. Имя передают флагом --host. Без флага команда берёт имя машины, а справка на чужом компьютере покажет это имя как «значение по умолчанию». Для сервера нужно имя, которое клиент будет слать в SNI, не hostname датацентра.

hysteria cert --host hy2.example.com --cert /etc/hysteria/server.crt --key /etc/hysteria/server.key

Имя в команде замените до запуска. Команда печатает образец: на сервере sniGuard: disable, на клиенте insecure: true и pinSHA256. Предупреждение в том же выводе: одно insecure: true сопротивляется подмене только вместе с показанным отпечатком. Ключ она пишет с правами 0600. Если команду запустил root, пользователь hysteria ключ не прочитает. Тогда либо путь, который этот пользователь читает, либо HYSTERIA_USER=root со страницы скрипта.

Поле sniGuard учебный файл не задаёт. Пустое значение в коде равно dns-san: имя клиента сверяют, когда в сертификате есть DNS-имя в расширении SAN. Команда hysteria cert как раз кладёт туда --host. На прогоне клиент с тем же именем в tls.sni к такому сертификату подключился, поле мы не выключали. Образец команды выключает проверку. Для двора, где имя одно и то же с обеих сторон, выключение не нужно.

Отдельная ловушка официального клиента. По умолчанию он подражает рукопожатию Chrome. Страница полного клиентского конфига пишет: сертификат Ed25519 такое рукопожатие не проходит, Chrome этот алгоритм не объявляет. Нужен ECDSA или RSA. Сертификаты ACME страница из этого исключения выводит. Команда hysteria cert выпускает ECDSA P-256, поэтому в ловушку не попадает. Чужой генератор «на Ed25519, потому что современнее» - попадает.

Блок tls в учебном близнеце файла выглядит так. ACME в этом близнеце нет.

tls:
  cert: /etc/hysteria/server.crt
  key: /etc/hysteria/server.key

Сертификат перечитывается на каждом рукопожатии. Заменили файлы - процесс ради этого можно не перезапускать. Правка самого config.yaml - другое дело, урок 6.1.

ОДИН СПОСОБ ВЫПУСТИТЬ ИМЯ

tls и acme вместе сервер не загрузит. Выберите до старта. Свой самоподписанный сертификат на клиенте требует insecure и pinSHA256. ACME с настоящим именем этого не требует: проверка идёт обычная.

5.4 Пароль, вывеска и salamander в файле

Три блока вы уже видели по отдельности. В файле они стоят рядом, и путать их легко именно поэтому.

auth:
  type: password
  password: REPLACE_WITH_PASSWORD

masquerade:
  type: proxy
  proxy:
    url: https://example.com
    rewriteHost: true

obfs:
  type: salamander
  salamander:
    password: REPLACE_WITH_OBFS_PASSWORD

REPLACE_WITH_PASSWORD и REPLACE_WITH_OBFS_PASSWORD - заглушки. На живой машине это разные длинные строки. Пароль salamander короче 4 байт сборка v2.14.0 отвергает. Заглушки длиннее, но их всё равно меняют до запуска.

Вывеска смотрит на https://example.com, имя из документации, не на сайт, который скрипт подставил в образец. rewriteHost: true оставлен, потому что страница конфига связывает его с сайтами, которые выбирают ответ по Host. Свой URL подставите вы.

Salamander в учебном файле включён. Значит, обычным HTTP/3-сервером этот двор уже не является, урок 2.3. Хотите сначала увидеть вывеску в Chrome - закомментируйте блок obfs и на сервере, и на клиенте, проверьте, потом верните. Пароль обфускации на обеих сторонах должен совпасть в ту же минуту. Иначе клиент будет молчать, а журнал сервера не покажет «неверный пароль».

5.5 Полоса: где Brutal, где BBR

В учебном сервере секции bandwidth нет. Секции ignoreClientBandwidth нет. Секции congestion нет. По правилам из урока 2.4 направление остаётся на BBR, пока клиент сам не принесёт число.

Так страница и советует для личного сервера. Число, если оно появится, пишут у клиента, и оно не выше той линии, на которой клиент сидит. Исходящая клиента - это входящая сервера. Перепутать подписи легко, когда смотрите только на слово up.

Единицы без пробела страница принимает в виде mbps и коротких имён вроде m. Учебный файл единицу не показывает, потому что числа в нём нет. Образец 20 mbps / 100 mbps со страницы клиента в репозиторий курса не скопирован: это не ваша линия.

Окна QUIC страница приводит и сразу просит не трогать их без понимания. Значения по умолчанию там - 8 МБ на поток и 20 МБ на соединение. Блока quic в учебном файле нет. Тонкая полоса и эти параметры - следующая часть.

ПРАКТИКА

  1. Откройте code/config.server.yaml и отметьте заглушки. Список из четырёх замен: домен, почта, пароль входа, пароль salamander.
  2. Объясните, почему в этом файле нет блока tls.
  3. Запишите, какое правило ufw из урока 4.4 соответствует acme.type: http, а какое - закомментированному listen.

ВЫВОД МОДУЛЯ

Скрипт кладёт бинарник, пользователя hysteria и пустой по смыслу образец конфига. Учебный файл выбирает ACME на Let’s Encrypt с явной проверкой http, один пароль, вывеску и salamander. Полосу не задаёт, чтобы ехать на BBR. Дальше этот файл станет службой, а клиент - первой сессией, которую видно в журнале.

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

  1. Что ответит сервер v2.14.0, если в файле одновременно есть tls и acme?
  2. Почему команде hysteria cert передают --host, даже если справка уже показывает какое-то имя по умолчанию?
  3. Клиент без секции bandwidth подключается к серверу без секции bandwidth. Какой контроллер получит направление?

Ответы

  1. Конфиг не загрузится. Текст ошибки: cannot set both tls and acme.
  2. Имя по умолчанию - hostname машины, на которой вы запустили команду. В сертификат нужно имя, которое клиент пошлёт в SNI.
  3. BBR. Пустая полоса оставляет не-Brutal контроллер, а его тип по умолчанию - bbr.