Все разделы документации
Routekeeper состоит из двух частей: приложения со значком в строке меню и сетевого расширения, которое работает в системе и выполняет правила. Обновляются и удаляются они немного по-разному, поэтому ниже о каждой части сказано отдельно.
Требования
- macOS 14 Sonoma или новее.
- Mac на Apple Silicon или Intel. Одна и та же сборка работает на обоих.
- Учётная запись администратора. Без неё macOS не разрешит сетевое расширение.
- Папка «Программы». macOS устанавливает системные расширения только для приложений из
/Applications. Если запустить Routekeeper из образа диска или из «Загрузок», приветственный экран предложит Переместить в «Программы» и перезапустить. Старая копия из «Программ» при этом уйдёт в Корзину. - Язык. Интерфейс на русском или английском — по языку системы. В английском интерфейсе отдельные новые подписи могут пока оставаться на русском.
- Другие VPN и сетевые фильтры могут мешать Routekeeper: см. «Другие VPN и сетевые расширения».
Routekeeper распространяется как образ диска Routekeeper.dmg на сайте и в GitHub Releases. Сборка подписана сертификатом разработчика и проверена Apple (нотаризована). При первом запуске macOS всё равно спросит, открывать ли программу из интернета, — нажмите «Открыть». Установка по шагам — в быстром старте.
Обновления
Приложение
- Routekeeper сам проверяет обновления раз в сутки, если включено Проверять обновления автоматически (Настройки → Основные, раздел Обновления). По умолчанию включено.
- Проверить вручную: Настройки → Основные → Проверить обновления…. Или, когда окно Routekeeper открыто, меню Routekeeper вверху экрана → Проверить обновления….
- Когда выходит новая версия, Routekeeper показывает окно с предложением обновиться. Устанавливается она только после вашего подтверждения, затем Routekeeper перезапускается.
- Правила, прокси и настройки при обновлении сохраняются. Что изменилось в каждой версии — на странице «Что нового».
Сетевое расширение
Начиная с версии 0.5.0 расширение обновляется само: сразу после обновления приложения Routekeeper ставит расширение из своего комплекта. Пароль и повторное разрешение в Системных настройках не нужны: macOS переносит разрешение на новую версию. Когда новая версия заработает, придёт уведомление «Сетевое расширение обновлено до …».
Пока расширение перезапускается, соединения через прокси обрываются, а новые соединения в течение пары секунд могут пойти напрямую, мимо прокси. Это случается один раз после обновления приложения. Окно обновления предупреждает об этом до установки. Приложения, которым важно не выйти в сеть мимо прокси, закройте перед обновлением Routekeeper. Подробнее — в ограничениях.
Если обновить само не получилось, вверху окна остаётся плашка «Доступно обновление сетевого расширения (сейчас …)», а в меню значка в строке меню — пункт Доступно обновление расширения. Нажмите на плашке Обновить…, затем Обновить сейчас. Или в Настройки → Расширение нажмите Обновить расширение (сейчас …) в разделе Состояние: эта кнопка обновляет сразу, без дополнительного вопроса. В версии 0.4.1 и раньше расширение обновлялось только так.
Если после обновления появилась плашка «Сетевое расширение не отвечает», нажмите Переустановить расширение. Не помогло — перезагрузите Mac. Подробнее — в «Переустановить и остановить расширение».
С версии 0.2.x на 0.3.0 обычное обновление не сработает: старая версия только сообщит о новой и даст ссылку на сайт. Как перейти — в следующем разделе.
Переход с 0.2.x на 0.3.0
Этот раздел — про версию, которая выйдет после 0.2.1. Пока её нет в GitHub Releases, ничего делать не нужно.
В версии 0.3.0 у Routekeeper поменялся системный идентификатор приложения (bundle ID): был dev.ilyabazenov.appproxy, стал app.getroutekeeper.mac. Для macOS это другое приложение. Разрешения, запуск при входе, уведомления и настройки окна привязаны к идентификатору, а старое расширение может удалить только старое приложение. Поэтому версия 0.2.x не станет ставить новую поверх себя, а только сообщит о ней и даст ссылку на сайт.
Шаги
- По желанию сохраните правила в файл: Правила → Импорт и экспорт → Экспортировать…. Обычно это не нужно, правила переедут сами, но так у вас будет копия. Пароли прокси в файл не попадают.
- В старом Routekeeper откройте Настройки → Расширение и нажмите Удалить… → Удалить. Старое расширение и его фильтр и прокси уйдут из системы, а правила останутся на диске.
- Щёлкните значок в строке меню → Завершить Routekeeper. Перенесите старый Routekeeper из «Программ» в Корзину.
- Скачайте новую версию на сайте, перетащите Routekeeper в «Программы» и откройте его оттуда.
- Пройдите приветственный экран: снова разрешите сетевое расширение, фильтрацию сетевого контента и конфигурацию прокси (как это сделать). Разрешите уведомления, когда macOS спросит.
- Если Routekeeper запускался при входе в систему, включите это снова: Настройки → Основные → Запускать при входе в систему.
Правила, прокси с паролями и настройки режимов новое расширение переносит само при первом запуске. Если у вас были приложения или сервисы через прокси, после трёх разрешений окно сразу откроется с вашими разделами, без шагов про прокси и приложения.
Если старое расширение осталось
Если пропустить шаг 2, старое расширение продолжит работать и обрабатывать трафик рядом с новым. Правила двух версий будут мешать друг другу. Новая версия заметит это и покажет плашку «Работает расширение старой версии Routekeeper».
- macOS 15 и новее. Нажмите на плашке Открыть Системные настройки или откройте Системные настройки → Основные → Объекты входа и расширения → Сетевые расширения. Выключите «Routekeeper Network Extension» — это старое расширение. «Routekeeper Extension» — новое, его не трогайте.
- macOS 14. Раздела «Объекты входа и расширения» в macOS 14 нет, и выключить старое расширение там негде. Поэтому на macOS 14 обязательно сделайте шаг 2 до установки новой версии. Если новая уже установлена, а плашка появилась, сообщите о проблеме и приложите диагностику.
Проверить, включено ли старое расширение, можно командой в Терминале. У строки с dev.ilyabazenov.appproxy.extension не должно быть пометки [activated enabled].
systemextensionsctl listЧто переносится, а что нет
| Переносится само | Нужно заново |
|---|---|
| Правила, прокси с логинами и паролями, режим и настройки файрвола и сети, скачанные списки сервисов | Три разрешения macOS, запуск при входе, разрешение на уведомления, настройки окна: переключатели уведомлений, автоматическая проверка обновлений, выбранная вкладка настроек |
Кеши старой версии в ~/Library — данные карты трафика (около 55 МБ) и скачанные списки сервисов — новая версия удаляет сама при первом запуске. Файл настроек окна старой версии остаётся, его можно удалить: см. «Что остаётся на диске».
Подробнее: как переезжают настройки
Версии 0.2.x хранят настройки в /Library/Application Support/AppProxy, новая — в /Library/Application Support/Routekeeper. При первом запуске новое расширение переносит файлы из старой папки в новую, если в новой ещё нет своих настроек, и удаляет опустевшую старую папку. Правила для самого Routekeeper переводятся на новый идентификатор.
Возвращаться на 0.2.x после перехода не стоит: старая версия ищет настройки в прежней папке, которой больше нет, и начнёт с чистых настроек. Если всё же нужно, сначала экспортируйте правила.
Расширение тоже сменило идентификатор: dev.ilyabazenov.appproxy.extension → app.getroutekeeper.mac.extension. Подсистема служебного журнала теперь app.getroutekeeper.mac.
Как выключить
«Выключить» в Routekeeper можно четырьмя способами, и они делают разное.
| Способ | Где | Что происходит | Как вернуть |
|---|---|---|---|
| Переключатель Routekeeper включён | Меню значка в строке меню; панель внизу боковой колонки окна | Правила не действуют, все соединения идут напрямую. Фильтр и прокси остаются в системе. Монитор не записывает. | Включить переключатель. |
| Завершить Routekeeper | Меню значка | Закрываются только окно и значок. Расширение продолжает выполнять правила. Уведомлений нет. В режиме Спрашивать вопросы не показываются: соединения разрешаются, а Routekeeper записывает правила «На проверку». | Открыть Routekeeper из «Программ». |
| Остановить… | Настройки → Расширение | Фильтр и прокси выключаются в системе: всё идёт напрямую, правила файрвола не действуют. Расширение и правила остаются. | Настройки → Расширение → Переустановить: фильтр и прокси включатся сами. Переключатель их не вернёт. |
| Удалить… | Настройки → Расширение | Сетевое расширение и обе его конфигурации удаляются из системы. Правила остаются на диске. | Пройти приветственный экран заново: три разрешения. Правила вернутся сами. |
Для повседневного «выключить на минутку» подходит переключатель. Подробнее про остановку и переустановку — в «Если не работает».
Удалить Routekeeper
- Если включён запуск при входе, выключите его: Настройки → Основные → Запускать при входе в систему.
- Откройте Настройки → Расширение, в разделе Остановка и удаление нажмите Удалить…, затем Удалить. Сетевое расширение, фильтр и прокси Routekeeper уйдут из системы. macOS может попросить пароль администратора.
- Щёлкните значок в строке меню → Завершить Routekeeper.
- Перенесите Routekeeper из папки «Программы» в Корзину.
Правила и прокси остаются на диске и вернутся, если установить Routekeeper снова. Чтобы удалить и их, см. следующий раздел.
Если сразу перенести приложение в Корзину без шага 2, macOS обычно удаляет расширение сама, иногда после перезагрузки. Проверьте командой из следующего раздела, а в Системных настройках → Сеть — что там не осталось конфигураций Routekeeper.
Что остаётся на диске
| Где | Что |
|---|---|
/Library/Application Support/Routekeeper | Правила, прокси с паролями, настройки, списки сервисов для расширения, резервные копии config.broken-…json. Доступно только администратору. В версиях 0.2.x — /Library/Application Support/AppProxy. |
~/Library/Application Support/app.getroutekeeper.mac | Скачанный каталог сервисов, список серверов из мастера настройки, время последней проверки лицензии. |
~/Library/Caches/app.getroutekeeper.mac | Данные карты трафика (около 55 МБ, появляются после первого открытия карты) и кеш загрузок. |
~/Library/HTTPStorages/app.getroutekeeper.mac | Служебное хранилище сетевых запросов приложения, его создаёт macOS. |
~/Library/Preferences/app.getroutekeeper.mac.plist | Настройки окна: уведомления, обновления, пройден ли приветственный экран. |
| Системные настройки → Основные → Объекты входа (в macOS 15 и новее — Объекты входа и расширения) | Запуск при входе, если вы его включали. |
| Связка ключей, записи «Routekeeper license» и «Routekeeper server key» | Лицензия и ключи SSH своих серверов. |
Удалить всё это можно командами в Терминале. Выполняйте их после того, как Routekeeper удалён по шагам выше. Каждую команду копируйте и запускайте отдельно.
Первая команда безвозвратно удаляет правила и пароли прокси. Если они могут понадобиться, сначала экспортируйте правила, а пароли сохраните отдельно.
Правила, прокси и пароли (macOS попросит пароль администратора):
sudo rm -rf "/Library/Application Support/Routekeeper"Списки сервисов, кеши и служебные файлы приложения:
rm -rf ~/Library/Application\ Support/app.getroutekeeper.mac ~/Library/Caches/app.getroutekeeper.mac ~/Library/HTTPStorages/app.getroutekeeper.macНастройки окна:
defaults delete app.getroutekeeper.macЛицензию и ключи серверов удалите в приложении «Связка ключей»: найдите «Routekeeper» и удалите найденные записи. Лицензию удаляйте, только если не будете возвращаться к Routekeeper на этом Mac: иначе её придётся вводить заново.
Подробнее: остатки версий 0.2.x
Версии до 0.2.1 включительно пользовались прежним идентификатором. Если вы ставили их, удалите и эти файлы:
sudo rm -rf "/Library/Application Support/AppProxy"rm -rf ~/Library/Application\ Support/dev.ilyabazenov.appproxy ~/Library/Caches/dev.ilyabazenov.appproxy ~/Library/HTTPStorages/dev.ilyabazenov.appproxydefaults delete dev.ilyabazenov.appproxyЕсли какой-то папки нет, команда просто ничего не сделает. defaults delete в этом случае напишет, что домена не существует, — это не ошибка.
Проверить, что расширение удалено
systemextensionsctl listВ выводе не должно быть строки с app.getroutekeeper.mac.extension (и с dev.ilyabazenov.appproxy.extension от версий 0.2.x). Если строка есть с пометкой о том, что расширение будет удалено после перезагрузки (waiting to uninstall on reboot), перезагрузите Mac.
Данные и сеть
Где хранятся настройки
- Правила, прокси с паролями и настройки лежат в файле расширения
/Library/Application Support/Routekeeper/config.json. Прочитать его может только администратор. Окно Routekeeper получает настройки без паролей, а проверку прокси выполняет само расширение. - Журнал соединений для монитора хранится только в памяти расширения, последние несколько тысяч записей. На диск он не пишется и пропадает при перезапуске расширения.
- Служебный журнал пишется в системный журнал macOS и хранится столько, сколько его держит macOS, обычно несколько дней.
- Списки сервисов, данные карты и настройки окна лежат в
~/Library: см. «Что остаётся на диске».
Запуск при входе
Запускать при входе в систему (Настройки → Основные) предлагается на приветственном экране: галочка внизу уже стоит, и Routekeeper добавляется в объекты входа, когда экран закрывается. Потом это меняется только в настройках. Когда включено, Routekeeper виден в Системных настройках → Основные → Объекты входа (в macOS 15 и новее — Объекты входа и расширения).
Даже без этого после перезагрузки расширение, фильтр и прокси поднимаются сами, и правила работают. Пока вы не откроете Routekeeper, нет значка в строке меню, уведомлений и вопросов в режиме Спрашивать, а проверка обновлений и каталога сервисов не выполняется.
Куда Routekeeper выходит в сеть сам
- На ваши прокси — передавать трафик приложений, которые вы туда направили.
- На ipinfo.io через ваш прокси — узнать внешний IP, страну и время ответа. Это происходит, когда вы нажимаете Проверить, сохраняете прокси или открываете список прокси. Основной прокси проверяется ещё при открытии меню или окна (не чаще раза в минуту), через несколько секунд после смены сети и раз в минуту, пока проверка не проходит. ipinfo.io видит адрес прокси, а не ваш.
- На getroutekeeper.app за обновлениями — раз в сутки и по кнопке Проверить обновления…. Если вы согласились обновиться, сама сборка скачивается из GitHub Releases.
- На getroutekeeper.app за каталогом сервисов — раз в 6 часов (после неудачной проверки — повтор в течение часа) и по кнопке Проверить списки (Настройки → Основные → Каталог сервисов).
Больше никуда: ни аналитики, ни телеметрии, ни отчётов о сбоях. Страну и сеть для карты трафика Routekeeper определяет по встроенной базе, без запросов в интернет. Подробно — в политике конфиденциальности.
Подробнее: адреса и подписи
- Список версий:
getroutekeeper.app/appcast.xmlпо HTTPS. - Сами сборки: GitHub Releases. Каждая сборка подписана ключом обновлений, и Routekeeper не установит файл, подпись которого не сходится.
- Списки сервисов: файл
domainsets/v2.json(в версии 0.2.1 —v1.json) с getroutekeeper.app по HTTPS. Файл тоже подписан, и его подпись проверяют и приложение, и расширение. - Внешний IP: запрос
GET /jsonкipinfo.ioна порт 80 через проверяемый прокси.
Собственные соединения Routekeeper не попадают под ваши правила: для самого приложения есть встроенное правило «напрямую», а проверку прокси расширение выполняет через сам прокси.
Сверено с кодом Routekeeper (версия 0.2.1 и следующая за ней) 4 октября 2026 года.