todo/Hysteria/troubleshooting.md

---
date: 2026-07-11
tags:
  - hysteria
  - troubleshooting
  - ошибки
  - диагностика
aliases:
  - Hysteria ошибки
  - Hysteria troubleshooting
  - Hysteria не подключается
link: https://v2.hysteria.network/docs/advanced/Troubleshooting/
---

# 🦎 Hysteria 2 — решение проблем

> [!info] О чём заметка
> Расшифровка типичных ошибок Hysteria 2 при настройке клиента и сервера и что с ними делать. Если ещё не подняли сервер/клиент — начните с [[Hysteria/config-server|серверного]] и [[Hysteria/config-client|клиентского]] конфигов. Обзор протокола — [[Hysteria/00-overview|тут]].

## TL;DR

- **timeout: no recent network activity** — клиент не достучался до сервера. Проверьте: запущен ли сервер, не режет ли UDP фаервол/провайдер, верны ли адрес и порт, совпадает ли пароль обфускации.
- **authentication error, HTTP status code: 404** — сервер отверг клиента. Почти всегда неверный пароль или подключение не к тому серверу.
- **certificate signed by unknown authority** — клиент не доверяет сертификату сервера. Для самоподписанного нужен `insecure` + `pinSHA256` на клиенте.
- **listen udp :443: bind: permission denied** — серверу не хватает прав на порт 443. Запуск от root или `setcap cap_net_bind_service`.
- Логи сервиса всегда под рукой: `journalctl --no-pager -e -u hysteria-server.service`.

## Ошибка: timeout (no recent network activity)

Полный текст: `failed to initialize client (connect error: timeout: no recent network activity)`.

Это значит, что клиент **не смог достучаться до сервера**. Частые причины:

- Сервер не запущен (проверьте `systemctl status hysteria-server.service`).
- Порт заблокирован фаерволом. Помимо системного фаервола, у многих хостеров есть **отдельный фаервол в панели управления VPS** — про него часто забывают.
- Сервер слушает другой адрес/порт, чем указан в клиенте.
- Сервер слушает на сети, недоступной клиенту.
- Домен не резолвится в правильный IP.
- **Неверные настройки обфускации.** Если включён [[Hysteria/obfs-port-hopping|obfs]], несовпадение пароля на клиенте и сервере даёт ровно такой таймаут — как будто сервера нет. Сверьте пароль обфускации на обеих сторонах.
- Слишком старое ядро Linux (известная проблема на CentOS 7). Обновите ядро или смените дистрибутив — см. [[Hysteria/install-server|требования к системе]].

> [!tip] Проверьте UDP отдельно
> Hysteria работает по UDP. Многие диагностические привычки (пинг, `telnet` на порт) проверяют ICMP/TCP и ничего не скажут про UDP. Если TCP до сервера идёт, а Hysteria — нет, вероятно, провайдер или фаервол режут именно UDP на этом порту. Обходные приёмы — [[Hysteria/obfs-port-hopping|обфускация и port hopping]]; если UDP зарезан полностью, поможет только TCP-решение вроде [[VLESS/dpi-tls-june-2026|VLESS+TLS]].

## Ошибка: authentication error (HTTP status code: 404)

Полный текст: `failed to initialize client (authentication error, HTTP status code: 404)`.

Клиент **дошёл до сервера, но был отвергнут**. Причины:

- Неверные учётные данные — пароль на клиенте не совпадает с `auth.password` на сервере.
- Подключение не к тому серверу.
- На сервере неправильно настроена секция `auth`.

Проверьте, что `auth` в [[Hysteria/config-client|клиенте]] в точности равен `auth.password` в [[Hysteria/config-server|сервере]] (а при `userpass`-аутентификации формат `username:password`).

## Ошибка: certificate signed by unknown authority

Полный текст: `connect error: CRYPTO_ERROR ... tls: failed to verify certificate: x509: certificate signed by unknown authority`.

Клиент **считает сертификат сервера невалидным**. Причины:

- Сервер использует самоподписанный сертификат, а на клиенте не добавлен доверенный CA и не включён `insecure`.
- В системном хранилище доверенных CA клиента нет центра, подписавшего сертификат.
- Вас атакуют «человеком посередине» (MITM).

Если сертификат самоподписанный — на клиенте укажите `insecure: true` вместе с `pinSHA256` (закрепление отпечатка защищает от подмены). Подробно — в [[Hysteria/config-client|конфиге клиента]], раздел про TLS. Лучший вариант вообще избежать этой ошибки — валидный сертификат через [[Hysteria/config-server|ACME]] на домен.

## Ошибка: bind permission denied на порт 443

Полный текст: `failed to load server config (invalid config: listen: listen udp :443: bind: permission denied)`.

У сервера **нет прав привязаться к порту 443** (порты ниже 1024 требуют привилегий). Два решения:

- Запускать сервер от root.
- Выдать бинарнику capability на привязку к привилегированным портам: `sudo setcap cap_net_bind_service=+ep ./hysteria` (подставьте реальное имя файла, например `hysteria-linux-amd64-avx`).

При установке [[Hysteria/install-server|официальным скриптом]] сервис обычно уже настроен на нужного пользователя — эта ошибка чаще возникает при ручном запуске бинарника.

## Где смотреть логи

Диагностику всегда начинайте с логов. Для systemd-сервиса:

```sh
systemctl status hysteria-server.service
journalctl --no-pager -e -u hysteria-server.service
```

Рабочий сервер пишет **«server up and running»**, рабочий клиент — **«connected to server»**. Отсутствие этих строк и есть первый признак, что что-то не так.

## 📚 См. также

- [[Hysteria/config-server|Конфиг сервера]] — правильная настройка `auth`, `tls`/`acme`, `listen`.
- [[Hysteria/config-client|Конфиг клиента]] — `insecure`/`pinSHA256`, адрес и пароль.
- [[Hysteria/obfs-port-hopping|Обфускация и port hopping]] — если UDP/QUIC режется провайдером.
- [[Hysteria/install-server|Установка сервера]] — требования к системе и правам.
- 🔗 [Troubleshooting — официальная документация](https://v2.hysteria.network/docs/advanced/Troubleshooting/)

---

> [!quote] 🤖 Эти статьи открыты — можно обучать на них ИИ
> При желании вы можете натренировать ИИ на наших статьях. Исходное форматирование и скачивание всего репозитория одним zip-архивом доступны в Forgejo: [исходник этой заметки](https://git.zapret.moe/zapretdiscordyoutube/todo/src/branch/main/Hysteria/troubleshooting.md) · [весь репозиторий](https://git.zapret.moe/zapretdiscordyoutube/todo/src/branch/main).