Служба, журнал и первый клиент
Файл лежит на диске. Пока его никто не читает, калитка нарисована мелом. Сегодня служба, журнал и клиент, который либо пишет 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.
На свою машину файл переносят после замены заглушек, проверки журнала и сверки со страницей полного конфига на день запуска. Ошибку в уже розданной ссылке одной кнопкой не забирают.
ПРАКТИКА
- Замените четыре заглушки в копии серверного файла и запустите службу. В журнале должна появиться строка
server up and running. Если вместо неёFATAL, исправьте поле, которое названо в ошибке, и перезапустите. - Поднимите клиент с теми же паролями. Дождитесь
connected to server. Затем один раз измените только пароль salamander и убедитесь, что строка пропадает, а сервер клиента не видит. Верните пароль. - Выполните
hysteria share -cна клиентском файле. Проверьте, что в строке нетbandwidthи нет вашего режима SOCKS или HTTP.
ВЫВОД МОДУЛЯ
Служба читает /etc/hysteria/config.yaml и слушает 443, потому что юнит разрешает низкий порт. Журнал отличает кривой файл от молчащего клиента. Учебная версия доводит одну калитку до строки connected to server и честно не делает вид, что закрыла всё остальное. Дальше карта: что заберёт pro и о чём будет дополнение.
ПРОВЕРЬТЕ СЕБЯ
- Вы поменяли пароль в YAML, клиенты ходят по-старому. Что забыл сделать процесс?
- В журнале сервера идентификатор входа -
user, хотя вы такое имя не заводили. Это ошибка? - Зачем в ограничении отдельно сказано, что включённый salamander ломает обычный HTTP/3, хотя masquerade в файле есть?
Ответы
- Перезапуск службы. Сертификатные файлы перечитываются на рукопожатии, YAML - нет.
- Нет. Режим
passwordтак и устроен: код возвращает идентификаторuserна любой верный пароль. - Masquerade описывает ответ на уже разобранный HTTP-запрос. Salamander не пускает чужой QUIC до этого разбора. Страница конфига говорит, что сервер перестаёт быть обычным HTTP/3.