Все разделы документации
Коротко, а ниже — подробно по каждому пункту.
| Ограничение | Коротко |
|---|---|
| UDP, звонки и игры | Через прокси идёт только TCP. UDP приложения на прокси блокируется или идёт напрямую. |
| Правила по доменам | Срабатывают, только когда приложение называет имя сайта. Соединения на голый IP идут по маршруту приложения. |
| Профили браузера | Все профили одного браузера идут одним маршрутом. |
| Перезапуск расширения | Пару секунд новые соединения могут уйти напрямую. |
| Другие VPN и расширения | Routekeeper о них не знает и конфликты не проверяет. |
| Рабочий HTTP-прокси | Только Basic-авторизация, без NTLM, Kerberos и PAC. |
| Типы прокси | Только SOCKS5, HTTP и HTTPS. Остальные протоколы — через локальный клиент. |
UDP: звонки, голос и игры
Что вы заметите.
- В приложении, которое идёт через прокси, не соединяются или обрываются аудио- и видеозвонки, не работают голосовые каналы.
- Онлайн-игры через прокси не подключаются или сильно задерживаются.
- Браузер на прокси открывает сайты как обычно, но без QUIC (HTTP/3). Обычно этого не видно.
Почему. Прокси, с которыми работает Routekeeper (SOCKS5, HTTP и HTTPS), передают только TCP. UDP приложения, у которого маршрут через прокси, в прокси не попадает никогда:
- по умолчанию он блокируется: у прокси включён переключатель Блокировать UDP и QUIC;
- если переключатель выключить, UDP идёт напрямую, и монитор отмечает его как UDP мимо прокси.
Звонкам и играм обычно нужен UDP. Браузеры, увидев, что QUIC закрыт, сами переходят на TCP. Карточка сервиса (ⓘ в разделе Приложения) предупреждает об этом, например: «Звонки идут по UDP и через прокси не работают».
Что можно сделать.
- Оставьте приложения для звонков и игры на маршруте Напрямую.
- Если приложению нужен прокси, но и звонки тоже, выключите у его прокси Блокировать UDP и QUIC. Переписка и файлы пойдут через прокси, а звонки — напрямую, с вашим обычным адресом. Монитор будет отмечать их как UDP мимо прокси. Переключатель относится к прокси, поэтому действует на все приложения, которые через него идут. Подробно — «DNS через прокси и блокировка UDP».
- Если через сервер должны идти и звонки, нужен инструмент, который передаёт UDP, например VPN. Routekeeper этого не делает.
Подробнее: UDP и DNS у приложения на прокси
- Передачу UDP через SOCKS5 (UDP ASSOCIATE) Routekeeper не использует.
- Запросы DNS по UDP (порты 53 и 853) у приложения на прокси не блокируются, а идут напрямую и отмечаются как DNS мимо прокси. Заблокировать их можно правилом. Как это работает — в разделе «DNS: как приложения узнают адрес сайта».
- Для TCP-соединений через прокси имя сайта узнаёт сам прокси, если включено DNS через прокси (включено по умолчанию).
- С Настройки → Сеть → Узнавать адреса сайтов через прокси DNS-запросы по UDP на порт 53 у приложения на прокси идут через прокси, кроме локальных имён. Подробнее — «Адреса сайтов через прокси».
Правилам по доменам нужно имя сайта
Что вы заметите. Правило вроде *.example.com → Через прокси или правило сервиса ловит не весь трафик: часть соединений идёт по маршруту приложения, например напрямую. В мониторе у таких соединений в столбце Хост стоит голый IP, а в поле Решение — маршрут приложения, а не ваше правило.
Почему. Правила по доменам и сервисам сравнивают имя сайта, которое приложение называет при соединении. У соединений на голый IP имени нет, у большинства соединений UDP и QUIC тоже. Некоторые приложения сами узнают адреса и соединяются только по IP. Без имени правило не срабатывает, и соединение идёт по маршруту приложения. Исключение — сервисы, в списке которых есть подсети: они срабатывают и по IP.
Что можно сделать.
- Если через прокси должно идти всё приложение, задайте маршрут в разделе Приложения, а не правила по доменам.
- Если вы знаете адреса, добавьте правило по IP или подсети (CIDR). Как записать — в разделе «Поля правила».
- Для браузера и сервиса заблокируйте браузеру UDP на порт 443. Тогда браузер перейдёт на TCP, где имя сайта есть. Пошагово — в рецепте «Один сервис в браузере через прокси».
Подробнее — в разделе «Правила по именам сайтов».
Два профиля одного браузера
Что вы заметите. Вы хотите, чтобы профиль «Работа» шёл через один прокси, а «Личное» — через другой. Оба идут одинаково.
Почему. Routekeeper узнаёт приложения по подписи кода и процессам. Все профили одного браузера — это одно приложение и одни процессы, а профиль на уровне сети не виден.
Что можно сделать.
- Используйте разные браузеры, например Chrome для работы и Firefox для личного. Каждому можно задать свой маршрут.
- Внутри одного браузера делите трафик по сайтам: правила по доменам или сервисы. Подробно — в разделе «Сервисы».
Подробнее: бета-версии браузеров
Chrome Beta, Dev и Canary — отдельные приложения со своей подписью, им можно задать свой маршрут. Но если у Chrome включено Вместе с дочерними процессами, его маршрут покрывает и их: их signing ID начинается с signing ID Chrome, а разработчик тот же. Чтобы бета-версия шла отдельно, добавьте её в Приложения со своим маршрутом. Правило для точного приложения важнее правила для дочерних процессов. Так же устроены бета-версии Edge.
Пауза при перезапуске расширения
Что вы заметите. После обновления расширения (начиная с версии 0.5.0 оно обновляется само, сразу после обновления приложения), после Переустановить или если macOS перезапустила расширение, соединения через прокси обрываются, и приложения подключаются заново. В течение пары секунд новые соединения могут пойти напрямую, мимо прокси. В мониторе их нет.
Почему. Routekeeper принимает решения внутри сетевого расширения. Пока оно перезапускается, соединения никто не проверяет, и macOS пропускает их как обычно. Когда расширение обновляют кнопкой в баннере, Routekeeper предупреждает об этом в окне подтверждения.
Что можно сделать.
- Обновляйте Routekeeper, когда закрыты приложения, которым важно идти только через прокси: начиная с версии 0.5.0 расширение обновляется вместе с приложением. В версии 0.4.1 и раньше расширение обновляется только из баннера: Обновить…, затем Обновить сейчас или Позже. Как обновлять Routekeeper — на странице «Обновление и удаление».
- После обновления или переустановки перезапустите такие приложения: завершите и откройте снова. Уже открытые соединения маршрут не меняют. Соединение, открытое напрямую во время паузы, так и останется прямым, пока не закроется.
- Проверьте в мониторе, что новые соединения приложения идут через прокси.
Подробнее: когда соединения не уходят напрямую
Если фильтр Routekeeper уже работает, а часть, которая отправляет трафик через прокси, ещё нет (например, сразу после запуска Mac), соединения на прокси блокируются, а не уходят напрямую. Приложение получит ошибку и повторит попытку. Это поведение без ухода напрямую.
Тумблер Routekeeper включён и Остановить… пускают всё напрямую намеренно — чем отличаются способы выключить, написано на странице «Обновление и удаление».
Другие VPN и сетевые расширения
Routekeeper не проверяет, есть ли на Mac другие VPN, клиенты прокси или файрволы, и не предупреждает о них. Что происходит рядом с ними, следует из того, как Routekeeper устроен:
- Соединения, которые не идут через прокси (маршрут Напрямую или нет правила), Routekeeper отдаёт macOS нетронутыми. Дальше они идут так, как их направит система, — через другой VPN, если он включён.
- Соединение самого Routekeeper с прокси-сервером тоже идёт так, как направит система. Если включён VPN на весь трафик, соединение с прокси пойдёт внутри него, и прокси-сервер увидит адрес VPN, а не ваш.
- Напрямую в мониторе значит «не через прокси Routekeeper». Если система потом отправит такое соединение в VPN, Routekeeper об этом не знает.
Что вы заметите при конфликте. Приложение идёт не туда, куда показывает монитор. Сайты видят неожиданный IP. Приложения на прокси теряют сеть, когда другой VPN подключается или отключается. Проверка прокси не проходит.
Почему. Несколько программ, которые перехватывают соединения, могут работать одновременно. Это клиент прокси в режиме TUN или «системного прокси», другой файрвол, другой маршрутизатор приложений. В каком порядке они видят соединение, Routekeeper не управляет.
Что можно сделать.
- Держите одного «маршрутизатора». Если пользуетесь sing-box, Xray или Clash, выключите в клиенте режим TUN и системный прокси, а его локальный порт SOCKS5 добавьте в Routekeeper. Подробно — рецепт «Поверх sing-box, Xray или Clash».
- Если стоит другой файрвол, разрешите в нём соединения сетевого расширения Routekeeper (Routekeeper Extension) с прокси-сервером. Иначе приложения на прокси останутся без сети.
- Чтобы понять, мешает ли другой VPN, временно выключите его и проверьте IP в строке меню и монитор — см. «Проверка и мониторинг».
Рабочий HTTP-прокси: только Basic
Что вы заметите. Проверить показывает HTTP: прокси требует авторизацию (407), хотя логин и пароль верные. Или браузер через рабочий прокси работает (он настроен автоматически), а Routekeeper — нет. Или соединения на порты, кроме 443, получают ошибку вида «HTTP-прокси ответил 403 …».
Почему.
- Логин и пароль HTTP- и HTTPS-прокси Routekeeper передаёт только способом Basic. NTLM, Kerberos (Negotiate) и файлы автонастройки (PAC) он не поддерживает.
- Каждое соединение Routekeeper открывает командой CONNECT, даже обычный HTTP на порт 80. Некоторые рабочие прокси разрешают CONNECT только на порт 443.
Что можно сделать.
- Спросите администраторов, есть ли вход с Basic-авторизацией или адрес SOCKS5.
- Запустите на Mac программу-посредник, которая умеет NTLM или Kerberos (например, Px или Cntlm). Добавьте её в Routekeeper как HTTP-прокси с адресом 127.0.0.1 и её портом.
- Подробно — рецепт «Рабочий прокси для внутренних адресов» и раздел «Рабочий прокси» о полях.
Подробнее: авторизация SOCKS5
SOCKS5 работает без пароля или с логином и паролем (способ username/password). Логин — от 1 до 255 байт, пароль — до 255 байт. Другие способы авторизации SOCKS5 не поддерживаются: проверка покажет SOCKS5: прокси не принял ни один способ авторизации.
Только SOCKS5, HTTP и HTTPS
Что вы заметите. Ссылку на сервер VLESS, Shadowsocks, WireGuard и подобных добавить в Routekeeper нельзя.
Почему. Routekeeper говорит с прокси только по SOCKS5, HTTP CONNECT и HTTPS (CONNECT внутри TLS). Цепочек из нескольких прокси тоже нет.
Что можно сделать. Запустите на Mac клиент этого протокола (sing-box, Xray, Clash и другие) с локальным портом SOCKS5 и добавьте его в Routekeeper. Подробно — рецепт «Поверх sing-box, Xray или Clash». Если своего сервера нет, его можно поставить по инструкции «Свой прокси-сервер».
Что ещё стоит знать
- Только исходящие соединения. Routekeeper решает, куда идут соединения, которые открывают программы на Mac. Входящие соединения, например к серверу, запущенному на этом Mac, он не фильтрует.
- Открытые соединения не переезжают. Новый маршрут или правило действует на новые соединения. Мессенджеры и другие программы с долгими соединениями перезапустите или дождитесь, пока они переподключатся.
- Процессор Mac не важен. Нужна macOS 14 или новее. Приложение универсальное: работает и на Intel, и на Apple Silicon. Требования к серверу — отдельные: скрипт из инструкции «Свой прокси-сервер» ставится только на сервер x86_64 (amd64).
Сверено с кодом Routekeeper (версия 0.2.1 и следующая за ней) 4 октября 2026 года.