Документация · Справка

Если не работает

Начните с таблицы симптомов. Ниже — разрешения macOS, все сообщения приложения, переустановка расширения, блокировка при нечитаемых настройках, диагностика и как сообщить о проблеме.

Все разделы документации

Первым делом откройте экран Обзор. Вверху он показывает самую серьёзную проблему и кнопку, которая её решает. Если причина не видна, найдите свой случай в таблице ниже.

Виноват ли Routekeeper? Выключите переключатель Routekeeper включён в меню значка в строке меню. Правила перестанут действовать, и все соединения пойдут напрямую, мимо прокси. Если всё заработало, дело в правилах или прокси. Если нет — скорее всего, в сети или в другой программе. Не забудьте включить переключатель обратно.

Быстрая проверка

Что видноПочему так бываетЧто сделать
Ничего не открывается ни в одном приложенииВключён режим Блокировать всё. Или Routekeeper не смог прочитать настройки и блокирует всё. Или рядом работает старое расширение Routekeeper либо другая VPN-программа.Посмотрите режим в меню значка и плашки вверху окна. Про блокировку — ниже, про плашки — в каталоге сообщений, про VPN — в ограничениях.
Одно приложение совсем без сетиЕго прокси недоступен, а напрямую Routekeeper такие соединения не пускает. Реже — правило Блокировать или вопрос, который ждёт ответа в режиме Спрашивать.На Обзор нажмите Проверить все. Если прокси недоступен — переведите маршруты. Если в меню значка есть Ждут ответа, ответьте на вопрос.
Приложение идёт напрямую, а не через проксиНет маршрута, выключены дочерние процессы, адрес перехватило другое правило или у соединения нет имени сайта.Пройдите по списку «Приложение идёт мимо прокси».
Приложение на прокси не открывает адрес домашней или рабочей сети: внутренний git-сервер, портал, принтер. Ошибка бывает невнятной, например tlsv1 alert protocol version у gitСоединение ушло в удалённый прокси, а тот до вашей сети не дотягивается. Обычно Routekeeper сам пускает такие адреса напрямую, но не когда выключено Настройки → Сеть → Локальные сети — напрямую, когда адрес назван в правиле Через прокси или когда внутренние серверы компании стоят на публичных адресах. В версии 0.3.0 этой настройки ещё нет.В Монитор выделите соединение и посмотрите поле Решение. Создайте правило: подсеть или домен компании → Напрямую, например 10.0.0.0/8 или *.corp.example. Как записать адрес — в «Поля правила».
Проверка прокси не проходитНеверный сервер, порт, тип, логин или пароль. Для HTTPS указан IP вместо домена. Не запущен локальный клиент.Найдите текст ошибки в каталоге сообщений.
Всё работает, но медленноСервер далеко или перегружен. Время ответа от 1500 мс отмечено словом «медленно». Первое соединение только что запущенной программы может задержаться на доли секунды. Отдельное соединение иногда ждёт 1,5–4 секунды: подключение к прокси зависло, и Routekeeper открыл новое.Далёкий исправный сервер показывает 500–800 мс, это нормально. Если есть прокси ближе, переведите на него маршруты.
Браузер ходит мимо проксиБраузер открывает часть сайтов по QUIC, сам спрашивает DNS или идёт через прокси только сервисом. Старые соединения остались на прежнем маршруте.Проверьте у прокси Блокировать UDP и QUIC. Рецепты: один сервис в браузере и DNS через HTTPS. Перезапустите браузер.
Нет значка в строке менюRoutekeeper не запущен: например, после перезагрузки, если выключено Запускать при входе в систему. Или значок спрятан за вырезом экрана MacBook либо под другими значками.Откройте Routekeeper из папки «Программы» или через Spotlight: появится значок. Если значок всё равно не виден, запустите Routekeeper ещё раз — тогда откроется его окно. Правила работают и без запущенного приложения: их выполняет сетевое расширение.
Окно не открывается, в Dock нет значкаRoutekeeper — приложение строки меню. В Dock он появляется, только пока открыто его окно.Щёлкните значок в строке меню → Открыть Routekeeper (⌘O). Или щёлкните значок правой кнопкой либо с ⌥. Или запустите Routekeeper ещё раз из Finder или Spotlight.
Монитор пустойRoutekeeper выключен переключателем — тогда монитор не записывает. Или не выданы разрешения macOS.Включите Routekeeper включён. Если в окне приветственный экран, пройдите его шаги (разрешения).

Разрешения macOS

Routekeeper работает через сетевое расширение, и macOS трижды просит разрешения: включить расширение, фильтровать сетевой контент и добавить конфигурацию прокси. Пока хоть одного разрешения нет, окно Routekeeper показывает приветственный экран с шагами вместо разделов. Пошагово установка описана в быстром старте, а здесь — что делать, если что-то пошло не так.

Нажали «Не разрешать»

Где разрешить расширение

Этот шаг выполняется в Системных настройках, и путь зависит от версии macOS.

В списке расширение называется «Routekeeper Extension», а в версиях 0.2.x — «Routekeeper Network Extension». Разрешить расширение может только пользователь с правами администратора.

Расширение выключили в Системных настройках

Если выключить Routekeeper в списке сетевых расширений, фильтр и прокси перестают работать, а окно Routekeeper снова показывает приветственный экран. На шаге 1 нажмите Установить или Повторить и снова включите расширение в том же списке. Если выключили или удалили конфигурации Routekeeper в Системных настройках → Сеть, откройте окно Routekeeper. Если в нём приветственный экран, повторите шаги 2 и 3. Если нет, а в строке состояния «Прокси-провайдер не запущен», нажмите Настройки → Расширение → Переустановить.

macOS просит перезагрузку

Иногда после установки расширения на шаге 1 появляется «Перезагрузите Mac, чтобы завершить установку.» Перезагрузите Mac и откройте Routekeeper. После перезагрузки расширение, фильтр и прокси поднимаются сами, а окно Routekeeper — только если включено Запускать при входе в систему (Настройки → Основные).

Mac под управлением организации

На рабочем Mac администратор может запретить профилем управления (MDM) системные расширения или сетевые фильтры. Тогда переключателя в Системных настройках нет или он недоступен, и изменить это самому нельзя. Обратитесь к администратору.

Подробнее: что сказать администратору

Routekeeper ставит системное сетевое расширение с двумя конфигурациями: фильтр сетевого контента (сокеты) и прозрачный прокси (app proxy). Team ID разработчика — N577X226Q5. Идентификатор расширения — app.getroutekeeper.mac.extension, в версиях 0.2.x — dev.ilyabazenov.appproxy.extension. Приложение должно лежать в /Applications.

Другие VPN-программы и сетевые фильтры тоже могут мешать: см. «Другие VPN и сетевые расширения».

Приложение идёт мимо прокси

Самый быстрый способ понять причину — монитор. Откройте Монитор, введите название приложения в поиск и выделите его соединение. Внизу в поле Решение написано, почему соединение пошло так: «правило: …» с приложением и адресом, «нет правила — режим «Только прокси»», «Routekeeper выключен» и т. д.

  1. Есть ли у приложения маршрут? Весь трафик приложения направляется в разделе Приложения, а не в Правила. У строки приложения должен стоять маршрут вида Прокси: …, а переключатель справа — быть включён. Если в поле Решение «нет правила», маршрута нет. Как добавить — в «Маршрут приложения».
  2. То ли это приложение? Routekeeper узнаёт приложение по подписи. Бета-версия, копия из другого магазина или второй браузер — это другие приложения. Добавьте нужное.
  3. Включено ли Вместе с дочерними процессами? Щёлкните строку приложения правой кнопкой. Если пункт выключен, вспомогательные процессы и программы, которые приложение запускает, идут по своим правилам. В разделе Мимо прокси такие соединения отмечены как Процесс мимо правила. Подробнее — в «Дочерние процессы».
  4. Не перехватило ли адрес другое правило? Правило для конкретного адреса или сервис важнее маршрута приложения. Например, сервис «Российские сайты» с маршрутом Напрямую или правило *.example.com → Напрямую отправит эти адреса напрямую даже у приложения на прокси. Поле Решение покажет это правило. Порядок — в «Какое правило важнее».
  5. Есть ли у соединения имя сайта? Правила по доменам и сервисам срабатывают, только когда приложение передало имя. Соединения по голому IP и большая часть QUIC имени не несут и идут по маршруту приложения. Если вы рассчитываете на правило сервиса, а маршрут браузера — Напрямую, нужен рецепт про один сервис в браузере. Подробнее — в «Правила по именам сайтов».
  6. Не старое ли это соединение? Открытые соединения не переезжают на новый маршрут. Перезапустите приложение.
  7. Не разрешён ли прямой путь при сбое? Если включено Настройки → Сеть → Если прокси недоступен — пускать напрямую, при недоступном прокси соединения идут напрямую.
Подробнее: что всегда идёт напрямую
  • Соединения с этим же Mac (127.0.0.1, ::1) — loopback. Это встроенные правила, а ещё переключатель Не трогать localhost в Настройки → Сеть.
  • Адреса локальной сети — домашней сети, корпоративного VPN, Tailscale — у приложения, которое целиком идёт через прокси. Это переключатель Локальные сети — напрямую в Настройки → Сеть. В поле Решение — «локальная сеть, мимо прокси из правила для …».
  • Соединения любого приложения с адресом и портом прокси, который добавлен в Routekeeper. В поле Решение — «соединение с прокси-сервером».
  • Собственные соединения Routekeeper: проверка прокси, обновления, списки сервисов.
  • UDP-запросы DNS на порт 53 от приложения на прокси: они пропускаются напрямую и отмечаются как DNS мимо прокси. Для браузера есть рецепт.
  • UDP приложения на прокси, если у этого прокси выключено Блокировать UDP и QUIC. Такие соединения отмечаются как UDP мимо прокси.
  • Новые соединения в первые секунды после перезапуска или обновления расширения: ограничения.

Что Routekeeper отмечает как соединение мимо прокси, а что нет, — в разделе «Что замечается, а что нет».

Сообщения приложения

Ошибки прокси

Их видно в трёх местах: рядом с кнопкой Проверить в разделе Прокси, в Монитор (в столбце Маршрут — Ошибка, причина — в подробностях соединения) и в уведомлении «…: прокси не сработал».

СообщениеЧто значитЧто делать
Прокси не ответил вовремяСервер не ответил за отведённое время: проверка ждёт 10 секунд, соединение приложения — 15. Если подключение к прокси зависло, через 1,5 и 4 секунды Routekeeper открывает новые попытки рядом с первой, и ошибка значит, что не удалась ни одна. Сервер выключен, адрес или порт неверны, или сервер не отвечает из вашей сети.Проверьте сервер и порт. Попробуйте из другой сети, например с телефона в режиме модема. Если сервер ваш — неполадки сервера.
Не удалось подключиться к прокси: … (дальше причина от macOS, например «Connection refused»)На этом адресе и порту никто не принимает соединения.Проверьте порт. Для локального клиента — запущен ли он и на каком порту слушает.
Не удалось подключиться к прокси: TLS: сертификат прокси не прошёл проверкуHTTPS-прокси: сертификат сервера не подходит к имени в поле Сервер, просрочен или выдан не доверенным центром.В поле Сервер укажите домен, на который выдан сертификат, а не IP.
Не удалось подключиться к прокси: TLS: ошибка TLS (код)Другой сбой шифрованного соединения. Часто тип HTTPS выбран для обычного HTTP-прокси.Проверьте Тип: HTTPS — только если прокси сам работает по TLS.
SOCKS5: неверный логин или парольПрокси отклонил логин и пароль.Введите их заново и нажмите Сохранить.
SOCKS5: прокси требует логин и парольПрокси без входа не пускает, а логин не указан.Заполните Логин и Пароль.
SOCKS5: прокси не принял ни один способ авторизацииПрокси ждёт другой способ входа, чем предлагает Routekeeper.Проверьте, нужен ли логин. Routekeeper умеет SOCKS5 без входа и с логином и паролем.
SOCKS5: … (например, «хост недоступен», «в соединении отказано», «соединение запрещено правилами прокси»)Прокси работает, но не смог или не захотел подключиться к сайту.Причина на стороне прокси или сайта. Попробуйте другой сайт; если ошибка у всех — настройки прокси-сервера.
HTTP: прокси требует авторизацию (407)HTTP-прокси не принял логин и пароль или их нет.Проверьте логин и пароль. Routekeeper умеет только вход по логину и паролю (Basic), без NTLM и Kerberos.
HTTP-прокси ответил … (код и текст, например 403)Прокси отказал в соединении с этим адресом или портом.Так часто ограничены рабочие прокси. Уточните у администратора, какие адреса и порты разрешены.
Прокси закрыл соединениеПрокси оборвал соединение, ничего не объяснив.Часто это неверный Тип: SOCKS5 вместо HTTP или наоборот. Ещё бывает при перегрузке или ограничениях сервера.
Ошибка протокола прокси: …Ответ не похож на прокси выбранного типа.Проверьте Тип и Порт: возможно, на этом порту другой тип прокси или вообще не прокси.
Сервер … не найден: такого имени нет в DNSИмени прокси-сервера не существует.Проверьте Сервер в карточке прокси: опечатка, истёкший домен.
Не удалось узнать адрес сервера …: DNS этой сети его не находит, а DNS через HTTPS недоступенСеть не отдаёт адрес прокси-сервера, и обойти её DNS не получилось.Впишите IP-адрес сервера в карточке прокси, см. «Как Routekeeper находит адрес сервера».
прокси не найден (в мониторе)Правило ссылается на прокси, которого больше нет. Соединение блокируется, а не уходит напрямую.Откройте правило и выберите другое Действие.
прокси-провайдер не запущен (в мониторе)Часть Routekeeper, которая передаёт трафик на прокси, ещё не поднялась: например, сразу после загрузки Mac или перезапуска расширения. Соединение сброшено, чтобы не уйти напрямую.Обычно приложение повторяет попытку само через несколько секунд. Если ошибка не проходит, см. состояние «Прокси-провайдер не запущен» ниже.
Нет связи с сетевым расширениемОкно не может достучаться до расширения.См. плашку «Сетевое расширение не отвечает» ниже.

Плашки вверху окна

ПлашкаЧто значитЧто делать
Подключаемся к сетевому расширению…Окно соединяется с расширением. Это нормально в первые секунды после запуска или обновления.Подождать.
Сетевое расширение не отвечает, кнопки Подробнее и Переустановить расширениеРасширение включено, но 10 секунд не отвечает окну. Чаще всего бывает после обновления. Правила продолжают работать, но изменить их нельзя, а прокси может быть не запущен.Нажмите Переустановить расширение (тот же пункт есть в меню значка). Если не помогло — перезагрузите Mac. Подробнее — ниже.
Настройки не прочитаны, все соединения заблокированыРасширение не смогло прочитать файл настроек и блокирует всё.См. «Все соединения заблокированы».
Работает расширение старой версии RoutekeeperПосле перехода с 0.2.x старое расширение осталось включённым и тоже обрабатывает трафик.Выключите «Routekeeper Network Extension» в Системных настройках, «Routekeeper Extension» не трогайте. Подробнее — в «Переход с 0.2.x».
Доступно обновление сетевого расширения (сейчас …), кнопка Обновить…Приложение обновилось, а расширение пока старое. Начиная с версии 0.5.0 плашка остаётся, только если расширение не смогло обновиться само.Обновите, когда удобно: «Обновления».
Оранжевая полоса с текстом ошибки и крестикомПоследняя ошибка, например при сохранении правила.Прочитайте текст. Полоса закрывается крестиком или сама через 12 секунд.

Плашки «Настройки не прочитаны, все соединения заблокированы» и «Работает расширение старой версии Routekeeper» появились в версии после 0.2.1.

Строка состояния

Короткое состояние показано в меню значка под словом Routekeeper и в панели внизу боковой колонки.

СостояниеЧто значит и что делать
Ждёт разрешения в Системных настройкахmacOS ждёт, пока вы разрешите расширение: разрешения.
Нужно завершить настройкуНе хватает разрешения. Откройте окно и пройдите шаги приветственного экрана.
Подключаемся к расширению… / Расширение не отвечаетТо же, что плашки выше.
ВыключенПереключатель Routekeeper включён выключен: правила не действуют, всё идёт напрямую.
Все соединения заблокированыНастройки не прочитаны: ниже.
Прокси-провайдер не запущенКонфигурация прокси Routekeeper не работает: её выключили в Системных настройках → Сеть или она не поднялась. Откройте окно: если там приветственный экран, нажмите Включить прокси. Если нет — Настройки → Расширение → Переустановить.
Прокси «…» недоступенОсновной прокси не прошёл проверку: «Прокси перестал отвечать».
Нет приложений через проксиНи одно приложение и ни один сервис не направлены через прокси. Добавьте их в Приложения.

Другие сообщения

СообщениеЧто делать
macOS устанавливает системные расширения только для приложений из папки «Программы».Нажмите Переместить в «Программы» и перезапустить. Если копия Routekeeper уже лежит в «Программах», она уйдёт в Корзину.
Не удалось установить: …Причину сообщает macOS. Проверьте, что Routekeeper лежит в «Программах» и у вас права администратора, и нажмите Установить ещё раз. Если не помогло, перезагрузите Mac.
Перезагрузите Mac, чтобы завершить установку.Перезагрузите Mac.
В буфере обмена нет строки прокси. Ожидается, например, socks5://user:pass@host:1080Скопируйте строку целиком, с портом. Какие форматы понимает Routekeeper — в «Вставить строку прокси».
Укажите сервер и порт (1–65535)Заполните Сервер и Порт.
Не понимаю назначение «…»В правиле адрес записан так, что Routekeeper его не понимает: «Поля правила».
Настройки Routekeeper не прочитаны, поэтому изменить их нельзя. Обновите Routekeeper или сбросьте настройки.См. ниже.
Диагностика не собрана: …Попробуйте ещё раз. Проверьте, что на диске есть место.

Переустановить и остановить расширение

Состояние расширения видно в Настройки → Расширение, в разделе Состояние. Если всё в порядке, там написано: Сетевое расширение — «Активно», Фильтр — «Включён», Прокси — «Работает». Там же видна Версия расширения.

Переустановить

Помогает, когда расширение перестало отвечать, например после обновления.

  1. Откройте Настройки → Расширение и нажмите Переустановить. То же делает кнопка Переустановить расширение на плашке и в меню значка.
  2. Routekeeper удалит расширение и сразу установит его снова. На несколько секунд фильтр и прокси выключатся: открытые соединения через прокси оборвутся, а новые в это время пойдут напрямую. Потом фильтр и прокси включатся сами.
  3. Если macOS снова попросит разрешить расширение, разрешите его, как при установке (разрешения).

Правила, прокси и пароли при переустановке сохраняются. Если плашка «Сетевое расширение не отвечает» не исчезла, перезагрузите Mac.

Остановить…

Настройки → Расширение → Остановить… → Остановить. Фильтр и прокси Routekeeper выключаются на уровне системы. Приложения начинают ходить в сеть напрямую, мимо прокси, а правила файрвола перестают действовать. Расширение остаётся установленным, правила — на диске. Окно Routekeeper после этого показывает приветственный экран.

Переключатель Routekeeper включён не отменяет «Остановить…». Он только включает и выключает правила внутри работающих фильтра и прокси. Чтобы вернуть фильтр и прокси после остановки, откройте Настройки (в меню значка → Настройки…) → Расширение и нажмите Переустановить: после переустановки Routekeeper включает их сам. Если окно показывает приветственный экран с кнопками Включить фильтр или Включить прокси, можно нажать и их.

Чем отличаются переключатель, «Остановить…» и «Удалить…», сведено в таблицу в разделе «Как выключить».

Все соединения заблокированы

Плашка «Настройки не прочитаны, все соединения заблокированы» значит, что сетевое расширение не смогло прочитать файл с правилами и прокси. Чтобы ничего не ушло мимо прокси, Routekeeper в этом случае блокирует всё. Пропускаются только соединения внутри этого Mac, сам Routekeeper и системная служба DNS. Это поведение появилось в версии после 0.2.1.

Почему так бывает

Что делать

  1. Нажмите на плашке Проверить обновления. Самому Routekeeper выходить в сеть разрешено и в этом состоянии. Установите новую версию: она прочитает настройки, и всё заработает как раньше.
  2. Если обновления нет или оно не помогло, нажмите Сбросить настройки… → Сбросить. Правила и прокси удалятся, и приложения пойдут напрямую, пока вы не настроите их заново.
  3. Старый файл при сбросе не удаляется: он остаётся рядом с новым под именем config.broken-число.json в папке /Library/Application Support/Routekeeper.

Пока настройки не прочитаны, изменить их нельзя: Routekeeper ответит «Настройки Routekeeper не прочитаны, поэтому изменить их нельзя…». Выключить Routekeeper переключателем можно, но только до перезапуска расширения: после него всё снова будет заблокировано.

Не ставьте старую версию поверх новой. Если нужно вернуться назад, сначала сохраните правила: Правила → Импорт и экспорт → Экспортировать… (пароли прокси в файл не попадают). Подробнее — в «Импорт и экспорт».

Подробнее: резервная копия и версия 0.2.1

Папка доступна только администратору. Посмотреть, что в ней лежит:

sudo ls -l "/Library/Application Support/Routekeeper"

Файл config.broken-…json — это JSON с правилами, прокси и настройками. В нём пароли прокси открытым текстом, поэтому не прикладывайте его к публичному сообщению об ошибке. Число в имени — время сброса в секундах с 1970 года.

В версии 0.2.1 блокировки нет: нечитаемый файл переименовывается в config.broken-…json в папке /Library/Application Support/AppProxy, и Routekeeper начинает с чистых настроек — все приложения идут напрямую.

Собрать диагностику

Архив диагностики помогает разобраться в проблеме. Routekeeper никуда его не отправляет: он просто появляется на рабочем столе.

  1. Откройте окно Routekeeper. В строке меню вверху экрана выберите Справка → Собрать диагностику…. Или откройте Настройки → Расширение и в разделе Если что-то не так нажмите Собрать….
  2. Через несколько секунд Finder покажет на рабочем столе файл Routekeeper-diagnostics-дата время.zip.
  3. Распакуйте его и просмотрите, прежде чем кому-то отправлять.

Что в архиве

ФайлЧто внутри
info.txtВерсии Routekeeper и macOS, состояние расширения, фильтра и прокси, режим, число правил. По каждому прокси — имя, тип, адрес и порт сервера, результат последней проверки.
config.jsonПравила, прокси и настройки. Паролей нет, но есть адреса серверов и логины.
connections.jsonПоследние 500 соединений: приложение, адрес, порт, маршрут, ошибка.
log.txtСлужебный журнал Routekeeper за последние 30 минут, в том числе адреса, к которым обращались приложения.

Архив содержит личное: адреса сайтов, которые вы открывали, адреса и логины прокси. Сообщения об ошибках на GitHub публичны. Перед тем как прикладывать архив, удалите из него то, что не хотите показывать.

Подробнее: журнал без архива

Если окно Routekeeper не открывается, журнал можно сохранить командой в Терминале. Файл появится на рабочем столе.

log show --last 30m --info --predicate 'subsystem == "app.getroutekeeper.mac"' > ~/Desktop/routekeeper.log

Для версий 0.2.x подсистема называется иначе:

log show --last 30m --info --predicate 'subsystem == "dev.ilyabazenov.appproxy"' > ~/Desktop/routekeeper.log

Сообщить о проблеме

Ошибки и пожелания принимаются в GitHub Issues проекта. Нужна учётная запись GitHub.

  1. Проверьте, нет ли вашего случая на этой странице и в ограничениях.
  2. Если проблема повторяется, соберите диагностику сразу после того, как она проявилась, и просмотрите архив.
  3. В окне Routekeeper выберите Справка → Сообщить о проблеме…. Откроется форма нового сообщения в GitHub Issues проекта.
  4. Напишите:
    • версию Routekeeper — она в Настройки → Основные → Версия, например «0.2.1 (10)»;
    • версию macOS и модель Mac — меню Apple → «Об этом Mac»;
    • режим и тип прокси (SOCKS5, HTTP или HTTPS) — без адреса и пароля;
    • что делали по шагам, что ожидали и что получилось.
  5. Перетащите архив диагностики в поле сообщения.

Сообщения на GitHub видят все. Не вставляйте в них пароли, ключи и адреса, которые не хотите показывать. Если архив показать нельзя, опишите проблему без него и напишите, что архив есть.

Сверено с кодом Routekeeper (версия 0.2.1 и следующая за ней) 4 октября 2026 года.