---
title: "Hysteria 2"
description: "Параметры, настройки TLS, ссылки и возможности Hysteria 2, которые поддерживает Potatso."
---

> Documentation Index
> Fetch the complete documentation index at: https://potatso.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Hysteria 2

Сервер Hysteria 2 описывается **паролем** и **настройками TLS**, а при необходимости еще и **обфускацией** и **сменой портов**. Hysteria 2 работает поверх QUIC — протокола на основе UDP, на котором построен HTTP/3, поэтому сохраняет скорость в сетях с потерей пакетов. Potatso подключается к серверу, если поддерживает его настройки. Используйте таблицы ниже, чтобы проверить настройки своего сервера, показанные провайдером или в его ссылке `hysteria2://`.

Сервер Hysteria 2 можно добавить вручную, с помощью [ссылки `hysteria2://` или `hy2://`](#links) или импортом:

- подписки Clash или Mihomo,
- конфигурации Xray,
- конфигурации Surge.

Potatso пока не импортирует серверы Hysteria 2 из конфигурации sing-box. Используйте вместо этого ссылку `hysteria2://` сервера.

## Аутентификация {#authentication}

| Аутентификация сервера | Поддержка |
| --- | --- |
| Пароль (`auth.type: password`) | ✅ |
| Имя пользователя и пароль (`auth.type: userpass`) | ✅ Введите их как один пароль: `name:password` |
| Аутентификатор HTTP или команда | ✅ Введите пароль, который он ожидает |

С неверным паролем подключение не устанавливается. Многие серверы показывают обычный сайт (маскировку) всем, у кого нет пароля.

## Обфускация {#obfuscation}

| Обфускация | Ключ Clash | Параметр ссылки | Поддержка |
| --- | --- | --- | --- |
| Нет | | | ✅ |
| Salamander | `obfs: salamander`, `obfs-password` | `obfs=salamander`, `obfs-password` | ✅ |
| Gecko | `obfs: gecko` | `obfs=gecko` | ❌ |

Salamander перемешивает каждый пакет, чтобы соединение не выглядело как QUIC. Пароль должен совпадать с паролем сервера. Задайте его в настройках сервера как **Пароль Salamander**. Для сервера без обфускации оставьте поле пустым.

Potatso не импортирует сервер с обфускацией Gecko, потому что не смог бы к нему подключиться.

## Пропускная способность {#bandwidth}

| Настройка | Ключ Clash | Поддержка |
| --- | --- | --- |
| Входящая пропускная способность | `down` | ✅ Сервер отправляет вам данные с такой скоростью |
| Исходящая пропускная способность | `up` | ❌ Potatso отправляет данные с управлением перегрузкой BBR и игнорирует эту настройку |
| Управление перегрузкой | `congestion` в официальном клиенте | ❌ Всегда BBR |

Когда вы задаете **входящую пропускную способность**, например `100 Mbps`, сервер отправляет данные с этой скоростью даже при потере пакетов, используя управление перегрузкой Hysteria Brutal. Задавайте значение, близкое к вашей реальной скорости скачивания: если оно слишком велико, соединение станет медленнее, а не быстрее. Если оставить поле пустым, сервер сам подстроит скорость.

Пропускная способность задается числом с единицей измерения (`bps`, `Kbps`, `Mbps`, `Gbps`) или просто числом в Mbps.

## Смена портов {#port-hopping}

Сервер со сменой портов слушает диапазон UDP-портов, а Potatso время от времени переходит между ними. Это помогает в сетях, которые через какое-то время замедляют или блокируют один UDP-порт.

| Настройка | Ключ Clash | Поддержка |
| --- | --- | --- |
| Порты | `ports` | ✅ Диапазон вида `20000-30000`, список вида `443,8443` или то и другое |
| Интервал смены порта | `hop-interval` | ✅ В секундах, по умолчанию 30, минимум 5. Диапазон вида `10-30` выбирает случайный интервал. |

Задайте их в настройках сервера как **Смена портов** и **Интервал смены порта**. Порт сервера тогда используется только для первого подключения.

## TLS {#tls}

| Настройка | Ключ Clash | Параметр ссылки | Поддержка |
| --- | --- | --- | --- |
| Имя сервера (SNI) | `sni` | `sni`, `peer` | ✅ Если не задано, Potatso использует адрес сервера. |
| Не проверять сертификат | `skip-cert-verify` | `insecure` | ✅ |
| Закрепление сертификата (SHA-256) | `fingerprint` | `pinSHA256` | ✅ |
| ALPN | `alpn` | `alpn` | ✅ Только `h3`, который Potatso всегда и использует |
| Свой сертификат CA | `ca` в официальном клиенте | | ❌ |
| Клиентский сертификат TLS | `certificate`, `private-key` | | ❌ |
| Encrypted Client Hello (ECH) | `ech-opts` | `ech` | ❌ |
| Проверка по другому имени | `name-cert-verify` | | ❌ |

Отключение проверки сертификата позволяет любому между вами и сервером читать ваш трафик. Многие серверы Hysteria 2 используют самоподписанный сертификат: закрепите его. Укажите SHA-256 сертификата сервера как закрепление сертификата. С закреплением Potatso доверяет этому сертификату и никакому другому, независимо от его имени.

Potatso не импортирует сервер, которому нужна одна из неподдерживаемых выше настроек, потому что он подключился бы без нее, а сервер не ответил бы.

## UDP {#udp}

Hysteria 2 передает UDP в датаграммах QUIC по тому же соединению, что и TCP. UDP по умолчанию включен. Выключайте «Ретрансляция UDP» в настройках сервера, только если на вашем сервере UDP отключен (`disableUDP`).

Через сервер Xray пакеты UDP больше примерно 1100 байт приходят поврежденными. Это ошибка сервера Hysteria 2 в Xray. Официальный сервер, sing-box и mihomo ретранслируют пакеты любого размера.

## Поддержка возможностей {#features}

| Возможность | Поддержка |
| --- | --- |
| [Протокол Hysteria 2](https://v2.hysteria.network/docs/developers/Protocol/): аутентификация HTTP/3, потоки TCP | ✅ |
| UDP в датаграммах QUIC, включая большие пакеты, разбитые на фрагменты | ✅ |
| Много соединений в одном соединении QUIC | ✅ |
| Обфускация Salamander | ✅ |
| Обфускация Gecko | ❌ |
| [Входящая пропускная способность](#bandwidth) (Brutal на сервере) | ✅ |
| Исходящая пропускная способность (Brutal с вашего устройства) | ❌ |
| [Смена портов](#port-hopping) | ✅ |
| Fast open (на один круговой обмен меньше на соединение) | ✅ Всегда включен |
| Закрепление сертификата, отключение проверки сертификата | ✅ |
| ECH, свой CA, клиентские сертификаты TLS | ❌ |
| Realms (подключение через сервер-посредник) | ❌ |
| Fake TCP (`mimic`) | ❌ |
| Свои окна управления потоком QUIC, `cwnd`, `udp-mtu` | ❌ |
| Ссылки `hysteria2://` и `hy2://` | ✅ |

Каждая поддерживаемая возможность проверена как минимум на одном настоящем сервере Hysteria 2: [официальном сервере](https://v2.hysteria.network/), [sing-box](https://sing-box.sagernet.org/), [mihomo](https://wiki.metacubex.one/) или [Xray](https://xtls.github.io/).

Некоторые возможности официального клиента Hysteria — это настройки его собственной программы, а Potatso решает ту же задачу по-своему:

- Маршрутизация и ACL: используйте правила в своем профиле.
- Локальные серверы SOCKS5 и HTTP, перенаправление и режим TUN: Potatso сам перехватывает трафик вашего устройства.
- Ленивое подключение: Potatso подключается, когда трафику нужен сервер.

Настройки на стороне сервера, такие как сайт-маскировка, тест скорости или собственные ограничения пропускной способности сервера, ничего не требуют на вашем устройстве.

## Ссылки `hysteria2://` {#links}

Ссылка `hysteria2://` содержит весь сервер в одной строке. `hy2://` — та же ссылка с более коротким названием.

```text
hysteria2://password@host:port/?parameters#name
```

| Часть | Описание |
| --- | --- |
| `password` | Пароль с процентным кодированием. Для имени пользователя и пароля запишите `name:password`. |
| `host` | Адрес сервера. Адрес IPv6 заключайте в квадратные скобки, например `[2001:db8::1]`. |
| `port` | Порт сервера. Если его нет, Potatso использует 443. Для [смены портов](#port-hopping) перечислите порты здесь, например `443,20000-30000`. |
| `name` | Необязательно. Название сервера в Potatso. |

Параметры следуют [официальному формату](https://v2.hysteria.network/docs/developers/URI-Scheme/):

| Параметр | Описание |
| --- | --- |
| `sni` | Имя сервера TLS. |
| `insecure` | `1` отключает проверку сертификата. |
| `pinSHA256` | SHA-256 сертификата сервера. |
| `obfs`, `obfs-password` | `salamander` и его пароль. |
| `mport` | Порты для смены портов — так их записывают некоторые приложения вместо порта. |
| `hop-interval` | Интервал смены порта в секундах. |
| `up`, `down` | Исходящая и входящая пропускная способность — так их записывают некоторые приложения. |

Potatso не импортирует ссылку с `obfs=gecko` или `ech`. Ссылки `hysteria2+realm://` он тоже не импортирует.

Когда Potatso делится сервером Hysteria 2, он предлагает ссылку `hysteria2://`, где порты для смены указаны в порте либо в `mport`.

### Примеры {#link-examples}

В каждом примере показана ссылка для импорта. Пароль — `secret`.

Обычный сервер:

```text
hysteria2://secret@hy2.example.com:443/?sni=hy2.example.com#Basic
```

Обфускация Salamander с паролем `hidden`:

```text
hysteria2://secret@hy2.example.com:443/?obfs=salamander&obfs-password=hidden#Salamander
```

Смена портов между 20000 и 30000:

```text
hysteria2://secret@hy2.example.com:443,20000-30000/?sni=hy2.example.com#Hopping
```

Самоподписанный сертификат, закрепленный:

```text
hysteria2://secret@203.0.113.7:443/?sni=hy2.example.com&pinSHA256=abababababababababababababababababababababababababababababababab#Pinned
```

Source: https://potatso.com/docs/ru/protocols/hysteria2/index.mdx