# Примеры ссылок и параметров

{% hint style="warning" %}
Данная информация **не является инструкцией по настройке VPN**, а также **не предназначено для обхода блокировок, доступа к запрещённым сайтам или приложениям**, нарушающим законодательство вашей страны.
{% endhint %}

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

### 1. Общие сведения

Приложение HAPP поддерживает современные протоколы для обеспечения безопасности и обхода блокировок: VLESS, VMess, Shadowsocks, Socks5, Trojan, Hysteria2 (включая `hy2`).

***

### 2. Способы добавления конфигураций

* Ручной ввод: Через кнопку «+» на главном экране. Позволяет детально настроить каждый параметр протокола.
* Импорт URL/QR: Автоматическое распознавание схем (`vless://`, `vmess://` и т.д.) из буфера обмена или через камеру.
* Подписки: \* *Стандартные:* Ссылки на текстовые списки серверов.
  * *JSON-массивы:* Расширенные наборы данных с преднастроенными ключами и маршрутами.

***

### 3. Особенности работы с JSON-конфигурациями

Если конфигурация сервера импортируется в формате JSON, приложение HAPP обрабатывает её особым образом при взаимодействии с ядром XRAY.

#### 3.1. Принцип прямой передачи (1:1)

При запуске ядра XRAY такая конфигурация передаётся в неизменённом виде.

> Важно: В этом режиме стандартные правила маршрутизации и настройки интерфейса HAPP не накладываются на JSON-файл. Конфигурация работает ровно так, как она прописана в исходном коде.

#### 3.2. Косвенное управление через HAPP

Несмотря на прямую передачу конфига, приложение сохраняет контроль над системным окружением ядра через профили маршрутизации:

* Управление GEO-файлами: Вы можете выбрать, какие базы геоданных будут переданы ядру.
* Оптимизация (Урезанные GEO-файлы): При активации этой функции ядро получит только необходимые фрагменты баз (с выбранными тегами), что экономит ресурсы.
* DNS-туннелирование: Параметры удаленного DNS (`Remote DNS`) берутся из активного профиля маршрутизации приложения и могут быть изменены пользователем для адаптации системы.

***

### 4. Расширенные параметры (URI Scheme)

#### 4.1. Hysteria 2 (`hy2://`)

| **Параметр**  | **Описание**                                         |
| ------------- | ---------------------------------------------------- |
| `auth`        | Данные для входа (`username:password` для userpass). |
| `port`        | Поддержка Multi-port: `1234,5000-6000,7044`.         |
| `obfs`        | Тип обфускации (напр. `salamander`).                 |
| `mportHopInt` | Интервал (сек) между переключением портов.           |

#### 4.2. Фрагментация и Шумы (Fragmentation & Noises)

Инструменты для борьбы с DPI. Настройки внутри сервера имеют приоритет только если выключены глобальные настройки приложения.

* Фрагментация: `fragment=length,interval,packets[,maxSplit]`
  * *Пример:* `fragment=1-10,5-20,tlshello`
* Шумы (работают только с фрагментацией): `noises=type,packet,delay[,applyTo]`
  * *Пример:* `noises=rand,50-150,10-50,ip`

***

### 5. Визуализация и Метаданные

Для наведения порядка в списке серверов используйте теги в конце ссылки после символа `#`:

1. Название (`title`): `#МойСервер` (до 30 символов).
2. Описание (`serverDescription`): Позволяет заменить технический текст (например, "VMess") на ваш.
   * *Формат:* `#Title?serverDescription=<base64_текст>`
   * *В JSON:* Поле `"meta": {"serverDescription": "Ваш текст"}`.

***

### 6. Примеры Socks5 proxy

Приложение понимает три формата записи:

* `socks://user:pass@1.2.3.4:443`
* `socks://<base64_user_pass>@1.2.3.4:443#Name`
* `socks://<полный_base64_строки>`