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

Обновление и удаление

Требования, обновления приложения и расширения, переход на новую версию, способы выключить и полное удаление. А ещё где Routekeeper хранит данные и куда выходит в сеть сам.

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

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

Требования

Routekeeper распространяется как образ диска Routekeeper.dmg на сайте и в GitHub Releases. Сборка подписана сертификатом разработчика и проверена Apple (нотаризована). При первом запуске macOS всё равно спросит, открывать ли программу из интернета, — нажмите «Открыть». Установка по шагам — в быстром старте.

Обновления

Приложение

Сетевое расширение

Начиная с версии 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 не станет ставить новую поверх себя, а только сообщит о ней и даст ссылку на сайт.

Шаги

  1. По желанию сохраните правила в файл: Правила → Импорт и экспорт → Экспортировать…. Обычно это не нужно, правила переедут сами, но так у вас будет копия. Пароли прокси в файл не попадают.
  2. В старом Routekeeper откройте Настройки → Расширение и нажмите Удалить… → Удалить. Старое расширение и его фильтр и прокси уйдут из системы, а правила останутся на диске.
  3. Щёлкните значок в строке меню → Завершить Routekeeper. Перенесите старый Routekeeper из «Программ» в Корзину.
  4. Скачайте новую версию на сайте, перетащите Routekeeper в «Программы» и откройте его оттуда.
  5. Пройдите приветственный экран: снова разрешите сетевое расширение, фильтрацию сетевого контента и конфигурацию прокси (как это сделать). Разрешите уведомления, когда macOS спросит.
  6. Если Routekeeper запускался при входе в систему, включите это снова: Настройки → Основные → Запускать при входе в систему.

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

Если старое расширение осталось

Если пропустить шаг 2, старое расширение продолжит работать и обрабатывать трафик рядом с новым. Правила двух версий будут мешать друг другу. Новая версия заметит это и покажет плашку «Работает расширение старой версии Routekeeper».

Проверить, включено ли старое расширение, можно командой в Терминале. У строки с 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

  1. Если включён запуск при входе, выключите его: Настройки → Основные → Запускать при входе в систему.
  2. Откройте Настройки → Расширение, в разделе Остановка и удаление нажмите Удалить…, затем Удалить. Сетевое расширение, фильтр и прокси Routekeeper уйдут из системы. macOS может попросить пароль администратора.
  3. Щёлкните значок в строке меню → Завершить Routekeeper.
  4. Перенесите 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.appproxy
defaults 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.

Данные и сеть

Где хранятся настройки

Запуск при входе

Запускать при входе в систему (Настройки → Основные) предлагается на приветственном экране: галочка внизу уже стоит, и Routekeeper добавляется в объекты входа, когда экран закрывается. Потом это меняется только в настройках. Когда включено, Routekeeper виден в Системных настройках → Основные → Объекты входа (в macOS 15 и новее — Объекты входа и расширения).

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

Куда Routekeeper выходит в сеть сам

Больше никуда: ни аналитики, ни телеметрии, ни отчётов о сбоях. Страну и сеть для карты трафика 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 года.