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

{% 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_строки>`


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://www.happ.su/main/ru/dev-docs/examples-of-links-and-parameters.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.