Для провайдеров

Справочник по заголовкам

Каждый заголовок ответа, который читает ReClash: имя, формат, псевдонимы, что делает и пример. Ищите по имени или описанию, фильтруйте по категории. Как всё это работает целиком — в документации.

20 reclash-*7 общихHWIDДокументация →Конструктор →

01справочник

Общие заголовки 7

Стандартные заголовки Clash. Отдаёте их уже — ReClash подхватит без изменений.

subscription-userinfoОбщийПоказывает расход трафика и дату окончания.

Форматupload=<байты>; download=<байты>; total=<байты>; expire=<unix-секунды>

Расход и лимит трафика в байтах и дата окончания в unix-секундах. total=0 — безлимит, expire=0 — бессрочно. Клиент показывает остаток, полосу расхода и число дней до конца.

Subscription-Userinfo: upload=13421772800; download=83994443776; total=214748364800; expire=1798761600

profile-titleОбщийИменует импортированный профиль, пока пользователь не переименовал его вручную. Для не-ASCII используйте base64:.

ФорматИмя профиля, UTF-8 или Base64

Именует импортированный профиль, пока пользователь не переименовал его вручную. Для не-ASCII используйте base64:.

Profile-Title: Nebula VPN
Profile-Title: base64:0J3QtdCx0YPQu9CwIFZQTg==

content-dispositionОбщийЗапасной источник имени профиля.

ФорматИмя файла в ответе

Запасной источник имени профиля.

Content-Disposition: attachment; filename="nebula.yaml"

profile-update-intervalОбщийИнтервал обновления профиля.

ФорматЦелое > 0, в часах

Интервал обновления профиля.

Profile-Update-Interval: 24

support-urlОбщийДобавляет действие «Поддержка». Абсолютный HTTPS-адрес.

ФорматURL поддержки

Добавляет действие «Поддержка». Абсолютный HTTPS-адрес.

Support-Url: https://nebula.example/help

announceОбщийПоказывает объявление провайдера.

ФорматТекст или Base64

Показывает объявление провайдера.

Announce: base64:0J/RgNC+0YTQuNC70LDQutGC0LjQutCw

report-urlОбщийСовместимое имя для reclash-reporturl. Добавляет действие «Сообщить о проблеме» с подпиской.

ФорматURL для сообщения о проблеме

Совместимое имя для reclash-reporturl. Добавляет действие «Сообщить о проблеме» с подпиской.

Заголовки ReClash 20

Двадцать заголовков, которые понимает только ReClash. Все необязательны.

reclash-announceReClashОбъявление провайдера. Приоритетнее announce.

ФорматТекст или Base64

Объявление провайдера. Приоритетнее announce.

ReClash-Announce: base64:0J/RgNC+0YTQuNC70LDQutGC0LjQutCw 14.04

reclash-supporturlReClashflclashx-supporturlСтраница поддержки. Абсолютный HTTPS.

ФорматURL поддержки

Псевдонимflclashx-supporturl

Страница поддержки. Абсолютный HTTPS.

ReClash-SupportURL: https://nebula.example/help

reclash-autoupdateintervalReClashflclashx-autoupdateintervalИнтервал обновления профиля.

ФорматЦелое > 0, в минутах

Псевдонимflclashx-autoupdateinterval

Интервал обновления профиля.

ReClash-AutoUpdateInterval: 60

reclash-servicenameReClashflclashx-servicenameИмя сервиса на панели.

ФорматТекст или Base64

Псевдонимflclashx-servicename

Имя сервиса на панели.

ReClash-ServiceName: Nebula VPN

reclash-activetextReClashНадпись под кольцом подключения и в уведомлении Android вместо «Вы защищены».

ФорматТекст или Base64

Надпись под кольцом подключения и в уведомлении Android — вместо стандартного «Вы защищены». Для не-ASCII используйте base64:.

ReClash-ActiveText: Nebula has you covered

reclash-servicelogoReClashflclashx-servicelogoЛоготип на панели и в контроле подключения.

ФорматАбсолютный HTTPS-URL картинки

Псевдонимflclashx-servicelogo

Логотип на панели и в контроле подключения. Абсолютный HTTPS-адрес, PNG или SVG, квадрат 256–512 px, прозрачный фон; значимую часть держите в центральных 80 % — края обрезаются под скругление.

ReClash-ServiceLogo: https://nebula.example/logo-512.png

reclash-serverinfoReClashflclashx-serverinfoГруппа, из которой берётся активный сервер для панели.

ФорматИмя прокси-группы, текст или Base64

Псевдонимflclashx-serverinfo

Группа, из которой берётся активный сервер для панели.

ReClash-ServerInfo: Auto

reclash-buyplanReClashflclashx-buyplanДействие «Продлить / купить тариф».

ФорматURL

Псевдонимflclashx-buyplan

Действие «Продлить / купить тариф».

ReClash-BuyPlan: https://nebula.example/billing

reclash-buytrafficReClashflclashx-buytrafficДействие «Докупить трафик».

ФорматURL

Псевдонимflclashx-buytraffic

Действие «Докупить трафик».

ReClash-BuyTraffic: https://nebula.example/billing/traffic

reclash-reporturlReClashДействие «Сообщить о проблеме с подпиской».

ФорматURL

Действие «Сообщить о проблеме с подпиской».

reclash-viewReClashflclashx-viewПредлагает вид страницы прокси для этого профиля.

Форматtype:… sort:… layout:… icon:… card:…

Псевдонимflclashx-view

Токены вида ключ:значение через запятую или точку с запятой. Неизвестные ключи и значения отбрасываются, остальные применяются. Это предложение, а не приказ: пользователь может переключить вид сам.

Ключ	Значения	Что задаёт
`type`	`tab` `list`	Форма страницы прокси
`sort`	`default` `none` `delay` `name`	Сортировка узлов
`layout`	`loose` `standard` `tight`	Плотность сетки
`icon`	`none` `standard` `icon`	Иконки узлов
`card`	`expand` `shrink` `min` `oneline`	Размер карточки

ReClash-View: type:tab; sort:delay; layout:tight; icon:standard; card:shrink

reclash-hexReClashflclashx-hexПрименяет тему, пока профиль активен.

ФорматRRGGBB[:variant][:pureblack]

Псевдонимflclashx-hex

Цвет RRGGBB или AARRGGBB, за ним необязательный вариант палитры и необязательный pureblack (чёрный AMOLED-фон). Разделители — :, ; или ,. Тема действует, пока профиль активен.

Вариант	Что даёт
`tonalspot`	Сбалансированный, по умолчанию
`fidelity`	Ближе к исходному цвету
`monochrome`	Оттенки серого
`neutral`	Почти без насыщенности
`vibrant`	Максимальная насыщенность
`expressive`	Смещённый оттенок
`content`	От контента, живее fidelity

ReClash-Hex: 2FD3B6
ReClash-Hex: 2FD3B6:vibrant
ReClash-Hex: FF7C5CFF;expressive;pureblack

reclash-backgroundReClashflclashx-backgroundФон панели, пока профиль активен.

Форматurl[,opacity]

Псевдонимflclashx-background

Абсолютный http- или https-адрес картинки и необязательная непрозрачность 1–100. По умолчанию 10 — фон должен оставаться фоном. Действует, пока профиль активен.

ReClash-Background: https://nebula.example/bg.webp,14

reclash-heroringReClashГрадиент кольца в подключённом состоянии.

Форматc1;c2;c3

Ровно три цвета — градиент кольца вокруг кнопки подключения. Меньше или больше трёх значений игнорируется целиком. Псевдонима у этого заголовка нет.

ReClash-HeroRing: 7C5CFF;3686ED;2FD3B6

reclash-heroeffectReClashЖивой эффект за кольцом подключения. Пока поддерживается только aurora; любое другое значение выключает эффект.

Форматaurora

Живой эффект за кольцом подключения. Пока поддерживается только aurora — мягкое северное сияние; любое другое значение выключает эффект. Псевдонима у этого заголовка нет.

ReClash-HeroEffect: aurora

reclash-widgetsReClashПредлагает набор и порядок виджетов панели.

Форматимена через запятую

Имена виджетов через запятую — порядок в списке становится порядком на панели. Виджеты, недоступные на платформе, просто не появятся. reclash-custom управляет тем, как список сливается с пользовательским.

Имя	Виджет	Доступен
`networkSpeed`	Скорость сети	все платформы
`outboundModeV2`	Режим маршрутизации	все платформы
`outboundMode`	Режим маршрутизации (старый)	все платформы
`trafficUsage`	Расход трафика	все платформы
`networkDetection`	Определение сети	все платформы
`tunButton`	Кнопка TUN	Windows, macOS, Linux
`vpnButton`	Кнопка VPN	Android
`systemProxyButton`	Системный прокси	Windows, macOS, Linux
`intranetIp`	Внутренний IP	все платформы
`memoryInfo`	Память	все платформы
`metaInfo`	Подписка: срок и квота	все платформы
`announce`	Объявление	все платформы
`serviceInfo`	Карточка сервиса	все платформы
`changeServerButton`	Смена сервера	все платформы
`smartRouting`	Умная маршрутизация	все платформы

ReClash-Widgets: serviceInfo,networkSpeed,trafficUsage,outboundModeV2

reclash-customReClashКак сливать список виджетов с пользовательским.

Форматadd | update

Как reclash-widgets сливается с уже собранным пользователем набором: add добавляет недостающие виджеты в конец, update заменяет набор целиком. Без этого заголовка набор предлагается только при первом добавлении профиля.

ReClash-Widgets: serviceInfo,networkSpeed,trafficUsage,outboundModeV2
ReClash-Custom: update

reclash-settingsReClashНастройки по умолчанию при первом добавлении профиля — после подтверждения пользователем.

Форматтокены через запятую

Настройки по умолчанию. Предлагаются один раз — при первом добавлении профиля: ReClash покажет запрошенные изменения и применит их только после подтверждения. Не перечисленные настройки остаются как есть, дальше настройками владеет пользователь.

Токен	Что включает
`minimize`	Сворачивать вместо выхода
`autorun`	Подключаться при запуске ReClash
`shadowstart`	Запускаться в фоне
`autostart`	Запускаться вместе с системой
`autoupdate`	Проверять обновления ReClash
`openlogs`	Открывать логи вместе с подключением
`closeconnections`	Закрывать соединения при паузе

ReClash-Settings: minimize,autoupdate

reclash-newdomainReClashflclashx-newdomainПредлагает миграцию домена подписки — после проверок.

Форматхост[:порт]

Псевдонимflclashx-newdomain

Только имя хоста и необязательный порт — без схемы, пути и параметров. Клиент не переключается вслепую: он проверяет, что новый адрес действительно отдаёт вашу подписку, и только потом переносит профиль.

ReClash-NewDomain: sub.nebula.example
ReClash-NewDomain: sub.nebula.example:8443

reclash-fallbackhostsReClashЗапасные хосты при временных сбоях загрузки.

Форматдо 4 хостов через запятую

До четырёх имён хостов через запятую — без портов и схемы. Имена приводятся к нижнему регистру, дубликаты убираются, лишнее отбрасывается. Клиент идёт к ним, когда основной адрес временно недоступен. Псевдонима нет.

ReClash-FallbackHosts: sub2.nebula.example,sub3.nebula.example

Устройства и HWID 6

Заголовки запроса от клиента и ответы на них.

x-hwidУстройствоСтабильный 16-символьный хеш устройства

Формат—

Стабильный 16-символьный хеш устройства

X-HWID: 3f7a9c2e5b1d8046

x-device-osУстройствоНазвание ОС

Формат—

Название ОС

X-Device-OS: Android

x-ver-osУстройствоВерсия ОС

Формат—

Версия ОС

X-Ver-OS: 14

x-device-modelУстройствоМодель устройства или имя хоста

Формат—

Модель устройства или имя хоста

X-Device-Model: Pixel 8

x-hwid-max-devices-reachedУстройствоПоказывает сообщение о лимите устройств и предлагает reclash-supporturl, если он есть.

Форматtrue

Показывает сообщение о лимите устройств и предлагает reclash-supporturl, если он есть.

X-HWID-Max-Devices-Reached: true

x-hwid-not-supportedУстройствоПоказывает, что выбранный режим клиента или устройства не поддерживается.

Форматtrue

Показывает, что выбранный режим клиента или устройства не поддерживается.

X-HWID-Not-Supported: true