Управление приложением

Управляйте настройками приложения через подписку

Функционал управление приложения включает два направления:

Стандартные параметры управления которые работают для большиства панелей.
Расширенные параметры для которых необходимо указывать Provider ID в подписке.

Чтобы активировать параметр, передайте значение true или 1 ; чтобы отключить — любое другое непустое значение (например, 0 или false).

Стандартные параметры

Автообновление подписки

В системе создаётся задача на выполнение операции с заданным интервалом. В зависимости от внутренних приоритетов система старается запустить обновление подписки в установленное время. Если по какой-либо причине обновление не было выполнено в пределах указанного интервала, оно произойдёт автоматически при следующем запуске приложения. Интервал задаётся в часах и должен быть кратен одному часу.

Пример настройки данного параметра:

profile-update-interval: [int]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
profile-update-interval: 1

Через тело подписки:

#profile-update-interval: 1
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Имя подписки

Название профиля подписки. Может быть передано как plain text или в base64 (UTF-8). Ограничение: Максимальная длина — 25 символов.

Через тело подписки, указав перед параметром знак # (например #profile-title)

Пример настройки данного параметра:

profile-title: [string]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
profile-title: Name VPN

Через тело подписки:

#profile-title: Name VPN
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Строка состояния подписки (трафик, дата истечения)

Отображается информация о балансе, объёме использованного трафика и сроке действия подписки. В приложении левой части шкалы показано количество израсходованного трафика (upload + download), а в правой — общий объём (total) после символа «/». Дата окончания подписки указывается в параметре expire. Примечание: все данные передаются в одном заголовке и разделяются символом ;.

Пример настройки данного параметра:

subscription-userinfo: [string]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
subscription-userinfo: upload=0; download=2153701362; total=0; expire=1790951622

Через тело подписки:

№subscription-userinfo: upload=0; download=2153701362; total=0; expire=1790951622
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Ссылка на страницу поддержки

Кнопка для перехода на страницу поддержки. Отображается в виде синей иконки, расположенной в правой части строки. Если ссылка ведёт в Telegram, отображается иконка Telegram; в остальных случаях используется стандартная иконка ссылки.

Пример настройки данного параметра:

support-url: [string]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
support-url: https://t.me/happ_chat

Через тело подписки:

#support-url: https://t.me/happ_chat
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Ссылка на страницу сайта

Кнопка для перехода на страницу сайта подписки. Отображается в виде синей иконки, расположенной в левой части строки. Если параметр не задан иконка будет серого цвета

Пример настройки данного параметра:

profile-web-page-url: [string]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
profile-web-page-url: https://happ.su

Через тело подписки:

#profile-web-page-url: https://happ.su
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Объявление

Подписка может содержать текст объявления, передаваемый в формате plain text или Base64. Ограничение: максимальная длина отображаемого текста — 200 символов.

Пример настройки данного параметра:

announce: [string]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
announce: base64:SGFwcCB0aGUgYmVzdCE=

Через тело подписки:

#announce: base64:SGFwcCB0aGUgYmVzdCE=
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Отключение маршрутизации

Глобальный параметр для отключения маршрутизации в приложении.

Пример настройки данного параметра:

routing-enable: [string]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
routing-enable: 0

Через тело подписки:

#routing-enable: 0
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Конфигурация туннеля (только для Desktop)

Передавайте собственную конфигурацию туннеля для ядра sing-box

Пример настройки данного параметра:

custom-tunnel-config: [json]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
custom-tunnel-config: {...}

Через тело подписки:

#custom-tunnel-config: {...}
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Расширенные параметры

Необходим параметр Provider ID!

Смена URL подписки

Если домен заблокирован вашим провайдером, а пользователи могут подключаться к серверам и обновлять подписку только через VPN, этот параметр именно для вас. Задав новое доменное имя в значении данного параметра, вы обеспечите его автоматическую замену у всех пользователей подписки.

Пример настройки данного параметра:

new-url: [url]

Способы передачи:

Через HTTP Headers:

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 Headers:

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…

Описание сервера в подписке

Позволяет задать дополнительную подпись, которая отображается под названием сервера вместо стандартного текста (например, "VMess", "VLESS", "Trojan").

Максимальная длина — 30 символов.
Если не помещается на экран, будет сокращена с троеточием.
Задаётся после title через разделитель ?.

Примеры:

VLESS

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

vmess://eyJob3N0IjoiZWxhaG9tZWtpdGNoZW4uY29tIiwicGF0aCI6IiIsInRscyI6IiIsImFkZCI6ImVsYWhvbWVraXRjaGVuLmNvbSIsInBvcnQiOjUwMDAsImFpZCI6MCwibmV0IjoidGNwIiwidHlwZSI6Im5vbmUiLCJ2IjoiMiIsInBzIjoi4piB77iPIDogNTMuM0dCIiwiaWQiOiI4N2ZhN2VmMC1jM2ZjLTNiOTAtYTJkOC01OGZjYjhkZmZmMjYiLCJzZXJ2ZXJEZXNjcmlwdGlvbiI6IkhhcHAgdGhlIGJlc3QifQ==

Trojan

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==

Socks5

socks://pkg-private2-country-us-city-new_york_city:[email protected]:1080#title?serverDescription=SGFwcCB0aGUgYmVzdA==

Shadowsocks

ss://[email protected]:9042#title?serverDescription=SGFwcCB0aGUgYmVzdA==

Wireguard

wireguard://[email protected]:10803?publickey=asd33d223d33&address=dom.ru&allowinsecure=1&mtu=1500&reserved=1,22,33#title?serverDescription=SGFwcCB0aGUgYmVzdA==

JSON

{
  "dns": {
  ...
  },
  "inbounds": [
  ...
  ],
  "outbounds": [
  ...
  ],
  "remarks": "🇭🇰 Hong Kong",
  "meta": {
    "serverDescription": "Happ the best"
  }
}

Расширенные объявления

Более заметные обьявления. Делятся на два типа: произвольный информационный текст (sub-info) и системное уведомление об окончании подписки (sub-expire).

Уведомления об истечении подписки имеют приоритет и отображаются автоматически за 3 дня до окончания или после истечения. Информационный блок показывается только при отсутствии активного expire-сообщения.

Оба механизма можно явно отключить через http headers. Если параметры были переданы и не отменены, они остаются активными до удаления подписки.

| META PARAM KEY              | TYPE     | REQUIRED | LIMITS / VALUES                  | DESCRIPTION |
|----------------------------|----------|----------|----------------------------------|-------------|
| sub-info-color             | String   | No       | red, blue, green (default blue)  | Цвет информационного блока |
| sub-info-text              | String   | Yes*     | max 200 chars                    | Основной текст инфо-блока. Без параметра блок не отображается. Пустая строка отключает отображение |
| sub-info-button-text       | String   | No       | max 25 chars                     | Текст кнопки. Если отсутствует — кнопка не показывается |
| sub-info-button-link       | String   | No       | any string (URL / deeplink)      | Ссылка кнопки. Открывается в браузере, без валидации |
| sub-expire                 | Boolean  | No       | true \| 1 = enabled              | Включает механизм показа информации об истечении подписки |
| sub-expire-button-link     | String   | No       | any string (URL / deeplink)      | Ссылка на кнопку «Продлить». Без ссылки кнопка не показывается |

Логика отображения (summary)

| CONDITION | RESULT |
|----------|--------|
| sub-expire = true и подписка истекает ≤ 3 дней | Показываем сообщение «Ваша подписка заканчивается через N д.» |
| sub-expire = true и подписка истекла | Показываем сообщение «Подписка закончилась!» |
| sub-expire = true и дней > 3 | Сообщение об истечении скрывается |
| Нет даты истечения | Информация об истечении не отображается |
| Есть активное expire-сообщение | sub-info блок не показывается |
| Нет expire-сообщения и есть sub-info-text | Показываем sub-info блок |
| sub-info-text = "" | sub-info блок отключается |
| sub-expire ≠ true \| 1 | Механизм expire отключается |

Примечания

| NOTE |
|------|
| Параметры применяются только к той подписке, для которой они были переданы |
| Если параметры пришли через push и не были явно отключены, они остаются активными бессрочно |
| Кнопка expire всегда имеет текст «Продлить» |
| Количество дней (N) считается как полные дни, максимум 3 |

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
sub-expire: 1
sub-expire-button-link: https:/t.me/generate

Через тело подписки:

#sub-expire: 1
##sub-expire-button-link: https:/t.me/generate
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Фрагментация и фронтинг подписки

Некоторые 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. Но если вы хотите, чтобы пользователь не мог отключить пересылку этого параметра отключив его в настройках приложения, то вы можете отправить вместе с подпиской специальный параметр.

Пример настройки данного параметра:

subscription-always-hwid-enable: [true / 1]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
subscription-always-hwid-enable: 1

Через тело подписки:

#subscription-always-hwid-enable: 1
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Уведомление об окончании подписки

Вы можете включить функцию автоматических уведомлений о завершении подписки. Пользователь будет получать напоминания за 3 дня до окончания подписки: приложение отправит по одному уведомлению в день в течение трёх дней. Это поможет пользователю не забыть продлить подписку вовремя.

Текст уведомления:

 У вашей подписки [name] скоро истечёт срок действия, не забудьте продлить её.

Пример настройки данного параметра:

notification-subs-expire: [true / 1]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
notification-subs-expire: 1

Через тело подписки:

#notification-subs-expire: 1
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Скрыть настройки серверов в подписке

Отключите возможность просмотра и редактирования конфигураций серверов для пользователей вашей подписки. Настройка применяется как к уже добавленным подпискам, так и к тем, что будут добавлены в будущем.

Пример настройки данного параметра:

hide-settings: [true / 1]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
hide-settings: 1

Через тело подписки:

#hide-settings: 1
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Резолвинг доменов

Приложение может выполнять предварительное резолвинг доменов серверов ещё до установления подключения. Вы можете указать любой DoH-сервер, и при соединении с сервером Xray доменное имя будет заменено на полученный IP-адрес.

Если для домена возвращается несколько IP-адресов, приложение автоматически выберет тот, у которого минимальное время отклика (ping). Однако стоит учитывать: при большом количестве IP-адресов подключение может занять больше времени, так как все варианты будут протестированы заранее.

Пример настройки данного параметра:

server-address-resolve-enable: [true / 1]
server-address-resolve-dns-domain: [url]
server-address-resolve-dns-ip: [ip]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
server-address-resolve-enable: 1
server-address-resolve-dns-domain: https://common.dot.dns.yandex.net/dns-query
server-address-resolve-dns-ip: 77.88.8.8

Через тело подписки:

#server-address-resolve-enable: 1
#server-address-resolve-dns-domain: https://common.dot.dns.yandex.net/dns-query
#server-address-resolve-dns-ip: 77.88.8.8
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Управление настройками приложения

Необходим параметр Provider ID!

Автоподключение

Позволяет автоматически подключать пользователя к серверам при запуске приложения. Дополнительно, с помощью параметра subscription-autoconnect можно указать критерий для подключения к определенному серверу.

Пример настройки данного параметра:

subscription-autoconnect: [true / 1]
subscription-autoconnect-type: [“lastused“/”lowestdelay”]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
subscription-autoconnect: 1
subscription-autoconnect-type: lowestdelay

Через тело подписки:

#subscription-autoconnect: 1
#subscription-autoconnect-type: lastused
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Автопинг

Запускайте автоматическое тестирование списка серверов при открытии приложения если это необходимо.

Пример настройки данного параметра:

subscription-ping-onopen-enabled: [true / 1]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
subscription-ping-onopen-enabled: 1

Через тело подписки:

#subscription-ping-onopen-enabled: 1
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Автообновление подписок

В приложении можно включать или отключать автообновление сразу для всех подписок — эта настройка применяется ко всем подпискам одновременно. Если же нужно задать автообновление только для конкретной подписки, воспользуйтесь функционалом Автообновление подписки. При отключении глобальной настройки каждая подписка самостоятельно определяет своё время обновления.

Пример настройки данного параметра:

subscription-auto-update-enable: [true / 1]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
subscription-auto-update-enable: 1

Через тело подписки:

#new-url: https:/mynew-domain.com/3J3jrb4jfc
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Фрагментация

Это глобальный параметр управления фрагментацией для всех подписок. Если же нужно назначить фрагментацию только для конкретной подписки или серверу, воспользуйтесь бесплатным функционалом и инструкциями общей документации к приложению. При отключении глобальной настройки каждая подписка самостоятельно определяет настройки фрагментации.

Пример настройки данного параметра:

fragmentation-enable: [true / 1]
fragmentation-packets: [tlshello,1-2,1-3,1-5]
fragmentation-length: [50-100]
fragmentation-interval: [10-20]
fragmentation-maxsplit: [String]
noises-enable: [true / 1]
noises-type: [rand. str, base64]
noises-packet: [String]
noises-delay: [String]
noises-applyto: [ip,ipv4,ipv6]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
fragmentation-enable: 1
fragmentation-packets: tlshello
fragmentation-length: 50-100
fragmentation-interval: 5
fragmentation-maxsplit: 100-200
noises-enable: 1
noises-type: rand
noises-packet: 10-20
noises-delay: 10-16
noises-applyto: ipv4

Через тело подписки:

#fragmentation-enable: 1
#fragmentation-packets: tlshello
#fragmentation-length: 50-100
#fragmentation-interval: 5
#fragmentation-maxsplit: 100-200
#noises-enable: 1
#noises-type: rand
#noises-packet: 10-20
#noises-delay: 10-16
#noises-applyto: ipv4
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Пинг

Эта функция позволяет выбрать способ выполнения пинга в приложении. Доступны три варианта: «via Proxy», «TCP» и «ICMP». Для режима «via Proxy» можно дополнительно указать URL для проверки пинга.

Пример настройки данного параметра:

ping-type: ["proxy", "proxy-head', "tcp","icmp"]
check-url-via-proxy: [url]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
ping-type: proxy
check-url-via-proxy: https://cp.cloudflare.com/generate_204

Через тело подписки:

#ping-type proxy
#check-url-via-proxy: https://cp.cloudflare.com/generate_204
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

User-Agent

Эта функция позволяет изменить User-Agent, используемый в заголовках при получении подписки. Полезно в случаях, когда провайдер блокирует запросы с нестандартными или неподходящими заголовками.

Пример настройки данного параметра:

change-user-agent: [String]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
change-user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36

Через тело подписки:

#change-user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Автозапуск приложения

Эта функция позволяет автоматически запускать приложение при включении устройства. В настоящее время доступна только на Android.

Пример настройки данного параметра:

app-auto-start: [String]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
app-auto-start: 1

Через тело подписки:

#app-auto-start: 1
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Обновление подписки при запуске приложения

Эта функция автоматически обновляет все подписки в приложении при каждом открытии приложения.

Пример настройки данного параметра:

subscription-auto-update-open-enable: [String]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
subscription-auto-update-open-enable: 1

Через тело подписки:

#subscription-auto-update-open-enable: 1
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Прокси для выбранных приложений (Android)

В этом параметре можно указать список приложений, которые должны использовать VPN или, наоборот, обходить его. Если приложение ещё не установлено на устройстве, но указано в списке, оно будет автоматически учтено при первом подключении к VPN после установки.

Пример настройки данного параметра:

per-app-proxy-mode: [off/on/bypass] \\Укажите один из трех параметров
per-app-proxy-list: [com.google.chrome,com.meta.instagram] \\список appID через ','

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
per-app-proxy-mode: on
per-app-proxy-list: com.google.chrome,com.meta.instagram

Через тело подписки:

#per-app-proxy-mode: on
#per-app-proxy-list: com.google.chrome,com.meta.instagram
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Анализ пакетов (Sniffing)

В xray-core sniffing нужен, чтобы анализировать первые пакеты соединения и автоматически определять протокол (HTTP, TLS, BitTorrent и т.д.) и домен (SNI/Host). Может влиять на загрузку медиа в приложении WeChat. По умолчанию включен.

Пример настройки данного параметра:

sniffing-enable: [String]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
sniffing-enable: 1

Через тело подписки:

#sniffing-enable: 1
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Запрет сворачивания подписок

Эта функция отключает возможность сворачивать подписку: список серверов всегда отображается полностью, в развёрнутом виде.

Пример настройки данного параметра:

subscriptions-collapse: [false / 0]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
subscriptions-collapse: 0

Через тело подписки:

#subscriptions-collapse: 0
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Режим отображения пинга

Позволяет отобразить иконки вместо временных значений

Пример настройки данного параметра:

ping-result: [time,icon]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
ping-result: icon

Через тело подписки:

#ping-result: icon
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Mux

Mux в xray-core — это функция мультиплексирования (multiplexing), которая позволяет передавать данные нескольких виртуальных TCP-соединений через одно физическое TCP-соединение. Она предназначена для снижения задержек от TCP-handshake, но не для повышения пропускной способности (может даже замедлить большие загрузки). Настраивается в outbound-конфигурации с параметрами вроде enabled и concurrency (min -1 max 1024).

Пример настройки данного параметра:

mux-enable: [true / 1]
mux-tcp-connections: [String]
mux-xudp-connections: [String]
mux-quic: [String]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
mux-enable: 1
mux-tcp-connections: 100
mux-xudp-connections: 200
mux-quic: skip

Через тело подписки:

#mux-enable: 1
#mux-tcp-connections: 100
#mux-xudp-connections: 200
#mux-quic: skip
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Режим Proxy \ TUN (только для Desktop)

Необходимо использовать только один из двух перечисленных параметров! Эти параметры определяют тип подключения при добавлении\обновлении подписки.

Пример настройки данного параметра:

proxy-enable: [true / 1]
tun-enable: [true / 1]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
proxy-enable: 1

Через тело подписки:

#proxy-enable: 1
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Режим TUN (только для Desktop)

Определяет какой режим будет использоваться для TUN подключения.

system — использует системный сетевой стек ОС. Быстро и эффективно, но зависит от корректной настройки маршрутов и файрвола .
gvisor — пользовательский стек gVisor (userspace). Меньше зависимостей от правил ядра и конфликтов с iptables/nftables/Docker, лучше изоляция; возможен небольшой минус к производительности.

Пример настройки данного параметра:

tun-mode: [system,gvisor]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
tun-mode: gvisor

Через тело подписки:

#tun-mode: gvisor
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Выбор ядра туннеля (только для Desktop)

Определяет какое ядро будет использоваться для TUN подключения. Для выбора доступно sing-box, tun2proxy

Пример настройки данного параметра:

tun-type: [singbox, tun2proxy]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
tun-type: tun2proxy

Через тело подписки:

#tun-type: tun2proxy
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Exclude routes

Определяет перечень подсетей и IP-адресов, трафик которых не должен проходить через туннель. Адреса указываются в одной строке, разделяя их пробелами и запятыми.

Пример настройки данного параметра:

exclude-routes: [String]

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
exclude-routes: 192.169.1.0/24, 10.0.0.0/8

Через тело подписки:

#exclude-routes: 192.169.1.0/24, 10.0.0.0/8
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

Темы (только iOS)

Позволяет изменить цветовую тему на персональную. Собственную тему можно создать в редакторе — удерживайте надпись «Тема оформления» для вызова меню. Созданную тему можно экспортировать в буфер обмена, а также импортировать из буфера, из файла .happ или передать через подписку.

VIOLET Theme

{
  "backgroundGradientRotationAngle" : 37.1,
  "serverRowBackgroundColor" : "#21003D67",
  "subsHeaderColor" : "#42296DFF",
  "profileWebPageIconColor" : "#A2B8FFFF",
  "selectedServerRowColor" : "#3E2F62B5",
  "disclosureSubHeaderTextColor" : "#C1C2E2FF",
  "buttonTextColor" : "#FFFFFFFF",
  "buttonTimerColor" : "#FFFFFFFF",
  "subscriptionInfoBackgroundColor" : "#21003CFF",
  "backgroundColors" : [
    "#3D2A7DFF",
    "#6557BAFF",
    "#9377FF7F"
  ],
  "disclosureHeaderTextColor" : "#FFFFFFFF",
  "backgroundGradientColorIntensity" : 1,
  "additionalOptionsButtonColor" : "#FFFFFFFF",
  "buttonImageType" : "light",
  "serverRowSubTitleTextColor" : "#C1C2E2FF",
  "supportIconColor" : "#FFFFFFFF",
  "topBarButtonsColor" : "#FFFFFFFF",
  "subscriptionTrafficBackgroundColor" : "#533EA7FF",
  "subHeaderButtonColor" : "#FFFFFFFF",
  "buttonColor" : "#9377FFFF",
  "powerIconColor" : "#3D2A7DFF",
  "subscriptionInfoTextColor" : "#FFFFFFFF",
  "serverRowTitleTextColor" : "#FFFFFFFF",
  "backgroundImageType" : "system",
  "elipseColors" : [
    "#00B460FF",
    "#CF72FFE0",
    "#FFDD00FF"
  ],
  "serverRowChevronColor" : "#FFFFFFFF"
}

Turquoise Theme

{
  "backgroundGradientRotationAngle" : 39.21265661716461,
  "serverRowChevronColor" : "#F3FFFDFF",
  "buttonImageType" : "light",
  "buttonTimerColor" : "#3B3C3DFF",
  "subscriptionTrafficBackgroundColor" : "#00343BFF",
  "subscriptionInfoBackgroundColor" : "#006B7AFF",
  "serverRowTitleTextColor" : "#D0FFF3FF",
  "serverRowBackgroundColor" : "#02424DFF",
  "powerIconColor" : "#05525ACA",
  "supportIconColor" : "#F3FFF9FF",
  "profileWebPageIconColor" : "#F5FFF9FF",
  "selectedServerRowColor" : "#006B7BFF",
  "disclosureHeaderTextColor" : "#D0FFF3FF",
  "subsHeaderColor" : "#007982FF",
  "elipseColors" : [
    "#4DFF00CC",
    "#E2FF00FF",
    "#FF6000FF"
  ],
  "subscriptionInfoTextColor" : "#E5FFF7FF",
  "buttonColor" : "#8FFFFEFF",
  "serverRowSubTitleTextColor" : "#ADD3CBFF",
  "topBarButtonsColor" : "#FFFFFFD8",
  "settingsControlsTintColor" : "#00C3C1FF",
  "backgroundGradientColorIntensity" : 1,
  "disclosureSubHeaderTextColor" : "#A4FFE599",
  "additionalOptionsButtonColor" : "#FBFFFF99",
  "backgroundImageType" : "light",
  "backgroundColors" : [
    "#003740FF",
    "#003740FF",
    "#005255FF",
    "#00A6A1FF",
    "#00C9DDFF"
  ],
  "subHeaderButtonColor" : "#BAD7CFFF",
  "buttonTextColor" : "#000000FF"
}

Пример настройки данного параметра:

color-profile: [String] //base64 or plainString
color-profile: resetcolors // full reset

Способы передачи:

Через HTTP Headers:

HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
color-profile: {"backgroundGradientRotationAngle":37.1,"serverRowBackgroundColor":"#21003D67","subsHeaderColor":"#42296DFF","profileWebPageIconColor":"#A2B8FFFF","selectedServerRowColor":"#3E2F62B5","disclosureSubHeaderTextColor":"#C1C2E2FF","buttonTextColor":"#FFFFFFFF","buttonTimerColor":"#FFFFFFFF","subscriptionInfoBackgroundColor":"#21003CFF","backgroundColors":["#3D2A7DFF","#6557BAFF","#9377FF7F"],"disclosureHeaderTextColor":"#FFFFFFFF","backgroundGradientColorIntensity":1,"additionalOptionsButtonColor":"#FFFFFFFF","buttonImageType":"light","serverRowSubTitleTextColor":"#C1C2E2FF","supportIconColor":"#FFFFFFFF","topBarButtonsColor":"#FFFFFFFF","subscriptionTrafficBackgroundColor":"#533EA7FF","subHeaderButtonColor":"#FFFFFFFF","buttonColor":"#9377FFFF","powerIconColor":"#3D2A7DFF","subscriptionInfoTextColor":"#FFFFFFFF","serverRowTitleTextColor":"#FFFFFFFF","backgroundImageType":"system","elipseColors":["#00B460FF","#CF72FFE0","#FFDD00FF"],"serverRowChevronColor":"#FFFFFFFF"}

Через тело подписки:

#color-profile: {"backgroundGradientRotationAngle":37.1,"serverRowBackgroundColor":"#21003D67","subsHeaderColor":"#42296DFF","profileWebPageIconColor":"#A2B8FFFF","selectedServerRowColor":"#3E2F62B5","disclosureSubHeaderTextColor":"#C1C2E2FF","buttonTextColor":"#FFFFFFFF","buttonTimerColor":"#FFFFFFFF","subscriptionInfoBackgroundColor":"#21003CFF","backgroundColors":["#3D2A7DFF","#6557BAFF","#9377FF7F"],"disclosureHeaderTextColor":"#FFFFFFFF","backgroundGradientColorIntensity":1,"additionalOptionsButtonColor":"#FFFFFFFF","buttonImageType":"light","serverRowSubTitleTextColor":"#C1C2E2FF","supportIconColor":"#FFFFFFFF","topBarButtonsColor":"#FFFFFFFF","subscriptionTrafficBackgroundColor":"#533EA7FF","subHeaderButtonColor":"#FFFFFFFF","buttonColor":"#9377FFFF","powerIconColor":"#3D2A7DFF","subscriptionInfoTextColor":"#FFFFFFFF","serverRowTitleTextColor":"#FFFFFFFF","backgroundImageType":"system","elipseColors":["#00B460FF","#CF72FFE0","#FFDD00FF"],"serverRowChevronColor":"#FFFFFFFF"}
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…

PreviousHWID ссылки NextProvider ID

Last updated 2 minutes ago