Заголовки clod-*
Собственные заголовки Clod Clash — значения, что делает каждый и на каких платформах работает
clod-* — заголовки, которые понимает только Clod Clash. Панель сама их не отдаёт: их
вписывают в настройках подписки в customResponseHeaders. Каждый действует только в своей
подписке. Стандартные заголовки Remnawave — на странице Заголовки.
Стандартный заголовок можно прислать и под именем clod-<имя> (например, clod-support-url):
он перебивает одноимённый заголовок, который отдаёт сама панель. Кроме Date, Age и
content-disposition — они читаются только под своим именем.
Все заголовки
| Заголовок | Значение | Что делает | Где работает |
|---|---|---|---|
clod-portal-url | ссылка https:// | кнопка «Кабинет» — личный кабинет, где продлевают тариф | ПК и Android |
clod-bot-url | ссылка https://, tg: или mailto: | кнопка «Бот» | ПК и Android |
clod-monitor-url | ссылка https:// | кнопка «Мониторинг» — состояние серверов | ПК и Android |
clod-guide-url | ссылка https:// | кнопка «Инструкция» | ПК и Android |
clod-announce | текст | постоянное объявление; если пришёл и announce, показывается clod-announce | ПК и Android |
clod-promo | текст | промо-баннер, который можно закрыть | ПК и Android |
clod-promo-url | ссылка https:// | куда ведёт нажатие на промо | ПК и Android |
clod-lock-mode | true, lock или false | запирает режим маршрутизации на mode из шаблона | ПК и Android |
clod-ping | A/B в мс, например 150/300 | границы цвета пинга. Без заголовка — 200/400 | ПК и Android |
clod-disable-ping | только true | галочка или крестик вместо миллисекунд | ПК и Android |
clod-show-0hosts | true или false | показывать узлы-заглушки панели как есть | ПК и Android |
clod-16-20-check | только true | проверка 16–20: обрывается ли скачивание через сервер в сети пользователя; значок-снежинка | ПК и Android |
clod-new-sub | только домен, например sub2.example.com | запасной адрес подписки: тот же адрес на этом домене по https, если основной не ответил | ПК и Android |
clod-move-sub | только true | вместе с clod-new-sub: перевести подписку на запасной адрес насовсем | ПК и Android |
clod-connect-mode | tun, proxy или both | что включает кнопка подключения. Без заголовка — системный прокси | только ПК |
clod-simple-mode | true или false | простой или расширенный вид по умолчанию. Без заголовка — простой | только ПК |
clod-latency-style | bars, dot или number | как рисовать пинг выбранного сервера. Без заголовка — полоски | только ПК |
clod-hide-badges | только true | спрятать у серверов плашки протокола, транспорта и защиты, TFO, MPTCP, SMUX | ПК и Android |
clod-theme | accent=#RRGGBB; mode=light|dark; background=https://… | цвет, тема и фон окна | только ПК |
Вместо true / false подходят 1 / 0, yes / no, on / off (кроме
clod-disable-ping, clod-16-20-check, clod-hide-badges и clod-move-sub: там работает только true). Непонятое значение равно отсутствию
заголовка. Текст с кириллицей отдавайте как base64:<текст в base64>.
Ссылки провайдера
Кнопки «Кабинет», «Бот», «Мониторинг», «Инструкция» и «Поддержка» (support-url) собираются в
строку на главном экране и повторяются в настройках. Показываются только присланные ссылки.
Кабинет — отдельный заголовок, потому что profile-web-page-url у Remnawave обычно ведёт на
страницу самой подписки. Кнопок «Продлить» и «Оплатить» в клиенте нет: единственное место
оплаты — кабинет. Бот — отдельно от «Поддержки», где отвечает человек.
Объявление и промо
clod-announce— постоянное объявление без крестика; висит, пока панель его отдаёт.clod-promo— временный баннер для акций. Его можно закрыть; при новом тексте он появляется снова, а когда панель перестаёт слать заголовок — пропадает на следующем обновлении подписки.clod-promo-urlделает его кликабельным.- Длина — до 500 видимых символов (на Android — до 300). На ПК длинный текст сворачивается до пяти строк с кнопкой «Показать полностью».
- Слова можно красить: код
#RRGGBBвплотную перед словом, например#EF4444ВАЖНО: узел на профилактике. Цвет действует до ближайшего пробела. На Android — так же, начиная с 0.1.22-alpha.5.
Режим маршрутизации: clod-lock-mode
Запирает режим на тот, что в mode: шаблона (без него — «По правилам»). Сменить его нельзя ни в
окне, ни из трея, ни горячей клавишей.
| Значение | Что происходит |
|---|---|
true | режим заперт, пока панель это подтверждает. Если подписка не обновлялась успешно дольше 72 часов (или трёх интервалов обновления, если это дольше), замок снимается сам; ближайшее удачное обновление вернёт его |
lock | режим заперт навсегда. Удачное обновление с true (или с global-mode: false) делает замок временным, а без заголовка, с false или с global-mode: true — снимает |
false | замка нет |
Для совместимости с Prizrak-Box global-mode: false понимается как clod-lock-mode: true,
global-mode: true — как «замка нет».
Пинг
clod-ping: A/B— доAмс пинг зелёный, доBжёлтый, дальше красный. Два целых через/,1 ≤ A < B ≤ 60000. Действует на главном экране и на странице «Прокси».clod-disable-ping: true— на главном экране вместо миллисекунд зелёная галочка (проверка прошла), красный крестик (не прошла) или прочерк (ещё не проверялся). На странице «Прокси» цифры остаются.clod-latency-style(только ПК) —bars— четыре полоски,dot— цветная точка,number— число. Синонимы:signal,dots,ms,latency;pxa-latency-dots: 1=dot.
Запасной адрес: clod-new-sub и clod-move-sub
clod-new-sub— только домен, напримерsub2.example.com. Клиент собирает из него запасной адрес:https://, этот домен, путь и параметры основного адреса подписки. Запасной адрес берётся, только когда с основного не удалось получить годную подписку ни одним путём (напрямую, через ядро, через системный прокси) — в том числе если он ответил ошибкой.- Как писать домен, чтобы клиент его принял и узнал:
- кириллический домен — только в punycode:
xn--e1afmkfd.xn--p1ai, а непример.рф; - без точки в конце:
sub2.example.com, а неsub2.example.com.; - регистр букв не важен;
- запасной сервер отвечает на порту 443: порт основного адреса не переносится.
- кириллический домен — только в punycode:
- Домен в ссылках подписки у пользователей пишите так же — в punycode и без точки в конце,
тогда его одинаково узнают ПК и Android. Иначе клиент не узнает в
clod-new-subдомен основного адреса, сочтёт его запасным, а сclod-move-sub«переведёт» подписку на тот же сервер. - Домен держится, пока панель его присылает: другой — заменяется, заголовка нет — стирается.
clod-move-sub: trueвместе сclod-new-subпереводит подписку на запасной адрес насовсем. Клиент сначала загружает подписку с нового адреса; удалось — адрес меняется и показывается уведомление, не удалось — всё остаётся, попытка повторится при следующем обновлении. Серверы, режим и название не сбрасываются.- Одинаковые заголовки можно отдавать с обоих доменов: после перевода домен совпадает с основным, и заголовок ничего не делает.
- У подписки с защищённым каналом запасной адрес и переезд идут тем же каналом: на запасном
домене должна стоять та же прослойка и отвечать на
/c1/…. Без неё запасной адрес не выручит, а переезд не произойдёт.
Проверка 16–20: clod-16-20-check
С true клиент сам проверяет каждый сервер подписки в сети пользователя: скачивает через него
64 КБ и смотрит одно — доходит ли всё или скачивание обрывается после первых килобайт. Сервер, на
котором оборвалось, через несколько секунд проверяется ещё дважды вместе с сервером, который в этой
сети работает. Значок-снежинка рядом с пингом ставится, только если оборвались все три проверки, а
рабочий сервер при этом прошёл; если последняя проверка прошла — сервер считается рабочим. Сравнить
не с чем или не прошёл и рабочий — значок не ставится: это скорее плохая сеть. Нажатие на значок
открывает объяснение: проверить соединение вручную и сообщить в поддержку (кнопка есть, если прислан
support-url). С серверами клиент ничего не делает: пинг и выбор как были. Проверяются новые
серверы и те, у которых изменились данные подключения; итоги перепроверяются раз в 3 суток, а
проверка, которая итога не дала, — через 6 часов в той же сети. Итоги хранятся отдельно для каждой подписки
и сети. Без заголовка (или с любым значением, кроме true) ни проверок, ни значков нет.
Узлы-заглушки: clod-show-0hosts
Без заголовка клиент узнаёт узлы-заглушки панели (истёкшая подписка, закончился трафик, лимит
устройств, «нет серверов») и вместо них показывает свой экран с причиной. С true он ничего не
разбирает: узлы панели попадают в список серверов со своими названиями. Окно лимита устройств
от этого заголовка не зависит.
Только на ПК
clod-connect-mode — что включает кнопка подключения: tun, proxy или both (синонимы
tunnel/vpn, system/system-proxy/sysproxy, all). Если пользователь сам выбирал способ
подключения, его выбор важнее. Если режим заперт (clod-lock-mode или global-mode: false), решает
заголовок: переключатели заменяются строкой «… — способ подключения задан провайдером», а способ,
которого в заголовке нет, не включить ни из трея, ни горячей клавишей — в меню трея его пункта нет.
clod-simple-mode — true — простой вид, false — расширенный. Выбор пользователя всегда
важнее. Синонимы: pxa-simple-mode (Prizrak-Box), flclashx-newboard (FlClashX).
clod-hide-badges — true прячет у серверов в окне плашки протокола, транспорта и
защиты — например VLESS, gRPC, Reality, а с ними и TFO, MPTCP, SMUX — на странице
«Прокси», в цепочке прокси и в списке серверов на главной. Имя сервера, флаг, пинг, описание, имя
провайдера и значок-снежинка остаются как были. У групп в списке остаётся их тип
(Selector, URLTest и т. п.) — это не протокол; у встроенных DIRECT и REJECT плашка типа прячется,
как у серверов. Пригодится,
если названия серверов уже говорят всё нужное или вы не хотите показывать, на чём они работают.
Работает только true (регистр не важен). Заголовок пропал или пришло другое значение — плашки
вернутся после следующего обновления подписки. Действует только для активной подписки. В Android-клиенте тот же заголовок прячет подпись протокола и транспорта под именем сервера.
clod-hide-badges: trueclod-theme — оформление под провайдера:
clod-theme: accent=#2E7CF6; mode=dark; background=https://cdn.provider.example/bg.jpgaccent — акцентный цвет, mode — light или dark, background — картинка для фона окна
(только https, до 4 МБ). Части через ;, любую можно опустить. Цвет и тема, выбранные
пользователем, важнее; тумблер «Оформление от провайдера» в настройках темы выключает заголовок
целиком. Действует только для активной подписки.
Больше не поддерживаются
clod-device-remove— поддержка убрана.clod-hwid-limit— убран: при лимите устройств клиент показывает своё окно с названием подписки и кнопкой «Поддержка» (если панель прислалаsupport-url).