Руководство пользователя

01 Что такое KaproVPN

KaproVPN — это бесплатный VPN-клиент для Windows, macOS и Linux. Делает то же что любой VPN: шифрует ваш интернет-трафик и пропускает его через сервер в другой стране. От других VPN отличается одной важной вещью — он умеет одни сайты пускать через VPN, а другие через ваш реальный интернет, по списку который вы сами настраиваете.

На каких системах работает

Сколько весит

Само приложение — около 60 МБ. При первом подключении дополнительно скачивает около 25 МБ (VPN-движок Xray-core и сетевые компоненты). После — никаких больше загрузок, всё работает локально.

Сколько стоит

Ничего. KaproVPN бесплатный навсегда, исходный код открыт (GPL v3). Никаких подписок на само приложение, никакой рекламы, никаких premium-фич. Платить, возможно, нужно только за сам VPN-сервер — см. раздел 4.

02 Установка

Windows

1. Откройте github.com/fafnirov/KaproVPN/releases/latest
2. Скачайте файл KaproVPN-Setup.exe (~60 МБ).
3. Запустите двойным кликом. Windows может ругнуться SmartScreen — см. ниже.
4. В установщике нажмите «Установить». Прав администратора не требуется.
5. Через ~10 секунд готово. На рабочем столе и в Пуске появятся ярлыки.

macOS

1. Откройте github.com/fafnirov/KaproVPN/releases/latest
2. Скачайте файл KaproVPN-macOS-arm64.dmg.
3. Откройте DMG двойным кликом, перетащите KaproVPN в папку Applications.
4. Запустите из Launchpad или Applications.
5. При первом запуске macOS может ругнуться «разработчик не идентифицирован» — см. ниже.

Linux

1. Откройте github.com/fafnirov/KaproVPN/releases/latest
2. Скачайте файл KaproVPN-Linux-x64.AppImage.
3. Откройте терминал в папке загрузки.
4. Сделайте файл запускаемым:

chmod +x KaproVPN-Linux-x64.AppImage

5. Запустите:

./KaproVPN-Linux-x64.AppImage

AppImage — самодостаточный формат, ничего ставить дополнительно не нужно.

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

При первом запуске вы увидите экран приветствия с тремя карточками — это онбординг. Он один раз спрашивает откуда у вас будут конфиги, потом не показывается.

Три варианта на первом экране

«У меня есть subscription URL»

Самый удобный вариант если вы пользуетесь провайдером VPN. Subscription URL — это одна ссылка, по которой провайдер раздаёт все свои сервера. Один раз вставили — и у вас сразу 10-20 серверов на выбор. Дальше KaproVPN сам обновляет список (раз в 12 часов), без вашего участия. Откуда взять — раздел 4.

«У меня есть share-URL»

Если у вас один конкретный сервер от друга или вы сами держите свой VLESS-сервер — это share-URL. Выглядит как длинная строка, начинающаяся с vless://…, trojan://…, vmess://… или ss://…. Просто вставляете её в KaproVPN — он распарсит сервер и сохранит.

«Нет провайдера → открой гайд»

Если вы ещё не знаете откуда взять конфиг — кликните эту карточку, она откроет страницу на kaprovpn.pro/setup с списком рекомендованных вариантов и инструкциями.

После онбординга

Откроется главное окно с большой круглой кнопкой посередине и списком сохранённых конфигов внизу. Если конфигов нет — кнопка не активна, сначала надо добавить хотя бы один.

04 Где взять конфиг или подписку

KaproVPN — это просто клиент, программа которая подключается к VPN-серверу. Сам сервер нужно где-то достать. Это самый частый вопрос новых пользователей. Есть несколько вариантов, у каждого свои плюсы и минусы.

Что такое «конфиг» и «подписка» — разница

Конфиг (share-URL) — это одна строка с данными одного сервера. Выглядит так:

vless://uuid-вашего-аккаунта@server.example.com:443?security=reality&...#Имя

Содержит адрес сервера, порт, ваш персональный токен и параметры шифрования. По сути — это один «билет» на один сервер.

Подписка (subscription URL) — это одна ссылка, которая раздаёт сразу много share-URL. Когда KaproVPN заходит по этой ссылке, он получает обновлённый список серверов от провайдера. Удобно потому что:

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

Вариант 1 — Купить подписку у провайдера (проще всего)

Есть множество сервисов которые продают VPN-подписки по принципу «один URL — все наши сервера». Обычно стоит 100-500 рублей в месяц. Они дают subscription URL, который вы вставляете в KaproVPN.

Что искать в хорошем провайдере

• Поддерживает VLESS (особенно с REALITY или XHTTP) — это лучшие протоколы для работы под современной DPI.
• Несколько серверов в разных странах. Минимум 5-10.
• Не требует регистрацию по email/телефону (анонимность).
• Принимает оплату через крипту / Telegram-бот (без банковских карт).
• Возврат денег при первой проблеме (показатель что им важна репутация).
• Поддерживает subscription URL формат (а не только «вот вам один конфиг»).

Чего избегать

• Бесплатные «навсегда» сервисы — обычно медленные, перегруженные, либо тихо продают ваши данные.
• «Лучший VPN за 50₽» от неизвестного продавца на барахолках — может быть mass-scan на завтра.
• Странные сайты без отзывов и истории.

Вариант 2 — Поднять свой сервер (надёжнее всего)

Покупаете VPS (виртуальный сервер) за рубежом — Hetzner, OVH, Vultr, BuyVM, любой. Стоит €3-5/месяц. Ставите на него Xray + setup-скрипт (есть готовые от 3X-UI, Marzban, Hiddify-Server).

Готовые скрипты для поднятия

• 3X-UI — web-панель для управления xray, есть установщик-одной-командой.
• Marzban — то же, более «production-grade», для нескольких пользователей.
• Hiddify-Server — комплексное решение с маскировкой под обычный сайт.

Вариант 3 — Получить от друга

Если знакомый уже поднял сервер для себя, обычно он легко выдаёт share-URL под вас. Расходов почти не добавляет (на один сервер можно подключить десятки пользователей). Минус: вы доверяете другу видеть ваш трафик.

Вариант 4 — Free public servers (последняя альтернатива)

Существуют публичные free-серверы. Гуглится «free vless servers». Это работает в принципе, но:

• Очень медленно (тысячи человек на одном сервере).
• Часто блокируется (известные IP в банлистах).
• Высокий риск что владелец логирует трафик. Не использовать для чувствительных данных.

Подходит чтобы попробовать KaproVPN и убедиться что оно работает. Для регулярного использования — нет.

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

Шаг 1 — Добавить конфиг

Через subscription URL (если у вас подписка)

1. В главном окне в правом нижнем углу — кнопка «+» (добавить).
2. Откроется диалог. Внутри — поле «Subscription URL» и кнопка «Загрузить».
3. Вставьте полученный от провайдера URL → «Загрузить».
4. Через 1-2 секунды появится сообщение «Добавлено N серверов».
5. URL сохраняется — теперь KaproVPN будет обновлять список каждые 12 часов сам.

Через share-URL (один сервер)

1. В главном окне в правом нижнем углу — кнопка «+».
2. Вставьте share-URL (vless://… или trojan://… и т.д.) в поле «Адрес сервера».
3. Нажмите «Сохранить». Сервер появится в списке конфигов внизу.

Шаг 2 — Выбрать сервер

Под кнопкой подключения отображается список ваших серверов. У каждого видно: страну (флаг), имя, тип (VLESS/Trojan/...) и пинг до сервера (в миллисекундах). Чем меньше пинг — тем быстрее интернет через этот сервер. Кликните по нужному — он станет активным (подсветится).

Шаг 3 — Нажать «Подключить»

Большая круглая кнопка посередине. Кликните — через 1-3 секунды кнопка станет янтарной, под ней появится «Подключено · ЧЧ:ММ · HTTP» (или TUN, смотря какой режим выбран — см. раздел 7).

Шаг 4 — Отключение

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

06 Прямые сайты — главная фишка

Это та самая фича из-за которой KaproVPN отличается от обычных VPN. Список доменов которые НЕ идут через VPN, а ходят напрямую через ваш реальный интернет.

Зачем

• Банки и финтех-приложения — проверяют что вы из определённой страны. Через VPN либо не пускают, либо требуют СМС-подтверждения каждый раз.
• Госсервисы и налоговая отчётность — то же самое.
• Крупные маркетплейсы и доски объявлений — иногда тоже geofence-ят и тормозят через VPN.
• Стриминг-сервисы с региональными лицензиями — контент доступен только в определённых странах.

По умолчанию в списке 168 доменов — банки, госсервисы, основные маркетплейсы и медиа. Для типичного пользователя — достаточно с большим запасом.

Как редактировать список

1. В главном окне снизу — иконка шестерёнки (Настройки).
2. Найти раздел «Прямые сайты».
3. Кнопка «Редактировать» — откроется список.
4. Можно добавлять новые домены (например, sber.ru) и удалять ненужные.
5. Сохранить — изменения применятся при следующем подключении.

Что писать в список

• Только корневой домен — sber.ru, а не www.sber.ru/somepage.
• Поддомены подхватываются автоматически — sber.ru покроет online.sber.ru, vbr.sber.ru и т.д.
• Если сайт работает через много доменов — добавьте все.

Как понять что добавить

Подключитесь к VPN, откройте сайт который не работает. Если получаете «сайт недоступен в вашей стране» или бесконечную загрузку — посмотрите адресную строку. Корневой домен этого URL — кандидат в список.

Для сложных случаев откройте Developer Tools (F12 в Chrome) → вкладка Network → перезагрузите страницу. Видно какие домены подгружаются. Если несколько из них падают — добавьте все.

07 Два режима: HTTP-прокси и TUN

KaproVPN поддерживает два способа подключения. По умолчанию выбирается HTTP-прокси — он проще. TUN — для случаев когда нужно туннелировать всё.

Как переключить режим

1. Настройки (шестерёнка снизу).
2. Раздел «Режим подключения» или «TUN-режим».
3. Тогглнуть переключатель.
4. Переподключиться — режим применится.

08 Быстрое подключение из трея

В системном трее (правый нижний угол на Windows, верхняя строка на macOS) есть иконка KaproVPN. Через неё можно подключаться/отключаться без открытия главного окна.

Что в меню

• Подключить / Отключить — для текущего активного конфига.
• Топ-3 серверов по пингу — три самых быстрых ваших конфига. Клик переключает на этот сервер и подключает одним движением.
• Открыть KaproVPN — показывает главное окно.
• Выход — закрывает приложение полностью.

Топ-3 обновляется автоматически — приложение каждые несколько минут пингует ваши сервера и пересортировывает их.

09 Авто-переподключение

Иногда VPN-соединение разрывается не по вашей команде — провайдер интернета прервал сессию, сервер перезагрузился, флуктуация сети. Без авто-переподключения вы бы постоянно сидели и переподключали вручную.

Как работает

Если соединение оборвалось не по нажатию «Отключить» — KaproVPN сам пытается восстановить:

• Попытка 1 — через 1 секунду.
• Попытка 2 — через 5 секунд после неудачи 1-й.
• Попытка 3 — через 15 секунд после неудачи 2-й.
• Если все 3 провалились — появляется уведомление «Подключение нужно вручную», цепочка останавливается.

Во время попыток в главном окне отображается «Переподключение… попытка 2/3».

Когда не сработает

• Сервер реально умер (не временная проблема). Переключитесь на другой сервер вручную.
• Провайдер интернета вас полностью отрезал от внешнего мира. Тут VPN ничем не поможет.

10 Kill-switch — защита от утечек

Опциональная фича. По умолчанию ВЫКЛЮЧЕНА. Включается в Настройках.

Что это

Если VPN внезапно отвалился (упал xray, провайдер сбросил соединение) — ваш интернет автоматически продолжит работать… через реальный IP. Браузер не заметит — просто пакеты пойдут напрямую к провайдеру. Если в этот момент вы открыли что-то чувствительное — провайдер видит.

Kill-switch это блокирует. Если VPN упал — у вас НЕТ интернета (вместо «есть, но без защиты»). Браузер сразу показывает «нет связи», вы замечаете, переподключаетесь.

Когда включать

• Параноикам приватности — всегда.
• Если работаете с чувствительными данными через VPN — обязательно.
• Торренты под VPN — обязательно (иначе реальный IP может всплыть в логе раздачи).
• Обычное «открыть заблокированный сайт» — необязательно.

Как включить

1. Настройки (шестерёнка).
2. Найти переключатель «Kill-switch» или «Защита от утечек».
3. Включить.
4. При следующем подключении начнёт работать.

Как работает технически

При подключении KaproVPN добавляет 3 правила в Windows Firewall:

1. Заблокировать весь outbound-трафик.
2. Разрешить трафик в локальную сеть (чтобы пинговать роутер, шарить файлы).
3. Разрешить трафик от xray.exe (сам VPN-движок).

При отключении правила снимаются. Если приложение упало без cleanup'а (BSOD, форс-килл) — при следующем запуске KaproVPN обнаруживает orphan-правила и убирает их сам.

11 Авто-обновление подписки

Если вы подключили subscription URL, KaproVPN автоматически обновляет список серверов раз в 12 часов. В фоне, без вашего участия.

Что делает

• Каждые 12 часов идёт к URL подписки.
• Получает свежий список — провайдер мог добавить новые сервера, поменять параметры.
• Добавляет новые сервера в ваш список.
• Сервера которых нет в новом списке — НЕ удаляются. Защита от ситуации «провайдер временно лёг → ваш список опустел → подключиться нечем».

Если что-то добавилось — увидите небольшое уведомление «Subscription обновлена, +N серверов». Если ничего нового — никакого шума, тихо проверилось.

Как выключить

Настройки → переключатель «Auto-refresh подписки» → выкл.

12 Обновление самого приложения

KaproVPN сам проверяет обновления при запуске и предлагает поставить новую версию когда она выходит.

Как это выглядит

1. Запустили приложение. Через ~10 секунд в фоне идёт проверка.
2. Если новая версия — небольшой toast: «Доступна версия X.Y.Z. Обновить?»
3. Согласились — приложение само скачает новый Setup из GitHub Releases и запустит в «тихом режиме».
4. Через минуту — KaproVPN перезапустится в новой версии. Все ваши конфиги и настройки сохранятся.

Что обновляется

• Само приложение (UI, новые фичи, исправления багов).
• Если в новой версии нужен более свежий xray — он сам скачается при следующем подключении.
• Ваши конфиги, подписки, настройки, список прямых сайтов — НЕ трогаются.

Если не хотите авто-обновления

Настройки → «Проверять обновления» → выкл. Тогда придётся следить вручную за релизами на GitHub.

13 Если что-то пошло не так

route delete <ip-вашего-vpn-сервера>

route delete 1.2.3.4

netsh advfirewall firewall delete rule name="KaproVPN-Block-All"
netsh advfirewall firewall delete rule name="KaproVPN-Allow-LAN"
netsh advfirewall firewall delete rule name="KaproVPN-Allow-Xray"

14 Приватность — что мы НЕ собираем

Многие VPN-сервисы рекламируют «no logs», а на самом деле собирают телеметрию, аналитику, отправляют ошибки в облака. KaproVPN — нет.

Конкретно мы НЕ собираем

• Никакой аналитики (типа Google Analytics).
• Никакого error-reporting (типа Sentry).
• Никакого «phone home» при запуске.
• Никаких user-ID, install-ID, anonymous-ID.
• Никакой логировки ваших подключений на нашей стороне.

Единственный network-call к нашей инфраструктуре

При запуске приложение проверяет обновления через GitHub API (api.github.com). Это не наш сервер — это GitHub. Мы оттуда получаем только tag последнего релиза. GitHub видит ваш IP при запросе, но не знает что это от KaproVPN.

Файлы которые лежат у вас на диске

В папке %LOCALAPPDATA%\KaproVPN\ (Windows) хранится:

• configs.json — ваши сервера. На Windows ЗАШИФРОВАНО через DPAPI (тем же механизмом которым Chrome шифрует пароли). Другой пользователь / приложение прочитать не может.
• sites.json — список прямых сайтов. Не шифруется (там нет секретов).
• settings.json — настройки. В нём хранится URL подписки — если URL содержит токен, это чувствительная информация.
• xray.log — технический лог. Без access-логов — никаких записей «кто куда подключался».

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

• Что вы подключены к IP вашего VPN-сервера. Что именно идёт через шифрованный туннель — не видит.
• Прямые сайты — провайдер видит так же как без VPN, что вы туда заходите. Это и есть смысл «прямых сайтов».
• DNS-запросы для прямых сайтов — тоже видит. DNS для не-прямых идёт через туннель.

Что НЕ защищает

• Компромисс самого VPN-сервера. Если провайдер VPN скомпрометирован — KaproVPN не поможет.
• Атаки на ваш компьютер. Если на компьютере malware — он может всё увидеть до шифрования.
• Анализ behaviour. Даже если контента не видно, паттерн «трафика много в 23:00, маленькими пакетами» может намекнуть. Защиты нет ни у кого.

15 Как удалить

Способ 1 — Через Программы и компоненты (рекомендуется)

1. Пуск → ввести «Установка и удаление программ» → открыть.
2. Найти в списке «KaproVPN».
3. Кликнуть → «Удалить».
4. Подтвердить в окне KaproVPN.
5. Через 5-10 секунд — готово.

Способ 2 — Через сам KaproVPN-Setup.exe

1. Запустить KaproVPN-Setup.exe (тот же файл которым устанавливали).
2. Приложение детектит что KaproVPN уже стоит и показывает экран с двумя кнопками.
3. Нажать «Удалить KaproVPN».
4. Подтвердить в следующем окне.

Что удаляется

• Само приложение из %LOCALAPPDATA%\Programs\KaproVPN\.
• Ярлыки в Пуске и на Рабочем столе.
• Запись в Программах и компонентах.

Что НЕ удаляется автоматически

В %LOCALAPPDATA%\KaproVPN\ остаются скачанные xray.exe, tun2socks.exe, wintun.dll (~25 МБ), ваши конфиги, настройки и логи. Это сознательно — если вы поставите KaproVPN заново через неделю, не придётся заново скачивать.

Если хочется удалить полностью:

1. Сначала через Программы и компоненты — KaproVPN.
2. Потом вручную: Проводник → %LOCALAPPDATA%\KaproVPN → удалить эту папку.

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

17 Поддержка и обратная связь

Нашли баг или есть предложение

Создайте issue: github.com/fafnirov/KaproVPN/issues/new

В описании бага полезно указать:

• Какая версия KaproVPN (видно в Настройках → внизу или в About).
• Какая операционная система (Windows 11 / macOS 14 / Ubuntu 22.04 / ...).
• Что вы делали и что произошло.
• Что ожидали что произойдёт.
• Если возможно — приложите xray.log (находится в %LOCALAPPDATA%\KaproVPN\xray.log).

Вопросы по использованию

Сначала проверьте раздел 13 — Troubleshooting. Если не помогло — GitHub Discussions.

Безопасность (нашли уязвимость)

Не пишите публично в issue. Свяжитесь по адресу указанному в SECURITY.md в репозитории. Просим 14 дней на починку перед публикацией. Кредит указывается в CHANGELOG, готовы оформлять CVE через GitHub Security Advisories.

Хотите помочь проекту

Полезные направления:

• Перевод на другие языки — сейчас только русский и английский.
• Тестирование на нестандартных конфигурациях (старые Windows, экзотические Linux).
• Issue triaging и помощь другим юзерам в Discussions.
• Если умеете программировать — pull requests на GitHub.