Clod Clash

Настройка панели Remnawave

Что нужно сделать на стороне панели, чтобы клиент работал целиком

Полный гайд с примерами шаблона и чек-листом — в репозитории: docs/REMNAWAVE.md. Здесь — минимум, без которого клиент не заработает.

1. Правило User-Agent

В Subscription response rules добавьте правило с регулярным выражением ^ClodClash (или без учёта регистра — caseSensitive: false, как в примере ниже) и форматом MIHOMO. Без него панель отдаст ответ по умолчанию, и клиент подписку не примет (на список ссылок в base64 он покажет «Провайдер прислал список ссылок вместо конфигурации — его панель не узнала клиент»).

Клиент представляется как ClodClash/<версия>, версия бывает с суффиксом (0.1.11-alpha.3) — поэтому ловите префикс, а не точную строку. Чтобы описания серверов (serverDescription) доходили до него, добавьте ^ClodClash/ в responseModifications.additionalExtendedClientsRegex того же правила — именно по префиксу, а не точной строкой, иначе правило отвалится при следующем обновлении клиента.

{
  "name": "Mihomo Clients",
  "description": "Response with generated YAML config (Mihomo Template)",
  "enabled": true,
  "operator": "AND",
  "conditions": [
    {
      "headerName": "user-agent",
      "operator": "REGEX",
      "value": "^(?:FlClash|FlClashX|Flowvy|[Cc]lash-[Vv]erge|[Kk]oala-[Cc]lash|[Cc]lash-?[Mm]eta|[Mm]urge|[Cc]lashX [Mm]eta|[Mm]ihomo|[Cc]lash-nyanpasu|clash.meta|prizrak-box|[Cc]lod[Cc]lash)",
      "caseSensitive": false
    }
  ],
  "responseType": "MIHOMO",
  "responseModifications": {
    "additionalExtendedClientsRegex": [
      "^ClodClash/"
    ]
  }
}

2. Шаблон MIHOMO

В шаблоне ответа MIHOMO должен остаться маркер # LEAVE THIS LINE! в основной группе, а у rule-providers указан proxy: на основную группу.

Клиент всегда задаёт сам external-controller, secret, socks-port, port, redir-port (Linux и macOS) и tproxy-port (Linux); external-ui* и external-controller-tls из шаблона выбрасываются. mode, mixed-port, log-level и unified-delay берутся из шаблона, пока пользователь не выбрал своё (без ключа в шаблоне — rule, 7897, info, true); закрепить режим можно заголовком clod-lock-mode. ipv6 — из шаблона, без ключа выключен. Правила, группы, sniffer отдаются шаблону целиком; dns — пока пользователь не включил «Переопределение настроек DNS», hosts — пока он не задал там свои. Если profile-update-interval ни разу не приходил, подписка по расписанию не обновляется; остановить автообновление — profile-update-interval: 0. У каждого провайдера в proxy-providers и rule-providers должен быть свой path (или не указывайте его — ядро назовёт файл само): с одинаковым path у разных провайдеров служба TUN не принимает конфиг, а без службы провайдеры пишут в один файл.

На Windows стеки TUN system и mixed из шаблона не берутся — только явным выбором пользователя в диалоге TUN. На macOS и Linux стек из шаблона действует.

3. Заголовки

Название тарифа, логотип, объявление, ссылки на кабинет и поддержку, лимит устройств, режимы интерфейса — всё это панель передаёт заголовками ответа. Полный справочник — на страницах Заголовки и Заголовки clod-*.

4. Защищённый канал и отчёты

Клиент сам пробует защищённый канал прослойки remnawave-subscription-middleware, когда пользователь добавляет подписку; без канала у провайдера подписка загружается обычным способом. Подписка с каналом после планового обновления (если обновления реже раза в 6 часов — и между ними, не чаще раза в 6 часов) шлёт отчёт о качестве узлов: пинги и итоги 16–20 по узлам, трафик, вид сети и внешний адрес, с которого делались замеры. Принимает и показывает отчёты прослойка (вкладка Clod Clash → «Статистика»), если в ней включён приём. Замеры клиент копит, только когда прослойка подтвердила приём в ответе подписки по каналу (так делают свежие версии прослойки); нет подтверждения в очередном ответе — перестаёт копить и стирает накопленное.

Без прослойки на запрос канала (путь /c1/… на домене подписки) отвечает ваш сервер, и от этого ответа зависит, добавится ли подписка:

Ответ на незнакомый путьЧто делает клиент
404 или 410сразу загружает подписку обычным способом
другой код 4xxпробует канал ещё дважды; если так ответили все три попытки — обычный способ
соединение закрыто без ответа (например, nginx return 444)так же, как другой код 4xx
5xx (например, 502 от обратного прокси или 520 от Cloudflare)так же, как другой код 4xx

Проверить, что отдаёт домен подписки на незнакомый путь:

curl -sS -o /dev/null -w '%{http_code}\n' https://sub.example.com/c1/test

404 — подписка добавляется сразу. Другой код 4xx или 5xx, либо 000 (соединение закрыто без ответа) — после трёх попыток канала, то есть на несколько секунд дольше; чтобы добавление шло сразу, настройте на незнакомые пути ответ 404. Страница с кодом 200 вместо ответа канала — сразу обычным способом.

Подписка не добавляется, если адрес канала перенаправляет на http:// или по цепочке из больше чем 10 редиректов. На /c1/… отвечайте без редиректа или с редиректом только на https://.

С прослойкой и выключенным каналом подписка добавляется обычным способом, без канала. Если канал включён, подписка добавляется им, а после переустановки прослойки (новый ключ) сама берёт новый ключ при следующем обновлении — с любой версией прослойки.

Внешний адрес и идентификатор устройства, связанные с подпиской, могут быть персональными данными по 152-ФЗ и GDPR, и их оператор — провайдер, а не авторы клиента. Включая приём отчётов или проверку 16–20, опишите это в своей политике конфиденциальности (цели, основание, сроки хранения, получатели) и известите пользователей. Что именно отправляет клиент — в политике конфиденциальности клиента.

Адрес замеров клиент узнаёт у ipify. В режиме TUN этот запрос идёт по правилам шаблона, поэтому добавьте оба адреса в DIRECT выше остальных правил — иначе в отчёт попадёт адрес выхода сервера, а не пользователя:

rules:
  - DOMAIN,api.ipify.org,DIRECT
  - DOMAIN,api6.ipify.org,DIRECT
  # … остальные правила

5. Лимит устройств

При включённом лимите панель не отдаёт подписку без x-hwid. Клиент шлёт его по умолчанию, идентификатор стабилен между обновлениями — устройство не будет регистрироваться заново.

При успешном ответе (2xx) с x-hwid-max-devices-reached, x-hwid-limit или x-hwid-not-supported клиент убирает прежние серверы этой подписки (даже если заглушки в панели выключены), а другие маршруты и запасной адрес не перебирает. Ответ с кодом ошибки — обычная неудача обновления, прежние серверы остаются.

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