Расширенный функционал
Расширенный функционал включает два направления:
Управление почти всеми настройками приложения
Уникальные функции для обхода блокировок
Чтобы включить любой параметр, передайте значение true или 1 ; чтобы отключить — любое другое непустое значение (например, 0).
Уникальные функции
Смена URL подписки
Если домен заблокирован вашим провайдером, а пользователи могут подключаться к серверам и обновлять подписку только через VPN, этот параметр именно для вас. Задав новое доменное имя в значении данного параметра, вы обеспечите его автоматическую замену у всех пользователей подписки.
Пример настройки данного параметра:
new-url: [url]Способы передачи:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
new-url: https://mynew-domain.com/3J3jrb4jfc#new-url https://mynew-domain.com/3J3jrb4jfc
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…Смена домена подписки
Изменение домена сайта без смены полного URL, сохраняя остальную часть адреса.
Пример настройки данного параметра:
new-domain: [domain]Способы передачи:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
new-domain: mynew-domain.com#new-domain mynew-domain.com
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…Описание сервера в подписке
Доступно только при наличии премиум ProviderID. Позволяет задать дополнительную подпись, которая отображается под названием сервера вместо стандартного текста (например, "VMess", "VLESS", "Trojan").
Максимальная длина — 30 символов.
Если не помещается на экран, будет сокращена с троеточием.
Задаётся после
titleчерез разделитель?.
Примеры:
vless://[email protected]:443?encryption=none&node_id=482&headerType=none&type=tcp&security=reality&sni=booking.com&fp=chrome&pbk=YqHW8a4iAc1SZYpTrFVoOQg1F3yAdX1tWXuROZUCsEU&sid=6ba85179e30d4fc2&flow=xtls-rprx-vision&xtls=2#title?serverDescription=SGFwcCB0aGUgYmVzdA==vmess://eyJob3N0IjoiZWxhaG9tZWtpdGNoZW4uY29tIiwicGF0aCI6IiIsInRscyI6IiIsImFkZCI6ImVsYWhvbWVraXRjaGVuLmNvbSIsInBvcnQiOjUwMDAsImFpZCI6MCwibmV0IjoidGNwIiwidHlwZSI6Im5vbmUiLCJ2IjoiMiIsInBzIjoi4piB77iPIDogNTMuM0dCIiwiaWQiOiI4N2ZhN2VmMC1jM2ZjLTNiOTAtYTJkOC01OGZjYjhkZmZmMjYiLCJzZXJ2ZXJEZXNjcmlwdGlvbiI6IkhhcHAgdGhlIGJlc3QifQ==trojan://[email protected]:443?security=tls&insecure=1&fragment=3,1,tlshello&type=ws&headerType=&path=%2F&host=quictest.burncommunity.ru&sni=quictest.burncommunity.ru&fp=chrome&alpn=http%2F1.1#title?serverDescription=SGFwcCB0aGUgYmVzdA==socks://pkg-private2-country-us-city-new_york_city:[email protected]:1080#title?serverDescription=SGFwcCB0aGUgYmVzdA==ss://[email protected]:9042#title?serverDescription=SGFwcCB0aGUgYmVzdA==wireguard://[email protected]:10803?publickey=asd33d223d33&address=dom.ru&allowinsecure=1&mtu=1500&reserved=1,22,33#title?serverDescription=SGFwcCB0aGUgYmVzdA=={
"dns": {
...
},
"inbounds": [
...
],
"outbounds": [
...
],
"remarks": "🇭🇰 Hong Kong",
"meta": {
"serverDescription": "Happ the best"
}
}Фрагментация и фронтинг подписки
Некоторые CDN поддерживают фронтинг доменов. Это позволяет подключаться к своему сайту через сторонний домен.
Например, указав адрес подключения visa.com, а в заголовке Host — my-domain.com, провайдер увидит только запрос к visa.com.
Также вы можете обращаться к своему домену за списком серверов, используя фрагментацию пакетов в SNI TLSHello.
По умолчанию фрагментация включена для всех подписок. Пользователь может добавить подписку только один раз; при повторной попытке, если аккаунт не премиумный, обновление не будет разрешено.
Схема URL c параметрами
[link]#title?[fragment]&[resolve-address]&[host]&[insecure]
Fronting:
visa.com/123#MyVPN?resolve-address=visa.com&host=mydomain.com
Frgmentation:
mydomain.com/123#MyVPN?fragment=80-250,10-100,tlshelloФрагментация содержит три параметра: [length], [interval] и [packets].
При использовании фронтинга необходимо сначала указать URL с доменом, через который будет осуществляться соединение. Также требуется задать resolve-address — это может быть домен или IP-адрес — и host, соответствующий вашему хосту в сети выбранного провайдера.
Advanced fragmentation
Данная функция пока что проходит закрытое тестирование и скоро будет доступна...
Неотключаемый HWID
По умолчанию HWID включен на всех приложениях Happ. Но если вы хотите, чтобы пользователь не мог отключить пересылку этого параметра отключив его в настройках приложения, то вы можете отправить вместе с подпиской специальный параметр.
Пример настройки данного параметра:
Способы передачи:
Уведомление об окончании подписки
Вы можете включить функцию автоматических уведомлений о завершении подписки. Пользователь будет получать напоминания за 3 дня до окончания подписки: приложение отправит по одному уведомлению в день в течение трёх дней. Это поможет пользователю не забыть продлить подписку вовремя.
Текст уведомления:
Пример настройки данного параметра:
Способы передачи:
Скрыть настройки серверов в подписке
Отключите возможность просмотра и редактирования конфигураций серверов для пользователей вашей подписки. Настройка применяется как к уже добавленным подпискам, так и к тем, что будут добавлены в будущем.
Пример настройки данного параметра:
Способы передачи:
Резолвинг доменов
Приложение может выполнять предварительное резолвинг доменов серверов ещё до установления подключения. Вы можете указать любой DoH-сервер, и при соединении с сервером Xray доменное имя будет заменено на полученный IP-адрес.
Если для домена возвращается несколько IP-адресов, приложение автоматически выберет тот, у которого минимальное время отклика (ping). Однако стоит учитывать: при большом количестве IP-адресов подключение может занять больше времени, так как все варианты будут протестированы заранее.
Пример настройки данного параметра:
Способы передачи:
Управление настройками приложения
Автоподключение
Позволяет автоматически подключать пользователя к серверам при запуске приложения. Дополнительно, с помощью параметра subscription-autoconnect можно указать критерий для подключения к определенному серверу.
Пример настройки данного параметра:
Способы передачи:
Автопинг
Запускайте автоматическое тестирование списка серверов при открытии приложения если это необходимо.
Пример настройки данного параметра:
Способы передачи:
Автообновление подписок
В приложении можно включать или отключать автообновление сразу для всех подписок — эта настройка применяется ко всем подпискам одновременно. Если же нужно задать автообновление только для конкретной подписки, воспользуйтесь бесплатным функционалом и инструкциями в общей документации. При отключении глобальной настройки каждая подписка самостоятельно определяет своё время обновления.
Пример настройки данного параметра:
Способы передачи:
Фрагментация
Это глобальный параметр управления фрагментацией для всех подписок. Если же нужно назначить фрагментацию только для конкретной подписки или серверу, воспользуйтесь бесплатным функционалом и инструкциями общей документации к приложению. При отключении глобальной настройки каждая подписка самостоятельно определяет настройки фрагментации.
Пример настройки данного параметра:
Способы передачи:
Пинг
Эта функция позволяет выбрать способ выполнения пинга в приложении. Доступны три варианта: «via Proxy», «TCP» и «ICMP». Для режима «via Proxy» можно дополнительно указать URL для проверки пинга.
Пример настройки данного параметра:
Способы передачи:
User-Agent
Эта функция позволяет изменить User-Agent, используемый в заголовках при получении подписки. Полезно в случаях, когда провайдер блокирует запросы с нестандартными или неподходящими заголовками.
Пример настройки данного параметра:
Способы передачи:
Автозапуск приложения
Эта функция позволяет автоматически запускать приложение при включении устройства. В настоящее время доступна только на Android.
Пример настройки данного параметра:
Способы передачи:
Обновление подписки при запуске приложения
Эта функция автоматически обновляет все подписки в приложении при каждом открытии приложения.
Пример настройки данного параметра:
Способы передачи:
Прокси для выбранных приложений (Android)
В этом параметре можно указать список приложений, которые должны использовать VPN или, наоборот, обходить его. Если приложение ещё не установлено на устройстве, но указано в списке, оно будет автоматически учтено при первом подключении к VPN после установки.
Пример настройки данного параметра:
Способы передачи:
Анализ пакетов (Sniffing)
В xray-core sniffing нужен, чтобы анализировать первые пакеты соединения и автоматически определять протокол (HTTP, TLS, BitTorrent и т.д.) и домен (SNI/Host). Может влиять на загрузку медиа в приложении WeChat. По умолчанию включен.
Пример настройки данного параметра:
Способы передачи:
Запрет сворачивания подписок
Эта функция отключает возможность сворачивать подписку: список серверов всегда отображается полностью, в развёрнутом виде.
Пример настройки данного параметра:
Способы передачи:
Режим отображения пинга
Позволяет отобразить иконки вместо временных значений
Пример настройки данного параметра:
Способы передачи:
Mux
Mux в xray-core — это функция мультиплексирования (multiplexing), которая позволяет передавать данные нескольких виртуальных TCP-соединений через одно физическое TCP-соединение. Она предназначена для снижения задержек от TCP-handshake, но не для повышения пропускной способности (может даже замедлить большие загрузки). Настраивается в outbound-конфигурации с параметрами вроде enabled и concurrency (min -1 max 1024).
Пример настройки данного параметра:
Способы передачи:
Last updated