Документация Wrabbit

Что такое Wrabbit

Wrabbit — клиент, а не VPN-сервис. У него нет собственных серверов и он не продаёт доступ. Вы добавляете свои vless://, trojan://, ss:// или ссылку на подписку — ключи и конфигурации хранятся только на устройстве.

• Ядро — Xray-core, протоколы VLESS, Trojan, Shadowsocks.
• Гибкая маршрутизация по спискам IP и авто-выбор сервера.
• Совместимость с подписками панелей (Remnawave и совместимых) — без аккаунта и регистрации.

Быстрый старт

• Установите Wrabbit на iPhone (iOS 16 и новее).
• Нажмите «+» и добавьте конфигурацию: вставьте ссылку из буфера, отсканируйте QR-код или вставьте URL подписки. Формат определяется автоматически.
• Выберите сервер или режим «Авто» и нажмите «Подключить». При первом подключении iOS попросит разрешить VPN-профиль.

Если подписка перестала отдавать серверы (истёк срок или исчерпан трафик), в карточке появится баннер и кнопка «Продлить» — данные о доступе берутся из ответа подписки, см. раздел «Подписки для провайдеров».

Импорт конфигов и подписок

Поддерживаемые форматы

Способы добавления

• Вставка из буфера обмена или в текстовое поле импорта.
• Сканирование QR-кода камерой.
• Ручной редактор конфигурации (VLESS / Trojan / Shadowsocks).

Клиент сам различает: одиночная http(s)://-ссылка без переносов строк → подписка; одиночная vless:// → отдельный сервер; многострочный текст или trojan:///ss:// → массовый разбор.

Обновление подписки

• Запрос идёт с User-Agent Wrabbit и без кеша (Cache-Control: no-cache), таймаут 20 секунд.
• Успешный ответ полностью заменяет список серверов подписки; ручной выбор сохраняется, если тот же сервер остался.
• Сетевые ошибки и коды 4xx/5xx старый список не трогают — показывается тост «Не удалось обновить».
• Авто-обновление — раз в сутки, глобальный тумблер в настройках. Заголовок интервала обновления из ответа подписки сейчас не учитывается.

Протоколы и транспорты

Для VLESS+REALITY нужны параметры pbk и sni (опционально sid, flow, fp, servicename). Для xHTTP/CDN — path и sni/host. Флоу: none или xtls-rprx-vision.

Маршрутизация

По умолчанию весь трафик идёт через туннель. Локальные/частные сети исключаются автоматически. Дополнительно можно вывести выбранные адреса напрямую, мимо туннеля (split-tunnel по IP).

Списки маршрутизации

• Формат — IPv4 CIDR (одиночный IP трактуется как /32). Разделители: перенос строки, запятая, пробел или ;.
• Списки добавляются текстом или по ссылке (обычный текстовый файл) и обновляются по этой ссылке.
• Для русской локали один раз подсевается готовый пресет RU-зоны; маршрутизация включается тумблером.

Авто-режим и выбор сервера

В режиме «Авто» перед подключением клиент пингует серверы группы через прокси (поднимает эфемерный Xray и проверяет доступность), затем выбирает быстрейший живой сервер.

Серверы делятся на зоны direct (быстрые прямые, например REALITY) и whitelist (пролезающие в зоне блокировок, обычно CDN-фронты). Приоритет — быстрейший живой direct; если таких нет — whitelist. На iPhone при нескольких кандидатах туннель умеет сам перезапускаться и переключаться между серверами при просадке связи.

Подписки для провайдеров

Wrabbit читает метаданные подписки двумя каналами: через HTTP-заголовки ответа (приоритетный источник) и, как фолбэк, через строку в теле подписки с префиксом # (например #wrab-mode: auto-only). Заголовок всегда важнее строки тела.

wrab-zone — роль сервера (в самой ссылке)

Per-server роль задаётся query-параметром в vless://: wrab-zone=direct (быстрый прямой) или wrab-zone=wl (CDN/whitelist). Если метки нет — роль выводится из транспорта: CDN/WebSocket → whitelist, REALITY → direct.

HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Profile-Title: base64:V3JhYg==
Subscription-Userinfo: upload=0; download=0; total=0; expire=1788000000
wrab-mode: auto-only

vless://uuid@nl1.example.com:443?type=grpc&security=reality&pbk=KEY&sni=cloudflare.com&sid=ab&wrab-zone=direct#NL-1
vless://uuid@cdn.example.com:443?type=xhttp&security=tls&sni=allow.example.com&path=/xh&host=allow.example.com&wrab-zone=wl#NL-1 CDN

Истёкшая или отключённая подписка

Если подписка перестала быть активной, панель отдаёт HTTP 200 с метаданными, но без серверов. Wrabbit считает это сигналом «доступа сейчас нет» (не ошибкой): серверы убираются, показывается баннер и кнопка продления (ведёт на Support-Url), активный туннель на исчезнувшем сервере отключается. Поле восстанавливается при следующем обновлении, когда серверы снова появятся.

Интеграция с Remnawave

Всё настраивается штатными средствами панели, без форков. Метки доставляются тремя способами:

• Глобально по клиенту — Subscription Response Rules: правило с условием user-agent CONTAINS wrabbit и заголовком, например wrab-mode: auto-only. Прочих клиентов правило не задевает.
• Точечно per-user / по группе — External Squads: поле responseHeaders, например { "wrab-mode": "auto-only" }, назначается выбранным пользователям.
• Роль сервера wrab-zone — через host-шаблоны или XRAY_JSON-шаблон; для текущего парка чаще достаточно эвристики по транспорту.

Брендинг в Remnawave: Announce ← happAnnounce, Support-Url ← supportLink (оба в subscription-settings), wrab-logo ← customResponseHeaders или responseHeaders External Squad.

Приватность и устройство

Wrabbit не ведёт логи трафика и не передаёт конфигурации третьим сторонам. При запросе подписки по умолчанию отправляются идентификатор устройства (HWID) и модель в заголовках x-hwid, x-device-os, x-ver-os, x-device-model — это нужно для корректного учёта устройств в панели. Отправку HWID можно отключить в настройках.

• Платформа: iPhone, iOS 16 и новее (Packet Tunnel / Network Extension).
• Без аналитики и трекеров; собираются только обезличенные отчёты о сбоях.
• Локализация: русский и английский (плюс системный язык).

Дополнительные функции

• Защита при разрыве (kill-switch) и автоподключение (on-demand).
• Статистика трафика сессии и пинг серверов через прокси.
• Импорт и экспорт по QR-коду, копирование и шаринг ссылок.
• Локальное редактирование конфигураций (если не скрыто провайдером).
• Фрагментация для CDN (анти-DPI) — глобальный тумблер и параметр fragment в ссылке.
• Журнал туннеля и логи Xray с экспортом для диагностики.

Чек-лист совместимости

• Возьмите ссылку подписки из панели и проверьте её в другом клиенте (например Happ) — wrab-* поля не должны ломать разбор.
• Откройте подписку в Wrabbit без wrab-mode — обычный список серверов и «Авто».
• Добавьте wrab-mode: auto-only — должна остаться только строка «Авто», серверы и пинги скрыты.
• Проверьте метки wrab-zone: «Авто» выбирает primary=direct, alt=whitelist.
• Сравните пинг «via Proxy» в Wrabbit и Happ — порядок величины должен совпадать.