Заголовки clod-*

clod-* — заголовки, которые понимает только Clod Clash. Панель сама их не отдаёт: их вписывают в настройках подписки в customResponseHeaders. Каждый действует только в своей подписке. Стандартные заголовки Remnawave — на странице Заголовки.

Все заголовки

Вместо true / false подходят 1 / 0, yes / no, on / off (кроме clod-disable-ping и 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: шаблона (без него — «По правилам»). Сменить его нельзя ни в окне, ни из трея, ни горячей клавишей.

Для совместимости с 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 и без точки в конце, тогда его одинаково узнают ПК и Android. Иначе клиент не узнает в clod-new-sub домен основного адреса, сочтёт его запасным, а с clod-move-sub «переведёт» подписку на тот же сервер.
• Домен держится, пока панель его присылает: другой — заменяется, заголовка нет — стирается.
• clod-move-sub: true вместе с clod-new-sub переводит подписку на запасной адрес насовсем. Клиент сначала загружает подписку с нового адреса; удалось — адрес меняется и показывается уведомление, не удалось — всё остаётся, попытка повторится при следующем обновлении. Серверы, режим и название не сбрасываются.
• Одинаковые заголовки можно отдавать с обоих доменов: после перевода домен совпадает с основным, и заголовок ничего не делает.

Узлы-заглушки: 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-theme — оформление под провайдера:

clod-theme: accent=#2E7CF6; mode=dark; background=https://cdn.provider.example/bg.jpg

accent — акцентный цвет, mode — light или dark, background — картинка для фона окна (только https, до 4 МБ). Части через ;, любую можно опустить. Цвет и тема, выбранные пользователем, важнее; тумблер «Оформление от провайдера» в настройках темы выключает заголовок целиком. Действует только для активной подписки.

Больше не поддерживаются

• clod-device-remove — поддержка убрана.
• clod-hwid-limit — убран: при лимите устройств клиент показывает своё окно с названием подписки и кнопкой «Поддержка» (если панель прислала support-url).