Руководство Android

01 О приложении

KaproTUN для Android — бесплатный open-source клиент. Подключает телефон к вашему VPN-серверу через современные протоколы (VLESS, VMess, Trojan, Shadowsocks, Hysteria2) и пропускает весь системный трафик через зашифрованный туннель.

Главные особенности

• Работает с любыми серверами V2Ray / Xray — те же конфиги что и на десктопе
• Сплит-роутинг: 168 локальных доменов (банки, госсервисы, маркетплейсы) идут напрямую мимо VPN
• Блокировка рекламы через AdGuard DNS (~10 000 рекламных и трекинговых доменов)
• Per-app VPN: можно исключить отдельные приложения (например, банковский клиент, который не любит VPN)
• QR-сканер для импорта серверов с другого телефона
• Quick Settings tile — toggle VPN одним свайпом сверху
• Always-on VPN с kill-switch — гарантия что трафик не утечёт мимо туннеля
• Поддержка русского и английского интерфейсов
• Никакой телеметрии, никаких аналитик, никакой регистрации

Кому подходит

KaproTUN — это клиент. Сам сервер он не предоставляет. Вам нужен либо:

• Собственный VPN-сервер с настроенным Xray/V2Ray (DIY-вариант)
• Подписка у провайдера, который выдаёт share-URL или subscription-ссылку
• Друг, который поделится своим конфигом через QR-код или текстом

Если ничего из этого нет — посмотрите раздел про источники конфигов в десктоп-гайде.

Чего KaproTUN НЕ умеет

• Не работает с WireGuard (для WG используйте официальный клиент)
• Не блокирует рекламу в YouTube (DNS-уровень технически не способен — реклама YouTube доставляется с тех же доменов что и видео; для YouTube нужен браузерный uBlock Origin)
• Не открывает контент по геолокации (Netflix, BBC iPlayer и т. п. требуют разные серверы под каждый регион — KaproTUN их подключит, но за серверами обращайтесь к провайдеру)
• Не работает на iPhone — отдельная версия в разработке

02 Установка

Системные требования

• Android 7.0 или новее (API 24+) — около 98% всех Android-телефонов на 2026 год
• Около 50 МБ свободного места
• Архитектура процессора: ARM64 (современные телефоны), ARMv7 (старые), x86_64 или x86 (планшеты, эмулятор)

Где скачать

Все официальные сборки лежат на GitHub Releases. На странице релиза прикреплено 5 APK-файлов:

Установка APK

1. Скачайте подходящий APK на телефон (через браузер, Telegram или скиньте по USB).
2. Откройте файловый менеджер, найдите скачанный .apk.
3. Тапните по нему. Android спросит разрешение «установить из неизвестных источников» — разрешите для вашего файлового менеджера или браузера.
4. Подтвердите установку. Через 5–10 секунд KaproTUN появится в списке приложений.
5. Запустите. Иконка — янтарная буква «K» на тёмном фоне.

Подпись APK

Все официальные сборки подписаны одним и тем же ключом разработчика. SHA-256 отпечаток сертификата:

becb2aa5b6985755a0e74edd5d33fb5462eedf4f1a5397e75e8d0dc4e1c5f3af

Если кто-то соберёт KaproTUN с другим ключом и попытается выдать за обновление — установка не пройдёт. Это защита от подмены.

03 Первый запуск

При первом открытии приложение покажет главный экран с большой круглой кнопкой «CONNECT» и сообщением «Disconnected» под ней.

Разрешение на уведомления

На Android 13 и новее приложение запросит разрешение показывать уведомления. Согласитесь — без него VPN-туннель не будет иметь приоритета у системы, и Android может его убить при нехватке памяти. Уведомление показывает только статус подключения и кнопку «Отключить» — без рекламы, без push-сообщений.

Если случайно нажали «Запретить» и отметили «Не спрашивать снова» — приложение покажет понятный экран с кнопкой «Открыть настройки приложения», где можно дать разрешение вручную.

Разрешение на VPN

Когда первый раз нажмёте «CONNECT», Android спросит:

Это стандартный системный диалог, его показывает любой VPN-клиент. Согласитесь — иначе подключиться не получится. Разрешение даётся один раз.

04 Добавление сервера

Чтобы подключиться, KaproTUN нужно знать адрес вашего VPN-сервера. Это share-URL вида:

vless://uuid@example.com:443?security=reality&pbk=...&sid=...#Моё%20имя

Получить такой URL можно у вашего VPN-провайдера, либо собрать самостоятельно если вы держите свой сервер. В KaproTUN есть три способа добавить сервер. Откройте вкладку «Серверы» (вторая снизу) — там будет большая кнопка «Add» в правом нижнем углу. Тап по ней раскрывает меню с тремя вариантами.

Способ 1 — Вставить URL вручную

Самый простой если URL уже скопирован в буфер обмена (например, прислали в Telegram).

1. Меню «Add» → «Paste URL manually».
2. Появится диалог с двумя полями: «share-URL» и «Name (optional)».
3. Вставьте URL в первое поле (долгий тап → Paste).
4. Имя оставьте пустым — приложение возьмёт его из #fragment URL'а.
5. Нажмите «Save». Сервер появится в списке.

Способ 2 — Сканировать QR-код

Удобно если URL у друга на телефоне или провайдер показывает QR на сайте.

1. Меню «Add» → «Scan QR code».
2. При первом запуске Android спросит разрешение на камеру — выберите «При использовании приложения».
3. Откроется экран сканера с янтарной прицельной рамкой по центру.
4. Наведите камеру на QR-код. Распознавание автоматическое — как только KaproTUN увидит валидный share-URL, экран закроется и откроется диалог сохранения.
5. Подтвердите имя (если нужно), нажмите «Save».

Способ 3 — Импорт подписки

Если провайдер выдал не одну ссылку, а subscription-URL (с сотней серверов внутри).

1. Меню «Add» → «Import subscription».
2. Вставьте subscription-URL (обычно вида https://provider.com/sub/your-token).
3. Нажмите «Fetch». Приложение скачает список и покажет первые пять серверов с превью.
4. Нажмите «Add all (N)», где N — количество найденных серверов.

Подписка автоматически обновляется раз в 12 часов в фоне. Провайдеры часто меняют UUID или endpoints — будете получать свежий список без ручной работы. Можно выключить в Настройках.

05 Подключение к VPN

Главный экран «Home» — это большая круглая кнопка по центру и активный сервер внизу.

Что показывается

• Сверху — название приложения «KaproTUN».
• В центре — кнопка «CONNECT» (серая когда отключено, янтарная «DISCONNECT» когда подключено).
• Под кнопкой — статус: Disconnected, Connecting…, Connected · 0:00:42 · TUN (время подключения).
• Внизу — карточка с активным сервером. Тап на неё открывает вкладку «Серверы».

Как подключиться

1. Убедитесь что внизу есть карточка с сервером (если нет — добавьте по инструкции выше).
2. Нажмите большую кнопку «CONNECT».
3. Через 1–3 секунды кнопка станет янтарной «DISCONNECT», статус сменится на Connected · 0:00:01 · TUN.
4. Появится статистика трафика — стрелка вниз (загрузка) и стрелка вверх (отдача).

Как отключиться

• Нажмите кнопку «DISCONNECT».
• Тапните по уведомлению в шторке (там есть кнопка «Отключить»).
• Через Quick Settings tile (см. раздел 8).

Live-статистика трафика

↓ 12.4 MB · 1.2 MB/с
↑ 480 KB · 84 KB/с

Первая цифра — сколько прошло через VPN с момента подключения. Вторая — мгновенная скорость (обновляется раз в секунду). Когда отключаетесь, цифры сбрасываются и блок пропадает.

06 Управление серверами

Вкладка «Серверы» (вторая снизу) показывает все добавленные серверы.

Как устроен список

• Сверху — крупная карточка активного сервера с янтарной обводкой.
• Ниже — раздел «Other servers (N)» с остальными. Они компактнее и без обводки.

Действия с сервером

На каждой карточке справа есть три иконки:

• ✏️ Pencil — редактировать (изменить URL или имя).
• Share — поделиться сервером через QR-код или скопировать URL.
• 🗑 Корзина — удалить из списка.

Редактирование

Тап на pencil открывает диалог с pre-filled URL и именем. Можно:

• Изменить имя — если провайдер прислал ugly vless-46.17.101.82, переименуйте в NL-Amsterdam-1.
• Обновить URL — если провайдер сменил UUID, вставьте новый поверх старого.
• Очистить поле имени и сохранить — приложение само возьмёт имя из #fragment URL'а.

Поделиться сервером

Тап на иконку Share открывает диалог с:

• Большим QR-кодом, который можно сканировать другим телефоном.
• Полным share-URL в поле ниже (read-only, можно выделить и скопировать).
• Кнопкой «Copy» — копирует URL в буфер обмена.
• Кнопкой «Send…» — открывает системный share-sheet (Telegram, Messages, любое приложение).

Удалить сервер

Тап на корзину сразу удаляет сервер без подтверждения. Если удалили активный — приложение сбросит выбор. Удалённый сервер не восстанавливается.

Переключение активного сервера

Тап на любую не-активную карточку делает её активной. Старая превращается в обычную строку списка.

Проверка пинга

В правом верхнем углу вкладки «Серверы» есть кнопка «Обновить» (круговая стрелка). Тап запускает параллельный замер latency для всех серверов в списке.

Через 5–15 секунд на каждой карточке появится число миллисекунд с цветовой индикацией:

• Зелёный (<100 мс) — отличный пинг, сервер близко.
• Янтарный (100–300 мс) — нормальный для далёкого сервера, играть в шутеры не получится, веб-серфинг и видео — без проблем.
• Красный (>300 мс) — далеко или перегружен.
• unreachable — сервер не отвечает совсем (упал, IP сменился, или фильтрует провайдер).

07 Настройки

Вкладка «Settings» (правая снизу) содержит четыре блока: DNS, Behavior, Apps bypassing VPN, Always-on VPN.

DNS-сервер

Какой DNS использовать пока VPN активен. По умолчанию — System (Android сам выбирает). 4 варианта:

Behavior

Auto-connect on launch

Если включить — каждый раз когда открываете KaproTUN, приложение автоматически подключается к активному серверу. Удобно если используете VPN постоянно.

Auto-refresh subscription

Если вы добавляли серверы через subscription URL — этот тоггл (включён по умолчанию) обновляет список раз в 12 часов в фоне через WorkManager. Провайдеры часто меняют UUID и endpoints — без auto-refresh подписка постепенно «протухает».

Apps bypassing VPN

Тут можно выбрать приложения, которые не будут ходить через VPN. Их трафик пойдёт напрямую.

Зачем это нужно:

• Банковские клиенты часто блокируют логин с IP VPN-провайдеров. Исключите банк из VPN — будет нормально работать.
• У Telegram есть свой антицензурный механизм MTProto, который работает лучше чем прокся через VPN.
• Можно исключить торренты, Steam чтобы не нагружать VPN-сервер.

Чтобы открыть список:

1. Тапните по строке «Apps bypassing VPN».
2. Откроется экран со всеми установленными приложениями (с иконками и package-name).
3. В поиске сверху можно найти приложение по имени или package.
4. Поставьте галочки рядом с теми, кого хотите исключить.
5. Изменения вступают в силу при следующем подключении (переподключитесь после изменения списка).

Always-on VPN (kill-switch)

Это не настройка KaproTUN, а функция самой Android. Если включить, система:

• Автоматически запускает KaproTUN на загрузке телефона.
• Поддерживает VPN-туннель всегда активным.
• Блокирует весь трафик если туннель упал (это и есть kill-switch — гарантия что ничего не утечёт на реальный IP).

Кнопка «Open system VPN settings» открывает системный экран Android, где есть переключатели «Always-on VPN» и «Block connections without VPN». Включите оба.

08 Quick Settings tile

Android поддерживает виджеты в шторке уведомлений — те самые «плитки» которые появляются когда вы свайпаете сверху двумя пальцами. KaproTUN регистрируется как такая плитка и её можно вынести, чтобы toggle'ить VPN одним тапом без открытия приложения.

Как добавить плитку

1. Свайпните сверху вниз двумя пальцами, чтобы открыть полную шторку Quick Settings.
2. Найдите кнопку-карандаш «Edit tiles» (обычно внизу или сверху правого угла).
3. Откроется экран со всеми доступными плитками. Найдите «KaproTUN».
4. Перетащите её в верхнюю часть (где сами видимые плитки).
5. Вернитесь назад — плитка теперь в Quick Settings.

Как использовать

Тап на плитку:

• Если активный сервер выбран и VPN отключён — подключает к нему.
• Если VPN подключён — отключает.
• Если активного сервера нет — показывает «add a server first».

Под названием плитки видно текущее состояние: «нажми чтобы подключить», «подключение…», «подключено», «ошибка — открой приложение».

09 Логи

Вкладка «Logs» показывает live-вывод xray-core — внутреннего движка, который занимается шифрованием и проксированием. По умолчанию там тишина, потому что xray-core стартует с уровнем «warning» (показываются только важные сообщения).

Когда логи полезны

• Не подключается — на экране Connected, но веб не открывается. Загляните в логи, там обычно socks5 dial failed или что-нибудь конкретное.
• Сервер отваливается через несколько минут — в логах будет момент, когда xray ругнулся на TCP reset или TLS handshake fail.
• Подписка не подгружается — там будет HTTP error от subscription URL.

Что делать с логами

• Прокрутить вверх (старые записи) и вниз (новые).
• Тап «Очистить» в правом верхнем углу стирает буфер.

Если сообщаете об ошибке через GitHub Issues, скопируйте логи через долгий тап → Select All → Copy и приложите. Это сильно помогает понять причину.

10 Troubleshooting

11 Приватность и безопасность

KaproTUN — open-source клиент. Любой может скачать исходный код, посмотреть, скомпилировать сам и убедиться что внутри нет ничего подозрительного. Резюме того, что приложение делает с вашими данными.

Что хранится локально

• Список серверов (configs.json) — зашифрован AES-256-GCM через Android Keystore. Ключ генерируется на первом запуске и хранится в защищённом TEE/hardware enclave на поддерживающих устройствах.
• Настройки (settings.json) — DNS-опция, активный сервер, тоггл автоподключения. Plain JSON. Файл доступен только KaproTUN через систему permissions.

Что НЕ хранится

• История посещений сайтов — xray-core явно сконфигурирован с access-log: none.
• Скриншоты — приложение не делает их и не имеет permission'а.
• Контакты, SMS, фото, геолокация — у приложения нет соответствующих permissions.
• История трафика по дням/неделям — счётчики byte'ов сбрасываются на каждом disconnect.

Что не передаётся наружу

• Никакой телеметрии — приложение не отправляет данных о вашем использовании никуда.
• Никакой аналитики — нет Google Analytics, Firebase, Crashlytics, никаких SDK.
• Никаких регистраций — нет аккаунта, email, логина.

Единственный сетевой трафик от приложения помимо VPN-туннеля:

• Запрос subscription URL — только когда вы вручную добавляете подписку или раз в 12 часов в фоне (если auto-refresh включён). Запрос идёт на тот URL, который вы сами указали.
• Latency-проба — когда нажимаете кнопку Refresh на вкладке Серверы. Один HTTP-запрос к https://www.google.com/generate_204 через xray-pipeline проверяемого сервера.

Что видит ваш интернет-провайдер

После подключения к VPN провайдер видит только:

• Что вы подключены к одному IP-адресу (вашему VPN-серверу).
• Объём передаваемого трафика.
• Что трафик зашифрован (расшифровать не может).

Провайдер НЕ видит какие сайты вы посещаете и что именно там делаете.

Подпись и доверие к билду

Официальные APK подписаны ключом разработчика с отпечатком:

SHA-256: becb2aa5b6985755a0e74edd5d33fb5462eedf4f1a5397e75e8d0dc4e1c5f3af

Если скачали APK не с GitHub Releases — можете проверить:

keytool -printcert -jarfile KaproTUN-android-v0.1.0-arm64-v8a.apk

Сравните SHA-256 fingerprint с указанным выше. Совпадает — это официальный билд.

12 FAQ — частые вопросы

13 Благодарности и зависимости

KaproTUN построен на труде нескольких open-source проектов. Без них приложения бы не существовало.

VPN-движок

• Xray-core (XTLS/Xray-core) — мультипротокольный прокси, основа всей VPN-логики. Apache-2.0
• AndroidLibXrayLite (2dust) — JNI-биндинги Xray для Android. GPL-3.0
• hev-socks5-tunnel (heiher) — мост между TUN-интерфейсом Android и SOCKS5. GPL-3.0

UI и инфраструктура

• Jetpack Compose, CameraX, DataStore, WorkManager — Android Jetpack. Apache-2.0
• Material Icons Extended — иконки для UI. Apache-2.0
• ML Kit Barcode Scanning — распознавание QR на устройстве, без отправки в Google. Apache-2.0
• ZXing — генерация QR-кодов. Apache-2.0
• kotlinx.serialization — JSON-сериализация. Apache-2.0

Лицензия KaproTUN

Само приложение — GPL-3.0 (наследуется от hev-socks5-tunnel). Это означает:

• Можете использовать KaproTUN бесплатно, в коммерческих и личных целях.
• Можете изменять исходный код и распространять модифицированные версии.
• Если распространяете модификацию — обязаны опубликовать исходный код на тех же условиях GPL-3.0.
• Никаких гарантий — используйте на свой страх и риск.