$ sudo teach IT

Служба, журнал и первый клиент

Файл лежит на диске. Пока его никто не читает, калитка нарисована мелом. Сегодня служба, журнал и клиент, который либо пишет connected to server, либо честно молчит. В конце - что учебная версия специально не закрыла.

ВВОДНАЯ

Держите страницу скрипта, раздел про службу и журнал. Заглушки в файле к этому моменту уже заменены, имя резолвится, правила ufw на месте. Если чего-то из этого нет, служба стартует только для того, чтобы показать ошибку.

ВЫ СОБЕРЁТЕ

  • службу hysteria-server.service и перезапуск после правки файла;
  • журнал, в котором виден старт и виден вход с идентификатором user;
  • клиент к этому серверу и список того, чего в учебной версии нет.

6.1 systemd

Служба появляется вместе со скриптом. Страница даёт три команды. Включить и сразу запустить:

sudo systemctl enable --now hysteria-server.service

Перезапустить после правки конфига:

sudo systemctl restart hysteria-server.service

Посмотреть состояние:

sudo systemctl status hysteria-server.service

Юнит, который пишет скрипт, зовёт /usr/local/bin/hysteria server --config /etc/hysteria/config.yaml. Пользователь и группа - hysteria, если вы не переопределили HYSTERIA_USER. Уровень журнала юнит задаёт переменной HYSTERIA_LOG_LEVEL=info. Рабочий каталог - домашний, на systemd новее той версии, про которую скрипт отдельно оговаривает CentOS 7.

Низкий порт 443 обычно требует особых прав. Ручной запуск бинарника на странице быстрого старта поэтому предлагает setcap cap_net_bind_service=+ep. Юнит скрипта эти способности уже несёт: в него входят CAP_NET_BIND_SERVICE, CAP_NET_ADMIN и CAP_NET_RAW. Отдельный setcap после скрипта не нужен. CAP_NET_BIND_SERVICE как раз про порт ниже 1024. Остальные две способности юнит тоже ставит. Учебный файл те режимы, которым они нужны, не включает. Выкидывать строки из юнита «для красоты» не надо: следующий запуск скрипта положит их обратно.

Шаблон hysteria-server@.service стартует файл /etc/hysteria/имя.yaml. Одна калитка в этом курсе живёт в config.yaml и в службе без @. Второй файл заводите, только когда первый уже пускает клиента.

Правка YAML требует перезапуска. Замена файлов сертификата в блоке tls - нет: страница полного конфига говорит, что сертификат читают на каждом рукопожатии. ACME свои файлы обновляет сам. Путать эти два случая легко. Поменяли пароль в YAML и не перезапустили - клиенты всё ещё ходят со старым, потому что процесс его не перечитал.

6.2 Журнал

Журнал службы страница скрипта смотрит так:

sudo journalctl --no-pager -e -u hysteria-server.service

--no-pager отдаёт текст в терминал, -e прыгает к концу, -u выбирает юнит. Успешный старт и на странице быстрого старта, и на прогоне v2.14.0 выглядит как server up and running. Рядом адрес, который процесс реально слушает. Если там не :443, а случайный высокий порт, вы запустили не тот файл.

Чужой конфиг падает раньше этой строки, словом FATAL и failed to load server config. Текст после двоеточия уже встречался: пустой пароль, оба блока сертификата, неизвестный тип ACME, короткий пароль salamander. Это не «сеть плохо дышит». Это файл. Сеть начнётся после server up and running.

Вход с типом password в журнале сервера подписывается идентификатором user. Так возвращает код аутентификатора, и так было на прогоне. Не создавайте ради этой строки учётную запись в системе. Это метка протокола, не пользователь Linux. В той же строке виден адрес клиента. Журнал и ключ сертификата остаются на вашей машине: их не кладут рядом со ссылкой.

Клиент, который дошёл, пишет connected to server. На прогоне рядом было udpEnabled: true. Клиент с чужим паролем salamander этой строки не пишет, и сервер его не видит. Первое, что сверяют в таком молчании, - пароль obfs, потом пароль auth, потом что UDP 443 вообще открыт. Менять порт «на всякий случай» до этой сверки не стоит.

Выпуск ACME, если он споткнётся, тоже окажется здесь: центр не дошёл, имя не то, каталог нельзя писать. Учебный домен hy2.example.com в центр сертификации курс не отправлял. На своей машине читайте ошибку до конца, не обрывайте на первом английском слове.

6.3 Файл целиком

Ниже учебный сервер так, как он лежит в code/config.server.yaml. Заглушки на месте нарочно. Живой файл совпадает с ним полем к полю, пока вы не заменили четыре строки: домен, почту, пароль входа, пароль salamander.

# listen: :443

acme:
  domains:
    - hy2.example.com
  email: admin@example.com
  ca: letsencrypt
  type: http
  dir: /var/lib/hysteria/acme

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

Как это читать, сверху вниз.

  • Слушатель. Строка закомментирована. Процесс берёт :443 на обоих семействах адресов. Правило экрана - 443/udp.
  • Сертификат. ACME, Let’s Encrypt, проверка http, каталог под домом пользователя hysteria. Блока tls нет, и это правильно: два блока сразу файл убивают.
  • Замок. Один пароль. В журнале все такие входы будут user.
  • Вывеска. Тип proxy: HTTP-запрос уходит на свой сайт или сайт с разрешением. В образце стоит https://example.com, заголовок Host переписывается. Это разбор поля, не обещание незаметности.
  • Обёртка. Salamander. Обычный QUIC с этого момента сюда не заходит. Клиент без того же пароля тоже не заходит, и это похоже на выключенный сервер.

Близнец со своим сертификатом лежит в code/config.server.tls.yaml. Там вместо acme блок tls с путями /etc/hysteria/server.crt и server.key. Остальное то же. Оба файла сразу в /etc/hysteria/config.yaml не кладут.

Прогон v2.14.0 поднимал не эту заглушку ACME, а близкий файл: свой сертификат от hysteria cert, слушатель 127.0.0.1 на высоком порту, вывеска типа string и тот же salamander. Строка server up and running была. Файл с masquerade.type: proxy на https://example.com и без секции bandwidth тоже поднялся. Запрос сертификата на hy2.example.com в Let’s Encrypt не уходил.

6.4 Клиент доходит

Учебный клиент - code/config.client.yaml. Имя, пароли и SNI совпадают с сервером. Полосы нет. Слушатели - как в быстром старте, только на локальном адресе.

server: hy2.example.com:443

auth: REPLACE_WITH_PASSWORD

tls:
  sni: hy2.example.com

obfs:
  type: salamander
  salamander:
    password: REPLACE_WITH_OBFS_PASSWORD

socks5:
  listen: 127.0.0.1:1080

http:
  listen: 127.0.0.1:8080

Имя hy2.example.com перед запуском заменяют на то, что резолвится. Иначе загрузка файла кончится no such host, урок 3.4. Для ACME с настоящим сертификатом блок tls ограничивается sni. Поля insecure нет.

Свой самоподписанный сертификат требует другой tls. Отпечаток берёте из вывода hysteria cert, без двоеточий, как команда его напечатала. Образец команды такой:

tls:
  sni: hy2.example.com
  insecure: true
  pinSHA256: REPLACE_WITH_PIN_SHA256

Одно insecure: true без отпечатка команда cert прямо не рекомендует. На прогоне пара «отпечаток плюс insecure» дошла до connected to server. Отпечаток в курс не вписан: он от выброшенного сертификата и к вашему серверу отношения не имеет. Клиент из каталога с этим файлом запускают так.

hysteria -c config.client.yaml

Дальше браузер или другая программа смотрит на 127.0.0.1:1080 как на SOCKS5 или на 127.0.0.1:8080 как на локальный HTTP. Как включить это в конкретной программе, страница клиента не расписывает и отсылает к отдельным инструкциям. Курс кнопки браузера не выдумает. Признак, что туннель жив, остаётся строкой клиента, а не иконкой расширения.

Ссылку для телефона, если не хотите таскать YAML, печатает hysteria share -c config.client.yaml. На сборке v2.14.0 в неё попали пароль, адрес, порт, obfs, obfs-password и sni. Полоса не попала. Фрагмент с человеческим именем спецификация разрешает добавить сами, на соединение он не влияет.

Оболочка из урока 3.3 получает ту же ссылку. Поля не меняются от того, что их показали QR-кодом. Команда share умеет --qr. Читать ли код с экрана, решаете вы. Пароль на экране - всё ещё пароль.

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

127.0.0.1 в слушателях клиента значит «только эта машина». Менять адрес на 0.0.0.0, чтобы «телефон в кафе увидел ноутбук», - отдельная схема. Учебный файл её не описывает.

6.5 Известные ограничения этой версии

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

ИЗВЕСТНЫЕ ОГРАНИЧЕНИЯ ЭТОЙ ВЕРСИИ

Один пароль на всех, в журнале все они user. Нет прыжков по портам, нет ACL и своих исходящих, нет API статистики, нет проверки пароля через HTTP или команду. Окна QUIC не трогали. Полоса не задана, поэтому едет BBR, не настроенный Brutal. Salamander включён, и обычным HTTP/3-сервером процесс больше не является. Нет Docker, панели и сервера на sing-box. Обнаружение при зондировании, устойчивость транспорта UDP и укрепление сюда не входят.

Сертификат в репозитории - заглушка домена и почты. На Let’s Encrypt этот файл не отправляли. Свой ключ в репозиторий не кладут. Команда hysteria cert на учебной машине печатает отпечаток в терминал, не в git.

На свою машину файл переносят после замены заглушек, проверки журнала и сверки со страницей полного конфига на день запуска. Ошибку в уже розданной ссылке одной кнопкой не забирают.

ПРАКТИКА

  1. Замените четыре заглушки в копии серверного файла и запустите службу. В журнале должна появиться строка server up and running. Если вместо неё FATAL, исправьте поле, которое названо в ошибке, и перезапустите.
  2. Поднимите клиент с теми же паролями. Дождитесь connected to server. Затем один раз измените только пароль salamander и убедитесь, что строка пропадает, а сервер клиента не видит. Верните пароль.
  3. Выполните hysteria share -c на клиентском файле. Проверьте, что в строке нет bandwidth и нет вашего режима SOCKS или HTTP.

ВЫВОД МОДУЛЯ

Служба читает /etc/hysteria/config.yaml и слушает 443, потому что юнит разрешает низкий порт. Журнал отличает кривой файл от молчащего клиента. Учебная версия доводит одну калитку до строки connected to server и честно не делает вид, что закрыла всё остальное. Дальше карта: что заберёт pro и о чём будет дополнение.

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

  1. Вы поменяли пароль в YAML, клиенты ходят по-старому. Что забыл сделать процесс?
  2. В журнале сервера идентификатор входа - user, хотя вы такое имя не заводили. Это ошибка?
  3. Зачем в ограничении отдельно сказано, что включённый salamander ломает обычный HTTP/3, хотя masquerade в файле есть?

Ответы

  1. Перезапуск службы. Сертификатные файлы перечитываются на рукопожатии, YAML - нет.
  2. Нет. Режим password так и устроен: код возвращает идентификатор user на любой верный пароль.
  3. Masquerade описывает ответ на уже разобранный HTTP-запрос. Salamander не пускает чужой QUIC до этого разбора. Страница конфига говорит, что сервер перестаёт быть обычным HTTP/3.