Добро пожаловать в FAQ по v2Whitelist. Здесь собраны ответы на самые популярные вопросы по работе клиента, его архитектуре и фишках.
- 📖 Гайд: Как добавить свою подписку и настроить флаги?
- 📌 Общие вопросы (Батарея, скорость, безопасность)
- 🔄 Подписки и Обновления (OTA, Custom Endpoint)
- 🛠 Технические вопросы (Протоколы, YubiKey, CI/CD)
v2Whitelist создавался с фокусом на максимальную выживаемость в условиях жестких блокировок (Белые списки) и "однокнопочный" UX. Мы убрали сложную гиковскую настройку маршрутизации и добавили "Умное подключение" (Smart Connect). Приложение не просто пингует сервера, а выполняет реальные HTTP-запросы через них, чтобы убедиться, что DPI не обрезает трафик.
Нет. Мы вырезали из оригинального кода всю аналитику, рекламу и тяжелые фоновые процессы. Само «Умное подключение» (тестирование серверов) срабатывает только в момент нажатия кнопки. В фоне работает только легковесное ядро Xray, которое практически не расходует заряд аккумулятора — вся фоновая работа регулируется самой ОС Android. При отсутствии активного трафика VPN «засыпает». Единственный процесс, который изредка просыпается в фоне — это автообновление подписок. Оно скачивает всего пару килобайт текстовых данных и абсолютно никак не сказывается на батарее.
Встроенная подписка состоит из публичных серверов, которые в часы пик могут быть перегружены. Просто откройте список фильтров по странам и выберите другой регион. Альтернативно, вы всегда можете добавить свою приватную платную подписку в Настройках, и приложение будет использовать её.
Само приложение (клиент) не собирает никаких данных. В v2Whitelist полностью отсутствует телеметрия (никаких трекеров Яндекса, Google Analytics или логгеров), а исходный код открыт. Однако, стоит понимать, что серверы во встроенной подписке поднимаются и поддерживаются сторонними энтузиастами. Теоретически, они могут видеть метаданные (какие сайты вы посещаете), но благодаря HTTPS-шифрованию они не могут видеть ваши пароли, переписки или данные банковских карт. Для повседневного браузинга это абсолютно безопасно. Но если вам нужна максимальная приватность — используйте собственные серверы (через кастомные подписки или Custom Endpoint).
Это работает наш алгоритм Smart Connect. В отличие от обычных клиентов, которые отправляют пустой TCP-пинг, v2Whitelist пытается скачать крошечный файл (генерация 204 ответа) через каждый сервер из списка. Это занимает чуть больше времени (обычно пару секунд), но гарантирует 100% рабочее соединение. Если первый сервер оказался заблокирован или перегружен, приложение само найдет живой и подключится к нему.
В клиенте зашит системный список популярных российских приложений (Сбербанк, Тинькофф, ВТБ, Госуслуги, Ozon, Wildberries, ВКонтакте и др.). Если в настройках включен тумблер «Банки, Госуслуги вне VPN», трафик этих приложений будет идти напрямую, в обход VPN-туннеля. Это позволяет избежать блокировок со стороны самих банков и сервисов (они часто банят заграничные IP).
Единственный и оригинальный ТГ-канал разработчика — https://t.me/NullCoreDeveloper и обратится можно в директ канала.
Мы хотим, чтобы v2Whitelist работал по принципу «скачал и нажал одну кнопку». Встроенная подписка — это отказоустойчивая «матрёшка». Приложение тянет актуальные списки серверов из GitHub, где лежат ссылки на рабочие пулы узлов (включая VLESS/Reality). Даже если часть серверов умрёт, клиент динамически подтянет новые зеркала (fallback). Вы никогда не останетесь с неработающим приложением.
Однозначно да! За минималистичным экраном скрыта огромная глубина:
- Кастомные подписки: Вы можете добавлять любые свои провайдеры.
- Regex-фильтры: Напишите регулярные выражения для парсинга названий серверов из ваших подписок.
- Динамический UI: Ваши Regex-правила автоматически превращаются в удобную вкладку фильтрации по странам (с эмодзи-флагами).
- Копирование настроек (Шеринг): Вы можете настроить идеальную связку (кастомная подписка + Regex-фильтры) и сгенерировать один QR-код. Любой человек сканирует его — и получает точную копию вашего сложного конфига. Идеально для сисадминов, раздающих VPN родственникам.
Наши OTA (Over-The-Air) обновления работают внутри VPN-туннеля. Если доступ к GitHub заблокируют в вашей сети, приложение всё равно сможет скачать новую версию, используя текущее VPN-подключение. К тому же, загрузчик поддерживает докачивание (Resume) — если интернет оборвался, загрузка продолжится с того же места.
Это продвинутая функция для тех, кто хочет максимальной безопасности. Вы можете добавить свой личный, приватный прокси как конечный узел. Трафик будет идти так: Ваш телефон -> Публичный сервер Smart Connect -> Ваш приватный прокси -> Интернет. Это скрывает ваш IP даже от владельца первого сервера и позволяет использовать приватные узлы, не боясь, что их заблокируют напрямую по IP.
Даже если вы не программист, настроить v2Whitelist под свою подписку очень легко!.
Шаг 1: Добавляем подписку
- Откройте "Настройки" -> немного ниже "Группы" и там же "Дополнительно" -> "Управление подписками" -> "Добавить подписку".
- Придумайте любое имя (например, «Мой VPN»).
- Вставьте ссылку на вашу подписку в поле «URL подписки» и сохраните.
Шаг 2: Настраиваем фильтры (Regex)
Если ваш провайдер уже добавляет эмодзи-флаги в названия (например, 🇳🇱 Amsterdam), то v2Whitelist автоматически сгруппирует их по странам! Вам вообще ничего не нужно делать — просто нажмите на иконку Земли на главном экране.
Но если провайдер дает скучные названия (например, VLESS-NL-Amsterdam), вы можете помочь приложению:
- При добавлении или редактировании подписки (там же, где вводили URL) найдите поле Regex ждя групп/локаций.
- Приложение прочитает его, и то, что окажется внутри круглых скобок
(), станет названием группы в меню фильтров.
Пример (простыми словами):
Допустим, сервера называются Server-NL, Server-US.
Вы пишете в это поле Regex: -(..)
Что это значит: «найди тире -, а следующие 2 любых символа .. захвати в скобки». Приложение само вытащит NL и US и создаст удобные фильтры с этими названиями.
Или, если вы хотите отловить конкретные слова, напишите так: (США|Нидерланды|Германия). Вертикальная черта | означает «ИЛИ». Приложение сгруппирует сервера, найдя эти слова в названии. Готово! Вы великолепны.
Приложение использует актуальное ядро Xray-core. Поддерживаются все современные протоколы: VLESS, VMess, Trojan, Shadowsocks, а также самые передовые методы маскировки, включая Reality и XTLS.
Многие клиенты просто проверяют доступность TCP-порта сервера (открыт/закрыт). Это не работает против современных систем DPI (ТСПУ), которые могут разрешать TCP-соединение, но обрезать сам интернет-трафик. v2Whitelist делает полноценный HTTP-запрос (качает генерацию 204 ответа от Google). Если приходит корректный HTTP-ответ — значит интернет точно есть, и сервер признается рабочим.
Скорость. Парсинг кастомных подписок на несколько тысяч серверов и кэширование их статусов может заставить интерфейс "тормозить". MMKV от Tencent — это сверхбыстрое key-value хранилище на базе mmap (работает напрямую с памятью). Это позволяет v2Whitelist обрабатывать огромные списки прокси моментально и без фризов UI.
Философия проекта — работать "из коробки". v2Whitelist ориентирован на широкую аудиторию. Вместо того чтобы заставлять пользователя писать правила для каждого сайта, мы используем надежные списки GeoIP/Geosite и сплит-туннелирование по приложениям (Per-App Proxy).
Безопасность пользователей — наш приоритет.
- Аппаратная подпись кода: Все коммиты и изменения в этом репозитории вносятся исключительно автором и криптографически подписываются с помощью аппаратного ключа безопасности (YubiKey). Рядом с каждым коммитом на GitHub вы можете видеть зеленую плашку
Verified. - Защита релизов: Релизные ключи (Keystore) для подписи APK-файлов никогда не хранятся в открытом виде на серверах. Все сборки проходят через строгий автоматизированный CI/CD процесс на базе GitHub Actions, что гарантирует защиту от внедрения вредоносного кода (троянов). Скачивая приложение из официального репозитория, вы можете быть на 100% уверены в его оригинальности.
Абсолютно ни в чем. Для конечного пользователя разницы нет. Это технический рудимент, доставшийся в наследство от оригинальной сборочной системы (где libre-версия вырезала проприетарные библиотеки Google для публикации в F-Droid). Так как в v2Whitelist изначально нет никакой слежки, телеметрии и закрытых библиотек аналитики, обе сборки приложения абсолютно идентичны по функционалу и чистоте кода. Вы можете скачивать любую из них.