Один VPN-клиент, чтобы править всеми: как подружить несколько туннелей на macOS
Исходники и сборка
- Репозиторий Bridge — код, issues, инструкция по установке
- Последний релиз — Bridge.zip и контрольная сумма
Внутри работают amneziawg-go (MIT), OpenVPN (GPL-2.0), OpenConnect (LGPL-2.1) и Xray-core (MPL-2.0). Спасибо их авторам — без них этого проекта не было бы.
Зачем это понадобилось
Мне нужно было держать на Mac несколько VPN одновременно и пускать в каждый только свой трафик.Готового клиента, который это умеет, я не нашёл, поэтому написал Bridge: приложение в строке меню macOS с привилегированным helper’ом, которое поднимает AmneziaWG, WireGuard, OpenVPN, OpenConnect, VLESS, Trojan и Hysteria 2 параллельно, с раздельным туннелированием и split DNS. Казалось бы, что может пойти не так? Как выяснилось, маршрут по умолчанию, DNS и моё терпение.
Что умеет Bridge
Bridge — бесплатный клиент с открытым исходным кодом под лицензией MIT для macOS 14 и новее. Он живёт в строке меню и не требует Network Extension, аккаунта Apple Developer и App Store. Иконки в Dock тоже нет: VPN-клиент, как хороший сисадмин, должен быть незаметен, пока всё работает.
Архитектура
Bridge состоит из двух частей: приложение работает от имени пользователя, а helper — от root. Всё, что требует привилегий, делает helper: создаёт интерфейсы, ставит маршруты, пишет DNS и правила pf. Это launchd-демон /Library/PrivilegedHelperTools/com.rtmo0.bridge.helper, он держит туннели даже с закрытым приложением. Приложение и CLI говорят с ним одним протоколом: одна JSON-строка на запрос через Unix-сокет. Никакого XPC и gRPC: протокол, который можно отладить глазами, ломается реже.
Архитектура Bridge
Приложение хранит конфиги и пароли и отправляет helper’у текст конфига вместе с настройками маршрутизации. Helper запускает нужный бэкенд. OpenVPN и OpenConnect сообщают о своих событиях через хуки, и в роли этих хуков запускается сам bridge-helper, на схеме это пунктирные стрелки.
Раздельное туннелирование: кто владеет маршрутами
Все туннели сосуществуют, потому что маршруты ставит один процесс и записывает каждый свой маршрут. Удаляет он только свои маршруты. Если route add отвечает File exists, маршрут считается чужим и при отключении не трогается.
Подъём туннеля идёт в таком порядке:
- Адрес сервера резолвится до того, как меняются маршруты. Иначе DNS-запрос уйдёт в ещё не поднятый туннель.
- До сервера туннеля ставится host-маршрут через физический интерфейс. Иначе зашифрованные пакеты попадут в сам туннель. Физический выход (Wi-Fi, Ethernet, точка доступа iPhone) Bridge ищет в netstat -rn среди маршрутов default, пропуская utun, ipsec, ppp и другие виртуальные интерфейсы. Это важно, когда основным маршрутом уже владеет другой туннель.
- Сети-исключения получают маршрут через текущий шлюз. Это режим «всё, кроме…» и локальная сеть.
- Сети туннеля направляются в его utun. Для полного туннеля маршрут по умолчанию не заменяется, а делится пополам на 0.0.0.0/1 и 128.0.0.0/1 (для IPv6 — на ::/1 и 8000::/1). Тот же приём использует wg-quick: более длинный префикс побеждает, а системный default остаётся на месте. Его никто не трогает, его просто вежливо обходят с двух сторон.
Режим «весь трафик» может быть только у одного туннеля. Второй такой туннель Bridge не поднимает и пишет понятную ошибку. Два туннеля с /1-маршрутами дрались бы за одни и те же префиксы.
При смене сети срабатывает уведомление SCDynamicStore об изменении сетевого состояния. Helper заново находит физический выход и, если шлюз или интерфейс поменялись, переставляет host-маршруты и переподключает OpenVPN. Список добавленных маршрутов сохраняется в /var/run/bridge/state.json. После падения helper сначала убирает оставшиеся маршруты и только потом начинает принимать команды.
Split DNS на macOS
Раздельные маршруты бесполезны, если jira.corp.example резолвится публичным DNS. Пакеты бодро летят в правильный туннель — по адресу, которого не существует. На macOS эта задача решается системным способом, без правки /etc/resolver и без своего DNS-прокси: через динамическое хранилище SystemConfiguration.
Для каждого туннеля helper публикует ключ State:/Network/Service/Bridge-<имя>/DNSс ServerAddresses и SupplementalMatchDomains. configd превращает его в supplemental-резолвер: запросы к этим доменам и их поддоменам уходят на DNS туннеля, всё остальное — на обычный резолвер. Вот как это видит scutil --dns при подключённом корпоративном OpenVPN:
resolver #2 domain : corp.example nameserver[0] : 10.100.105.1 flags : Supplemental, Request A records order : 103000
Ключи создаются как временные для сессии helper’а. Если helper упадёт, configd сам их уберёт, и DNS не останется смотреть в мёртвый туннель. Два особых случая:
- Полный туннель. Сервис помечается OverridePrimary, и его DNS становится основным.
- Раздельный туннель, сервер прислал DNS, но не домены. Как Tunnelblick и Shimo, Bridge делает DNS VPN системным, не трогая маршруты. Исходные настройки основного сервиса сохраняются на диск. Сторож проверяет, чтобы DHCP и другие VPN не перезаписали их обратно.
У каждого бэкенда свой способ сообщить, какой DNS прислал сервер. OpenVPN 2.7 запускает команду dns-updown, а в её окружении передаются серверы и домены (dns_server_*, dns_search_domain_*). В роли этой команды выступает сам bridge-helper: он пересылает окружение демону по сокету, а туннель определяется по PID родительского openvpn. OpenConnect делает то же через vpnc-script.
История из жизни. В одном корпоративном профиле была строка pull-filter ignore "dhcp-option DNS". Наверное, её добавили, чтобы VPN не забирал весь DNS. Из-за неё OpenVPN выбрасывал адрес резолвера ещё до dns-updown, и split DNS молча не работал: публиковать было нечего. Классика: работает всё, кроме того, ради чего всё затевалось. Теперь, если пользователь явно просит split DNS, Bridge удаляет только те pull-filter, что совпадают с двумя формами DNS-опции OpenVPN (dhcp-option dns и dns server). Остальные фильтры профиля остаются на месте.
Безопасность: root-демон и недоверенные конфиги
Самое чувствительное место любого VPN-клиента без Network Extension — демон с правами root, который принимает конфиги от пользователя. Модель угроз такая: любой процесс, запущенный от имени пользователя, может отправить helper’у что угодно. Значит, helper не должен давать ничего, что выходит за рамки «поднять и опустить туннель».
Кто может управлять. Сокет /var/run/bridge/helper.sock открыт для подключения всем, но у каждого соединения helper через getpeereid() узнаёт UID и проверяет членство в группе admin. События хуков OpenVPN и OpenConnect принимаются только от UID 0.
Что вырезается из конфигов. Конфиг OpenVPN может запустить произвольную команду от root, поэтому перед запуском из него удаляется:
- всё, что запускает программы: up, down, route-up, plugin, tls-verify и другие хуки;
- всё, что загружает код: providers, engine;
- всё, что пишет файлы: log, status, writepid, replay-persist, tls-export-cert;
- setenv, кроме setenv opt.
Серверные конфиги и config с включением других файлов отклоняются. Сертификаты и ключи должны быть встроены в конфиг: приложение вставляет их при импорте. Иначе root прочитал бы любой файл по пути из конфига. Из конфигов WireGuard вырезаются PreUp, PostUp и PostDown. OpenVPN собирается с --disable-plugins и --disable-pkcs11.
Найдено и закрыто в 0.6.9. При аудите нашлись два способа выполнить код от root из процесса пользователя, и оба поучительны. Нашёл их я сам, что одновременно повод для гордости и для стыда:
- Подстановка опции в OpenConnect. URL сервера из запроса шёл последним аргументом openconnect. Значение --script=/tmp/x.sh перекрывало --script от Bridge. Теперь принимается только https://, а перед адресом стоит --.
- setenv DYLD_INSERT_LIBRARIES в конфиге OpenVPN. OpenVPN передаёт такие переменные скриптам, а скриптом был сам bridge-helper от root, подписанный ad-hoc. Dyld такие переменные слушается. Исправление двойное: setenv вырезается, а bridge-helper и bridge теперь подписываются с hardened runtime (codesign --options runtime), и dyld игнорирует DYLD_*.
Kill switch на pf. Правила живут в якоре com.apple/bridge, который стандартный /etc/pf.conf уже вычисляет через anchor "com.apple/*". Системный конфиг править не приходится. pf включается со счётчиком ссылок (pfctl -E, затем pfctl -X), поэтому другие пользователи pf не страдают. Разрешены интерфейсы туннелей и адреса VPN-серверов, всё остальное блокируется. Если туннель упал, блокировка остаётся, пока пользователь сам её не снимет. Лучше пять минут без интернета, чем пять минут интернета, о которых знает провайдер. Те же правила блокируют IPv6 в обход полного туннеля, если у самого туннеля IPv6 нет.
Что остаётся открытым: любой процесс администратора может подключить свой VPN и пустить через него трафик. Чтобы это закрыть, нужно проверять подпись клиента по audit token, а для этого нужен Developer ID.
Сборка, релизы и автообновление
Релиз выходит одной командой: git tag v0.6.9 && git push origin v0.6.9. Дальше GitHub Actions на macos-latest собирает всё с нуля примерно за 4 минуты — ровно столько, чтобы заварить чай:
- Прогоняет swift test (парсеры конфигов, маршрутизация, жёсткие правила для OpenVPN).
- Собирает OpenVPN, Xray-core и OpenConnect из исходников со статическими зависимостями. То, что найдёт pkg-config в системе, не используется: иначе бинарник случайно привязывается к Homebrew.
- Собирает Swift-часть универсальным бинарником (arm64 и x86_64), складывает Bridge.app и подписывает его ad-hoc. Helper и CLI подписываются с hardened runtime.
- Публикует релиз с Bridge.zip и Bridge.zip.sha256.
Автообновление не ходит в REST API GitHub, у которого лимит 60 запросов в час без авторизации. Оно открывает /releases/latest: GitHub перенаправляет на /releases/tag/<тег>, и из конечного URL видна версия. Архив скачивается по прямой ссылке /releases/download/<тег>/Bridge.zip и сверяется с SHA-256. Версия helper’а записана рядом с ним. Если она не совпадает с версией приложения, приложение просит переустановить helper, и на это уходит один ввод пароля.
Ограничения и планы
Честно о том, чего пока нет:
- Нет нотаризации. При первом запуске Gatekeeper предупредит, что приложение не проверено. Разрешить запуск можно в «Системных настройках» → «Конфиденциальность и безопасность» или командой xattr -dr com.apple.quarantine /Applications/Bridge.app.
- OpenVPN и OpenConnect собраны только для Apple Silicon. На Intel работают AmneziaWG, WireGuard и всё, что идёт через Xray.
- Режим «весь трафик» доступен только одному туннелю одновременно. Это осознанное ограничение: два таких туннеля по определению конфликтуют. Два капитана на одном корабле — это не команда, а бунт.
- Нет Network Extension, поэтому нет и App Store. Зато можно запускать любые бэкенды как есть. Цена — root-демон и необходимость следить за ним, об этом раздел выше.
В планах Developer ID и нотаризация: Apple ждёт свои $99 в год и рано или поздно дождётся. После них приложение будет устанавливаться без предупреждений, а helper сможет принимать команды только от подписанного клиента.