---
title: "Hysteria 2"
description: "Параметри Hysteria 2, налаштування TLS, посилання та можливості, які підтримує 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`, сервер надсилає з цією швидкістю навіть за втрати пакетів, використовуючи керування перевантаженням Brutal від Hysteria. Задайте значення, близьке до вашої справжньої швидкості завантаження: якщо воно завелике, з’єднання сповільнюється, а не пришвидшується. Залиште порожнім, і сервер сам підлаштує швидкість.

Пропускна здатність приймає число з одиницею (`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/uk/protocols/hysteria2/index.mdx