Статья 70 из 141
Гайды
Hysteria 2 на VPS: установка сервера, сертификат, пароль, masquerade и клиенты
Hysteria 2 — прокси-протокол поверх QUIC (UDP). Он хорошо держит скорость на каналах с потерями и большой задержкой: мобильный интернет, Wi-Fi в общественных местах, дальние маршруты. Сервер — один бинарник на Go, ему хватает 10–30 МБ памяти. Ниже вы поставите собственный сервер Hysteria 2 на VPS без панелей и подключите к нему свои устройства.
Если вам нужна панель с пользователями и лимитами, посмотрите 3x-ui или сравнение VPN-панелей. Здесь только Hysteria 2 в чистом виде.
Что понадобится
Заголовок раздела «Что понадобится»| Ресурс | Минимум |
|---|---|
| CPU | 1 vCPU |
| RAM | 512 МБ |
| Диск | 100 МБ под бинарник и конфиг |
| ОС | Ubuntu 22.04 / 24.04 |
| Порт | один UDP-порт, по умолчанию 443/udp |
Для сертификата Let’s Encrypt нужен домен с A-записью на IP сервера (DNS). Без домена можно работать с самоподписанным сертификатом.
Установка
Заголовок раздела «Установка»Официальный скрипт скачивает последнюю версию, создаёт пользователя hysteria и systemd-сервис:
bash <(curl -fsSL https://get.hy2.sh/)Что получилось после установки (проверено на версии v2.14.0, ноябрь 2026):
| Путь | Что это |
|---|---|
/usr/local/bin/hysteria |
бинарник |
/etc/hysteria/config.yaml |
конфиг сервера (скрипт кладёт пример) |
hysteria-server.service |
сервис для config.yaml |
hysteria-server@.service |
шаблон для нескольких конфигов: hysteria-server@имя читает /etc/hysteria/имя.yaml |
Сервис работает от пользователя hysteria, а не от root. Проверьте версию:
hysteria versionКонфиг с Let’s Encrypt
Заголовок раздела «Конфиг с Let’s Encrypt»Откройте /etc/hysteria/config.yaml и замените пример своим конфигом:
listen: :443
acme: domains: - hy.example.com email: you@example.com
auth: type: password password: ДЛИННЫЙ_ПАРОЛЬ
masquerade: type: proxy proxy: url: https://www.wikipedia.org/ rewriteHost: truelisten: :443— UDP-порт на всех адресах IPv4 и IPv6.acme— сервер сам получит и продлит сертификат. Для проверки Let’s Encrypt использует порт 80/tcp (HTTP-проверка) или 443/tcp (TLS-ALPN). Эти порты должны быть открыты и не заняты Nginx. Если они заняты, используйте самоподписанный сертификат или свой из certbot.auth— общий пароль. Сгенерируйте его:openssl rand -base64 24.masquerade— что увидит обычный браузер, если откроет ваш сервер по HTTP/3. Здесь сервер проксирует чужой сайт. Без этого блока сервер отвечает 404 на любой HTTP-запрос.
Конфиг с самоподписанным сертификатом
Заголовок раздела «Конфиг с самоподписанным сертификатом»Создайте сертификат. Поле subjectAltName обязательно: без него клиент Hysteria отклонит сертификат даже с проверкой по отпечатку.
cd /etc/hysteriaopenssl req -x509 -nodes -newkey ec:<(openssl ecparam -name prime256v1) \ -keyout server.key -out server.crt -days 3650 \ -subj "/CN=hy.example.com" -addext "subjectAltName=DNS:hy.example.com"chown hysteria:hysteria server.key server.crtchmod 600 server.keychown нужен, потому что сервис запущен от пользователя hysteria. Без него сервер не прочитает ключ.
Вместо блока acme укажите файлы:
listen: :443
tls: cert: /etc/hysteria/server.crt key: /etc/hysteria/server.key
auth: type: password password: ДЛИННЫЙ_ПАРОЛЬ
masquerade: type: proxy proxy: url: https://www.wikipedia.org/ rewriteHost: trueУзнайте отпечаток сертификата, он понадобится клиентам:
openssl x509 -noout -fingerprint -sha256 -in /etc/hysteria/server.crtЗапуск и автозапуск
Заголовок раздела «Запуск и автозапуск»systemctl enable --now hysteria-server.servicesystemctl status hysteria-server.servicejournalctl --no-pager -e -u hysteria-server.serviceВ журнале должна появиться строка:
INFO server modeINFO server up and running {"listen": ":443"}После любой правки конфига: systemctl restart hysteria-server.service.
Файрвол
Заголовок раздела «Файрвол»Hysteria 2 работает по UDP. Откройте именно UDP-порт:
ufw allow 443/udpufw statusЕсли вы используете ACME с HTTP-проверкой, откройте ещё 80/tcp. Подробнее о ufw: настройка файрвола. Проверить доступность порта снаружи помогут советы из статьи проверка порта, но учтите, что UDP-порты онлайн-сканеры часто показывают как «закрытые» даже при рабочем сервере. Надёжнее проверить реальным клиентом.
Подключение клиентов
Заголовок раздела «Подключение клиентов»Ссылка для импорта в клиент имеет формат:
hysteria2://ДЛИННЫЙ_ПАРОЛЬ@hy.example.com:443/?sni=hy.example.com#my-serverДля самоподписанного сертификата добавьте insecure=1 и отпечаток: &insecure=1&pinSHA256=AB:CD:.... С закреплённым отпечатком клиент подключится только к серверу с вашим сертификатом.
Приложения с поддержкой Hysteria 2 из официального списка проекта:
| Платформа | Клиенты |
|---|---|
| Windows, macOS, Linux | Hiddify, sing-box, Clash.Meta (mihomo), официальный клиент hysteria |
| Android | Hiddify, sing-box, NekoBox, V2Box |
| iOS | Hiddify, sing-box, Shadowrocket, Streisand, Stash |
Официальный клиент hysteria поднимает локальный SOCKS5 и HTTP-прокси. Пример client.yaml для самоподписанного сертификата:
server: hy.example.com:443auth: ДЛИННЫЙ_ПАРОЛЬtls: sni: hy.example.com insecure: true pinSHA256: AB:CD:...socks5: listen: 127.0.0.1:1080http: listen: 127.0.0.1:8080hysteria client -c client.yamlcurl --socks5-hostname 127.0.0.1:1080 https://ifconfig.me/ipПоследняя команда должна вывести IP вашего VPS. Проверено: при верном отпечатке клиент пишет connected to server, при неверном падает с ошибкой no certificate matches the pinned hash.
Скорость и обфускация
Заголовок раздела «Скорость и обфускация»Скорость. Если в клиенте не задан блок bandwidth, Hysteria использует алгоритм BBR. Это подходит большинству. Если указать реальную скорость своего канала, включится собственный алгоритм Brutal. Он агрессивнее держит скорость на плохих сетях, но завышенные цифры только ухудшат результат. Указывайте значения чуть ниже реальных:
bandwidth: up: 50 mbps down: 200 mbpsОбфускация Salamander. По умолчанию трафик Hysteria выглядит как HTTP/3. Если в вашей сети QUIC работает плохо, а UDP проходит, включите obfs на сервере и в клиенте с одинаковым паролем:
obfs: type: salamander salamander: password: ВТОРОЙ_ПАРОЛЬС obfs сервер перестаёт быть обычным HTTP/3-сервером, поэтому masquerade по HTTP/3 больше не работает. В ссылке добавьте &obfs=salamander&obfs-password=ВТОРОЙ_ПАРОЛЬ. Проверено: клиент с неверным паролем obfs не подключается и через 10 секунд пишет timeout: no recent network activity.
Masquerade по TCP. Чтобы сайт-маска открывался и в обычном браузере по HTTPS, добавьте в блок masquerade строки listenHTTPS: :443 и, при желании, listenHTTP: :80 и forceHTTPS: true. Тогда сервер займёт и TCP-порты, поэтому Nginx на тех же портах работать уже не сможет.
Обновление и удаление
Заголовок раздела «Обновление и удаление»Повторный запуск скрипта обновляет бинарник до последней версии, конфиг не трогает:
bash <(curl -fsSL https://get.hy2.sh/)systemctl restart hysteria-server.serviceУдаление:
bash <(curl -fsSL https://get.hy2.sh/) --removerm -rf /etc/hysteriauserdel -r hysteriaufw delete allow 443/udpСкрипт удаляет только бинарник и сервисы. Конфиг, сертификаты и пользователя нужно убрать вручную, как выше.
Частые проблемы
Заголовок раздела «Частые проблемы»| Симптом | Причина/решение |
|---|---|
Клиент: timeout: no recent network activity |
UDP-порт закрыт в ufw или у провайдера, не совпадает пароль obfs, сервис не запущен. Проверьте ufw status и ss -lnup | grep hysteria |
x509: certificate relies on legacy Common Name field |
Самоподписанный сертификат без SAN. Пересоздайте его с -addext "subjectAltName=DNS:..." |
no certificate matches the pinned hash |
В клиенте старый отпечаток. После пересоздания сертификата обновите pinSHA256 во всех клиентах |
Сервис падает с permission denied на ключе |
Файлы сертификата принадлежат root. Выполните chown hysteria:hysteria для них |
| ACME не выдаёт сертификат | Домен не указывает на сервер или порты 80/443 по TCP заняты Nginx либо закрыты. Используйте свой сертификат |
| Низкая скорость | Уберите bandwidth из клиента и проверьте с BBR, затем подбирайте значения. Проверьте нагрузку на сервер |
Для защиты самого сервера настройте вход по SSH-ключам и fail2ban.