Clod Clash

Заголовки подписки

Что клиент отправляет панели и что понимает в ответе

Полный справочник с правилами разбора, синонимами и примерами — в репозитории: docs/HEADERS.md. Собственные заголовки клиента с поддержкой по платформам — на странице Заголовки clod-*.

Что отправляет клиент

ЗаголовокЗначение
User-AgentClodClash/<версия>, например ClodClash/0.1.11-alpha.3; если в свойствах подписки заполнено поле «User Agent», уходит оно, и правило ^ClodClash в панели на такой запрос может не сработать
Accept*/*
x-hwidидентификатор устройства — пока включена «Идентификация устройства» (по умолчанию включена)
x-device-os, x-ver-os, x-device-modelсистема, её версия и модель — вместе с x-hwid; имя компьютера не отправляется

По защищённому каналу (приложение пробует его само при добавлении подписки) эти значения уходят не заголовками, а внутри зашифрованного запроса к прослойке.

Что понимает в ответе

ЗаголовокЧто делает
profile-titleназвание подписки, обновляется с каждым ответом; своё название пользователя показывается первым: «Своё (от панели)»
content-dispositionзапасное название, если нет profile-title
subscription-userinfoтрафик и срок на карточке
subscription-refill-dateдата пополнения трафика
profile-update-intervalинтервал автообновления в часах; применяется при каждом обновлении, пока пользователь не задал свой. Если он ни разу не приходил и своего нет — по расписанию не обновляется; пропавший заголовок оставляет последний интервал, остановить — 0
profile-logoлоготип провайдера, хранится локально: только публичный адрес https (не адрес локальной сети), до 2 МБ, форматы png, jpg, gif, webp, avif, ico, bmp, svg. Логотип, который не подходит, не показывается
profile-web-page-urlпункт «Страница подписки» в меню карточки подписки
support-urlкнопка «Поддержка» (https, tg:, mailto:)
announce, announce-urlпостоянное объявление и ссылка из него
x-hwid-not-supported, x-hwid-max-devices-reached, x-hwid-limitотказ по устройству: окно с названием подписки, прежние серверы убираются
notify-expire-days, notify-traffic-percentпороги напоминаний о сроке и трафике (off выключает)
Dateсрок считается по часам панели, неверное время на компьютере его не сдвигает
clod-*собственные заголовки клиента — см. Заголовки clod-*

Дополнительные заголовки задаются в панели через customResponseHeaders. Значения с не-ASCII текстом надёжнее отдавать как base64:<payload>; ссылки — только https://; support-url и clod-bot-url принимают ещё tg: и mailto:. Значки групп (icon у групп в шаблоне) клиент скачивает по тем же правилам, что и логотип.

На этой странице