Настройка панели 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/test404 — подписка добавляется сразу. Другой код 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 клиент убирает прежние серверы этой подписки (даже если
заглушки в панели выключены), а другие маршруты и запасной адрес не перебирает.
Ответ с кодом ошибки — обычная неудача обновления, прежние серверы остаются.