Перейти к содержимому

Статья 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

Откройте /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: true
  • listen: :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/hysteria
openssl 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.crt
chmod 600 server.key

chown нужен, потому что сервис запущен от пользователя 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.service
systemctl status hysteria-server.service
journalctl --no-pager -e -u hysteria-server.service

В журнале должна появиться строка:

INFO server mode
INFO server up and running {"listen": ":443"}

После любой правки конфига: systemctl restart hysteria-server.service.

Hysteria 2 работает по UDP. Откройте именно UDP-порт:

Окно терминала
ufw allow 443/udp
ufw 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:443
auth: ДЛИННЫЙ_ПАРОЛЬ
tls:
sni: hy.example.com
insecure: true
pinSHA256: AB:CD:...
socks5:
listen: 127.0.0.1:1080
http:
listen: 127.0.0.1:8080
Окно терминала
hysteria client -c client.yaml
curl --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/) --remove
rm -rf /etc/hysteria
userdel -r hysteria
ufw 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.