Clod Clash

Subscription headers

What the client sends to the panel and what it understands in the response

The full reference with parsing rules, synonyms and examples is in the repository: docs/HEADERS.md. The client's own headers with per-platform support are on the clod-* headers page.

What the client sends

HeaderValue
User-AgentClodClash/<version>, for example ClodClash/0.1.11-alpha.3; if the "User Agent" field is filled in the subscription properties, that value is sent instead, and the ^ClodClash rule in the panel may not match such a request
Accept*/*
x-hwidthe device identifier — as long as "Device identification" is on (on by default)
x-device-os, x-ver-os, x-device-modelthe system, its version and model — together with x-hwid; the computer name is not sent

Over the secure channel (the app tries it by itself when a subscription is added) these values are sent not as headers but inside the encrypted request to the middleware.

What it understands in the response

HeaderWhat it does
profile-titlesubscription name, updated with every response; the user's own name is shown first: "Yours (from the panel)"
content-dispositionfallback name if there's no profile-title
subscription-userinfotraffic and expiry on the card
subscription-refill-datetraffic top-up date
profile-update-intervalauto-update interval in hours; applied with every update until the user sets their own. If it has never arrived and there's no user value, the subscription isn't updated on a schedule; a missing header keeps the last interval; to stop, send 0
profile-logoprovider logo, stored locally: a public https address only (not a local network address), up to 2 MB, png, jpg, gif, webp, avif, ico, bmp or svg. A logo that doesn't fit is not shown
profile-web-page-urlthe "Subscription page" item in the subscription card menu
support-urlthe "Support" button (https, tg:, mailto:)
announce, announce-urla permanent announcement and its link
x-hwid-not-supported, x-hwid-max-devices-reached, x-hwid-limitdevice refusal: a window with the subscription name; the previous servers are removed
notify-expire-days, notify-traffic-percentthresholds for expiry and traffic reminders (off turns them off)
Datethe expiry is calculated by the panel's clock; a wrong time on the computer doesn't shift it
clod-*the client's own headers — see clod-* headers

Additional headers are set in the panel via customResponseHeaders. Values with non-ASCII text are more reliably sent as base64:<payload>; links — https:// only; support-url and clod-bot-url also accept tg: and mailto:. Group icons (icon of the groups in the template) are downloaded by the same rules as the logo.

On this page