Все разделы документации
Routekeeper сам предлагает обновиться, когда выходит новая версия: см. «Обновления». Все сборки лежат в GitHub Releases.
0.6.0 — 9 ноября 2026
Сборка 16.
- Запасной путь до прокси. Если сервер работает, но с вашего Mac до него не достучаться, соединения идут через другой ваш сервер, а сайты по-прежнему видят адрес первого. Чтобы вообще не подключаться к первому напрямую, включите Всегда через этот сервер. Настраивается в карточке прокси, см. «Запасной путь».
- Свой сервер закрывает служебные адреса. После обновления скрипта на сервере прокси не ходит на
169.254.0.0/16(метаданные облака),100.64.0.0/10(в том числе Tailscale),0.0.0.0/8иfc00::/7. Карточка сервера предложит обновление. Caddy перезапустится один раз, логин и пароль не изменятся. - Адреса сайтов через прокси включены по умолчанию на новых установках. Если вы уже пользуетесь версией 0.5, настройка останется как была: Настройки → Сеть → Узнавать адреса сайтов через прокси.
- Новое оформление. Цвет теперь значит одно и то же на всех экранах: синий — прокси, зелёный — работает. На широком окне Обзор занимает две колонки.
- В Правилах есть переключатель Мои, Системные и Все, а поиск подсказывает совпадения в другом списке.
- В Приложениях появились группы Выключены и Не найдены на диске, вторую можно очистить разом.
- Прокси добавляются из одного меню: по адресу, из буфера обмена или свой сервер. Сохранить появляется только после правки.
- Карта открывается вокруг ваших отметок, а подписи не заезжают друг на друга и за край. Названия прокси в Мониторе сокращаются посередине, поэтому различаются даже с одинаковым началом.
- Экран приветствия предлагает открывать Routekeeper при входе в систему.
- Routekeeper меньше нагружает процессор, пока его окна скрыты.
0.5.1 — 20 октября 2026
Сборка 15.
- Прокси снова работает после перезагрузки. Если Routekeeper запускался раньше, чем Mac подключался к сети, macOS отказывала в запуске прокси («No network available»), и он так и оставался выключен: приложения, назначенные на прокси, не открывали соединения, пока Routekeeper не перезапустят. Теперь Routekeeper запускает прокси, как только появляется сеть, и повторяет запуск, если прокси остановился с ошибкой.
- Главное окно открывается поверх других приложений, а не остаётся за ними до щелчка по значку в Dock.
- В «Обзоре» строки маршрутов выровнены: задержка, график и приложения стоят друг под другом, а одно приложение в строке больше не сокращается до пары букв. Под заголовком при нескольких прокси перечислены сами маршруты.
- В «Приложениях» две копии одного приложения, например Telegram из App Store и с сайта, показывают, где каждая лежит. Удалённое или перемещённое приложение помечено «нет на диске».
- В истории задержки на оси не больше пяти подписей, в миллисекундах или секундах, даже если за период бывали задержки в десятки секунд. «Разброс» подписан в мс.
- Служебные программы без значка называются коротко:
sshвместоcom.apple.ssh.
0.5.0 — 17 октября 2026
Сборка 14.
- Сетевое расширение обновляется само. Сразу после обновления приложения Routekeeper ставит новую версию расширения, без пароля и без повторного разрешения в Системных настройках. Раньше оно ждало нажатия на плашку, и если её не заметить, после обновления приложения продолжало работать старое расширение. Пока расширение перезапускается, соединения через прокси обрываются, а новые в течение пары секунд могут пойти напрямую, как и при обновлении вручную: окно обновления предупреждает об этом до установки, а после замены приходит уведомление. Плашка с кнопкой Обновить… остаётся на случай, если обновить само не получилось. Подробнее — «Обновления».
- Адреса сайтов — через прокси. Новый переключатель Настройки → Сеть → Узнавать адреса сайтов через прокси, по умолчанию выключен. С ним приложения, которые идут через прокси, узнают адреса сайтов у публичного DNS через сам прокси, а не у DNS вашей сети. Это помогает, когда сеть, например корпоративный VPN, не знает нужного сайта или отвечает «такого имени нет», и сайт в приложении не открывается, хотя оно идёт через прокси. Имена локальной сети и VPN, в том числе из
/etc/resolver, по-прежнему спрашиваются у её DNS. Действует для прокси, у которых включено DNS через прокси. Подробнее — «Адреса сайтов через прокси». - Адрес прокси-сервера находится, даже когда DNS сети его не знает. Некоторые сети, например корпоративный VPN или провайдер с фильтром, не отдают адрес прокси-сервера по имени, и раньше все приложения через этот прокси оставались без связи. Теперь Routekeeper узнаёт адрес через DNS по HTTPS у Cloudflare, Google, AdGuard и Control D и запоминает его: в следующий раз подключение начинается сразу. Если не помогает и это, в карточке прокси есть новое поле IP-адрес сервера, мастер своего сервера заполняет его сам. Сертификат HTTPS-прокси по-прежнему проверяется по имени. Если адрес узнать не удалось, сообщение говорит, в чём дело: такого имени нет вовсе или его не находят ни DNS сети, ни DNS по HTTPS. Подробнее — «Сообщения об ошибках».
- Проверка прокси проходит, когда ipinfo.io отказывает. ipinfo.io отвечает отказом на адреса некоторых хостингов, и исправный прокси на таком сервере не проходил Проверить. Теперь, если ipinfo.io не ответил, Routekeeper спрашивает Cloudflare, затем ipify. Если ответили, но адрес не назвали, прокси всё равно считается рабочим, только без IP. Подробнее — «Проверка».
0.4.1 — 13 октября 2026
Сборка 13.
- Окно вопроса больше не обрезается. Если имя процесса было длинным, например у служебных программ вроде
com.apple.dt.Xcode.ITunesSoftwareService, окно становилось шире самого себя и теряло края: иконку, срок Навсегда, переключатель дочерних процессов. Теперь срок называется Пока процесс работает, переключатель — Включая дочерние процессы, а длинные адрес и имя процесса сокращаются посередине. В строке «Правило: …» имя пишется коротко:Xcode.ITunesSoftwareService. Запущен из показывает только программы, которые запустили процесс, без него самого.
0.4.0 — 12 октября 2026
Сборка 12.
- Локальные сети — напрямую. Приложение, которое целиком идёт через прокси, теперь достаёт домашнюю сеть, корпоративный VPN и Tailscale напрямую: удалённый прокси до них не дотянется. Это касается и дочерних процессов: например,
git, запущенный из терминала или AI-ассистента на прокси, достанет рабочий git-сервер во внутренней сети. Правила, в которых назван адрес или подсеть, работают как раньше: так внутреннюю сеть можно отправить через офисный прокси. Переключатель — Настройки → Сеть → Локальные сети — напрямую, по умолчанию включён. Подробнее — «Какое правило важнее». - Зависшее подключение к прокси больше не держит приложение 15 секунд. Если соединение с прокси не готово за 1,5 секунды, Routekeeper открывает рядом вторую попытку, через 4 секунды — третью и берёт ту, что удалась первой. Так бывает в сетях некоторых хостингов: одно соединение зависает, а новые проходят. Общий срок по-прежнему 15 секунд, а неверный пароль или отказ прокси сообщаются сразу.
- Поделиться прокси одной ссылкой. Кнопка Скопировать ссылку в карточке прокси и пункт Скопировать ссылку с паролем в его контекстном меню кладут в буфер обмена строку вида
https://логин:пароль@сервер:443#Название. Её можно переслать: получатель вставит её в Routekeeper, и прокси заполнится целиком, вместе с названием. Подробнее — «Поделиться прокси». - Соединения через HTTPS-прокси больше не копятся. Когда приложение закрывало соединение, HTTPS-прокси об этом не узнавал, и соединение оставалось открытым, пока его не закрывал сайт, а некоторые, например серверы Telegram, держат его часами. За сутки-двое таких соединений набирались сотни, macOS переставала давать Routekeeper новые, и все соединения через прокси завершались ошибкой «Cannot allocate memory». Теперь, если после закрытия приложением сайт молчит минуту, Routekeeper закрывает соединение сам.
- Выключение Routekeeper обрывает соединения через прокси. Раньше после выключения переключателем уже открытые соединения продолжали идти через прокси, пока приложение само их не закрывало, а некоторые живут сутками. Теперь они обрываются сразу, и приложения подключаются заново напрямую. Подробнее — «Как быстро выключить».
- История задержки прокси. В разделе Прокси у каждого прокси — график задержки за час, сутки, 7 или 30 дней: обычное время, разброс и когда прокси не открывал соединения. В Обзоре рядом с задержкой маршрута — её график за последний час. Routekeeper записывает время настоящих соединений и проверок и лишнего трафика не тратит. История хранится 30 дней. Подробнее — «История задержки».
0.3.0 — 5 октября 2026
Сборка 11.
Переход с 0.2.x делается вручную, один раз: «Переход с 0.2.x на 0.3.0».
- Лицензия. Routekeeper направляет трафик только с действующей лицензией. Она привязана к одному Mac и обычно действует год. Без неё всё остальное работает: можно заранее настроить прокси, приложения и правила. Код Mac и поле для лицензии — в Настройки → Лицензия. За две недели до конца срока Routekeeper напоминает о продлении. Подробнее — «Лицензия».
- Свой прокси-сервер из приложения. Кнопка Свой сервер… в разделе Прокси и на приветственном экране открывает мастер: впишите IP и пароль арендованного сервера и домен, и Routekeeper сам поставит на сервер HTTPS-прокси и добавит его. Терминал не нужен. Пароль сервера не сохраняется: Routekeeper входит по своему ключу из связки ключей. В карточке такого прокси появляется блок Сервер: проверить и обновить сервер, сменить пароль прокси, закрыть вход на сервер по паролю, удалить прокси с сервера. Подробнее — «Установка из Routekeeper».
- Новый идентификатор приложения. Системный идентификатор меняется с
dev.ilyabazenov.appproxyнаapp.getroutekeeper.mac. Для macOS это новое приложение, поэтому версии 0.2.x только сообщат о нём и дадут ссылку на сайт. Старую версию нужно удалить её же кнопкой Удалить…, а новую — установить и заново дать три разрешения. Правила, прокси с паролями и настройки переезжают сами. Если старое расширение осталось включённым, новая версия покажет плашку и подскажет, как его выключить. В Системных настройках расширение теперь называется «Routekeeper Extension». - «Мимо прокси» вместо «Утечки». Раздел переименован. У каждого вида записей теперь своя важность: Процесс мимо правила — самое серьёзное (красный), UDP мимо прокси — оранжевый, DNS мимо прокси — наименее важное (жёлтый). Если напрямую идут только DNS-запросы, Обзор не поднимает тревогу, а спокойно пишет «DNS-запросы идут напрямую». Подсказка к такой записи объясняет, что при этом видит DNS-провайдер.
- Блокировка при нечитаемых настройках. Если расширение не может прочитать файл настроек — его повредили или поверх новых настроек поставили более старую версию, — Routekeeper больше не начинает с чистых настроек, отправляя все приложения напрямую. Вместо этого он блокирует все соединения, кроме соединений внутри Mac, самого Routekeeper и системной службы DNS. Плашка предлагает Проверить обновления или Сбросить настройки…, старый файл при сбросе сохраняется. Подробнее — в «Все соединения заблокированы».
- Настройки старых версий читаются всегда. Если в файле нет параметра, который появился позже, он получает значение по умолчанию.
- Новые сервисы, среди них Slack, Zoom, GitHub и Figma. Всего сервисов теперь 32.
- Сервис добавляет своё приложение. Вместе с сервисом Routekeeper добавляет и его приложение для Mac с тем же маршрутом: например, Slack, Zoom, ChatGPT, Claude, Cursor, IDE JetBrains. Для Claude добавляется ещё и консольная программа
claude. Приложение, установленное позже, добавится само. Приложения, которым вы уже задали маршрут, не меняются. - Новые сервисы без новой версии. С сайта теперь приходит весь каталог сервисов: сами сервисы, их адреса, приложения, которые добавляются вместе с сервисом, и браузеры, которым монитор советует DNS через HTTPS. Раньше с сайта обновлялись только адреса. Каталог проверяется раз в 6 часов вместо 12. Раздел в настройках называется Каталог сервисов и показывает время последней проверки.
- Карта трафика быстрее. Карта строится в фоне и не подтормаживает окно, точки соединений движутся плавно.
0.2.1 — 3 октября 2026
Сборка 10.
- Сейчас через прокси на экране Обзор. Какие приложения прямо сейчас передают трафик через прокси, с какой скоростью и через какой прокси. Приложение остаётся в списке ещё какое-то время после того, как трафик затих.
- Меньше ложных записей о DNS мимо прокси. Служебные запросы
ipv4only.arpaи_dns.resolver.arpaодинаковы у всех и ничего не говорят о том, что вы делаете. Теперь они не отмечаются. - Браузеры и DNS. Если браузер сам отправляет DNS-запросы мимо прокси, Routekeeper советует включить в нём DNS через HTTPS, а кнопку Блокировать DNS для браузеров не показывает: без DoH браузер с закрытым портом 53 перестал бы открывать сайты. Рецепт — «DNS через HTTPS в браузере».
- График скорости больше не выходит за свои края и показывает только своё окно времени.
0.2.0 — 3 октября 2026
Сборка 9.
- Экран Обзор — новый главный экран. Сверху — всё ли работает, а если нет, то самая серьёзная проблема и кнопка, которая её решает. Ниже — каждый маршрут с состоянием и скоростью своего прокси, прямой трафик и соединения мимо прокси.
- Перевод маршрутов на другой прокси из окна и из строки меню: все приложения сразу или маршруты одного прокси. Перед переводом Routekeeper показывает, что именно переедет и откуда, а после — несколько секунд даёт отменить. Подробнее — в рецепте «Прокси перестал отвечать».
- Сервисы. Правило для сервиса целиком — например, «ChatGPT через прокси» — действует во всех приложениях сразу. В правилах сервис записывается как
@chatgpt. Адрес, вписанный вручную, важнее сервиса. Карточка сервиса показывает, что попало под правило, и проверяет, входит ли адрес в список. - Новые сервисы, среди них Spotify, Notion и JetBrains, а также российские — госсайты, банки, популярные сайты. Российские добавляются с маршрутом Напрямую. Всего сервисов — 25.
- Списки адресов сервисов обновляются с сайта раз в 12 часов, без новой версии приложения. Дата списков и ручная проверка — в Настройки → Основные → Адреса сервисов.
- Выбор сервисов на экране Приложения и на приветственном экране.
- Окно вопроса в режиме Спрашивать предлагает прокси, через который уже идёт большинство приложений, и показывает, сколько соединений ждут ответа. Щелчок по нему больше не поднимает главное окно.
- Точка прокси становится оранжевой, только когда задержка заметна: от 1500 мс, с пометкой «медленно».
- Если основной прокси не прошёл проверку, Routekeeper повторяет её раз в минуту. Раньше после короткого сбоя строка меню могла часами показывать, что прокси недоступен.
- Два прокси с одинаковым именем в меню маршрута различаются по типу и порту.
- Диагностика берёт свежий список соединений у расширения, даже если монитор закрыт.
0.1.0 — 3 октября 2026
Сборка 8. Первая публичная версия.
- Маршрут для каждого приложения: Через прокси, Напрямую, Блокировать или Спрашивать. Приложения узнаются по подписи разработчика, вместе с дочерними процессами.
- Правила по адресам: имя сайта, шаблон
*., IP, подсеть, порт и протокол. - Прокси SOCKS5, HTTP и HTTPS, с логином и паролем или без. Строку прокси можно вставить из буфера обмена. Имя сайта передаётся прокси, и адрес он узнаёт сам.
- Если прокси недоступен, соединения не уходят напрямую. UDP и QUIC у приложений на прокси блокируются.
- Четыре режима файрвола: Только прокси, Спрашивать, Тихий, Блокировать всё.
- Монитор соединений с картой трафика и отметки о соединениях мимо прокси с подсказкой, как их закрыть.
- Значок в строке меню: состояние, режим и внешний IP прокси.
- Импорт и экспорт правил, сбор диагностики, автоматические обновления.
- Интерфейс на русском и английском.
Сверено с кодом Routekeeper (версия 0.2.1 и следующая за ней) 4 октября 2026 года.