BoxyVPN / Блог / KoalaClash на Windows и macOS
Как настроить BoxyVPN через KoalaClash на Windows и macOS
KoalaClash — альтернатива Happ для тех, кто привык к экосистеме Clash или хочет более гибкую маршрутизацию (правила по доменам, по IP-диапазонам, разделение трафика по приложениям). Ниже — установка, импорт ключа BoxyVPN, миграция с Clash Verge Rev и обход «повреждённого приложения» в macOS.
TL;DR: 1) скачать KoalaClash под свою платформу из GitHub-релизов; на macOS — выбрать Apple Silicon или Intel в зависимости от процессора; 2) если стоял Clash Verge Rev — удалить его перед установкой; 3) на macOS при ошибке «повреждено» — выполнить
sudo xattr -r -c /Applications/Koala\ Clash.appв терминале; 4) в боте @boxyvpn_bot → «🔐 Моя подписка» → скопировать ссылку конфигурации; 5) вставить в KoalaClash, в разделе «Proxy» выбрать сервер.
01Когда KoalaClash, а когда Happ
Для большинства пользователей наша рекомендация — Happ Desktop. Он проще, ставится в один клик и не требует знания экосистемы Clash.
KoalaClash имеет смысл выбрать, если:
- Вы уже привыкли к Clash-клиентам (Clash for Windows, Clash Verge, Clash Meta) и хотите тот же интерфейс.
- Нужна гибкая маршрутизация: правила «этот сайт через VPN, этот напрямую», списки разрешённых и заблокированных доменов, правила по IP-диапазонам.
- Хотите разделить трафик по приложениям (например, банковский клиент идёт мимо VPN, а браузер — через него).
В остальных случаях Happ удобнее.
02Шаг 1 — скачать KoalaClash
На macOS важно скачать правильную сборку: для Mac на чипах M1/M2/M3/M4 — версию aarch64 (Apple Silicon), для старых Intel-маков — x86_64. Узнать процессор: меню Apple → «Об этом Mac». Универсальной (Universal) сборки KoalaClash на момент написания нет.
03Шаг 2 — миграция с Clash Verge Rev
Важно: если у вас уже установлен Clash Verge Rev — удалите его до установки KoalaClash. Два клиента борются за один и тот же системный TUN-интерфейс и могут конфликтовать: трафик может ломаться непредсказуемо, или один из клиентов перестанет видеть профили.
На Windows: «Параметры» → «Приложения» → найти Clash Verge → «Удалить». На macOS: перетащить Clash Verge.app из /Applications в корзину, опустошить корзину, затем удалить остаточные конфиги:
rm -rf ~/Library/Application\ Support/io.github.clash-verge-rev.clash-verge
rm -rf ~/Library/Logs/io.github.clash-verge-rev.clash-vergeПосле удаления — перезагрузите компьютер, чтобы освободить сетевые драйверы. Если KoalaClash вам не подойдёт, Clash Verge Rev всегда можно установить обратно.
04Шаг 3 — обойти «приложение повреждено» в macOS
macOS в Gatekeeper-режиме иногда блокирует приложения из GitHub-релизов с сообщением вида: «"Koala Clash" повреждён и не может быть открыт. Переместите его в корзину». Это не значит, что приложение действительно повреждено — это специальный режим защиты от приложений без подписи Apple.
Решение: открыть «Терминал» (Spotlight → «Terminal») и выполнить:
sudo xattr -r -c /Applications/Koala\ Clash.appКоманда запросит пароль администратора и удалит расширенный атрибут «карантина», который macOS навешивает на скачанные файлы. После этого приложение запустится нормально. Команду нужно выполнить один раз; обновления приложения тот же атрибут не возвращают.
05Шаг 4 — получить ключ и импортировать в KoalaClash
- Открыть @boxyvpn_bot.
- Если подписки нет — активировать 3-дневный пробный период без карты.
- В главном меню бота → «🔐 Моя подписка» → нажать «🔗 Ссылка на конфигурацию» (или открыть мини-приложение и взять ссылку оттуда).
- В KoalaClash открыть раздел Profiles (или «Профили») → нажать «Импорт» / иконку «вставить» → KoalaClash подтянет конфигурацию из буфера.
- Перейти в раздел Proxy (или «Прокси») → выбрать в группе сервер нужной локации (Финляндия, Нидерланды, Германия, Латвия, Швеция, США, Россия).
- Включить TUN-режим: в настройках («Settings» / «System Proxy») активировать TUN Mode — без него трафик через VPN пойдёт только из браузера, который явно использует системный прокси.
06Шаг 5 — обновить профиль и проверить
Перед первым подключением (и каждый раз, когда сервер не отвечает) обновите профиль:
- Открыть раздел Profiles.
- Рядом с профилем BoxyVPN нажать иконку обновления (часто это круговая стрелка).
- Дождаться завершения обновления.
Проверка соединения — стандартная: открыть ipinfo.io и убедиться, что IP-адрес и страна совпадают с выбранным сервером.
07Частые вопросы и проблемы
VPN включён, но трафик идёт мимо — IP не меняется+
Скорее всего не включён TUN-режим. В KoalaClash перейдите в Settings → System Proxy / TUN и активируйте «TUN Mode» (на Windows это часто требует прав администратора при первом включении). В режиме «только системный прокси» трафик через VPN идёт только из приложений, которые читают системные настройки прокси (браузеры) — но не из всех остальных.
Не открывается ни один сайт после включения VPN+
Обычно дело в TUN-драйвере, который не получил права. На Windows: запустите KoalaClash от имени администратора и снова включите TUN. На macOS: «Системные настройки» → «Сеть» → проверьте, что появился новый сетевой адаптер от KoalaClash и он активен. Если ничего не помогло — переключитесь временно на режим System Proxy (без TUN) и проверьте, работает ли он. Это локализует проблему.
KoalaClash зависает или потребляет много памяти+
В настройках профиля отключите автообновление, если оно стоит на «каждые 5 минут» — слишком частые обновления грузят CPU. Также проверьте, что в правилах маршрутизации не зацикленные ссылки на сами себя. Полный сброс: закрыть приложение, удалить файл профиля и импортировать ссылку из бота заново.
Можно ли использовать KoalaClash и Happ одновременно на одном компьютере+
На одном компьютере можно установить оба приложения, но включён в каждый момент должен быть только один из них. Они оба занимают системный TUN-интерфейс и конфликтуют. Удобный сценарий: использовать KoalaClash как основной, а Happ оставить «на всякий случай» как резервный — переключаться между ними по необходимости.
Подходит ли KoalaClash для одной подписки на нескольких устройствах+
Да. Один и тот же ключ BoxyVPN можно импортировать в KoalaClash на ноутбуке, в Happ на телефоне и в любом другом VLESS-клиенте на третьем устройстве. Базовый тариф поддерживает до 7 одновременных подключений. Доп. слоты докупаются в боте.
Где брать обновления KoalaClash+
На странице релизов: github.com/koala-clash/koala-clash-app/releases/latest. Встроенного автообновления может не быть — следите за свежими версиями вручную (обычно раз в 1–2 месяца). Конфиг и профили при обновлении сохраняются.
Нужен ключ?
Активируй 3-дневный пробный период в боте — без привязки карты. Один ключ работает и в KoalaClash, и в Happ, и на телефоне.
Открыть @boxyvpn_bot