Документация · Начало

Быстрый старт: первое приложение через прокси

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

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

Эта страница ведёт от установки до проверки, шаг за шагом. Если после настройки что-то перестанет открываться, в конце написано, как выключить Routekeeper за секунду.

Mac с macOS 14 Sonoma или новее

Подходят Mac на Apple Silicon и на Intel.

Учётная запись администратора

macOS спросит пароль администратора, когда вы будете разрешать сетевое расширение.

Прокси-сервер

Адрес, порт и, если нужно, логин с паролем вашего прокси. Если прокси пока нет, ниже написано, где его взять.

Лицензия

Без неё Routekeeper не направляет трафик, но настроить всё можно заранее. Как её получить.

Около десяти минут

Иногда после установки расширения macOS просит перезагрузить Mac.

Установка

  1. Скачайте Routekeeper. Кнопка Скачать на главной загружает файл Routekeeper.dmg с последней версией. Все версии лежат на странице выпусков на GitHub.
  2. Откройте DMG. Дважды щёлкните скачанный файл. Откроется окно со значком Routekeeper и папкой Applications.
  3. Перетащите значок Routekeeper на папку Applications. Так приложение окажется в папке «Программы». Запускать его нужно именно оттуда: macOS устанавливает сетевые расширения только для приложений из «Программ».
  4. Запустите Routekeeper из «Программ». macOS предупредит, что приложение загружено из интернета, и спросит, открыть ли его. Нажмите Открыть.

Такой вопрос macOS задаёт о любой программе не из App Store. Routekeeper подписан сертификатом разработчика и проверен Apple (нотаризован), поэтому больше ничего в настройках безопасности делать не нужно.

Запустили прямо из DMG или из «Загрузок»? На приветственном экране появится предупреждение и кнопка Переместить в «Программы» и перезапустить. Она скопирует Routekeeper в «Программы», а старую копию там, если она есть, переместит в Корзину. Потом Routekeeper откроется заново уже оттуда. DMG после этого можно извлечь.

Где искать Routekeeper

У Routekeeper нет значка в Dock. Он живёт в строке меню, справа вверху экрана: значок в виде фонаря.

При первом запуске окно Routekeeper открывается само, с приветственным экраном. Пока настройка не закончена, вместо обычного окна будет он.

macOS заодно спросит, можно ли Routekeeper показывать уведомления. Это по желанию. В уведомлениях Routekeeper сообщает о соединениях мимо прокси и о соединениях, которые не удалось установить через прокси, не чаще раза в 10 минут для каждого процесса и вида события.

На Mac уже стоит Routekeeper 0.2.x? Сначала прочитайте, как перейти на новую версию: старое приложение нужно удалить его же кнопкой, а не просто заменить.

Три разрешения macOS

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

РазрешениеЗачем оноЧто вы увидите
1. Сетевое расширениеУстановить часть Routekeeper, которая работает внутри системы и решает, куда пустить соединение. Без неё не работает ничего.Переключатель в Системных настройках, пароль администратора.
2. Фильтрация сетевого контентаВидеть каждое новое исходящее соединение: какое приложение и куда подключается. По этому Routekeeper пропускает соединение, блокирует или спрашивает вас. Отсюда же берутся данные для монитора.Окно «Routekeeper хочет фильтровать сетевой контент».
3. Конфигурация проксиЗабирать соединения выбранных приложений и отправлять их через ваш прокси.Окно «Routekeeper хочет добавить конфигурацию прокси».

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

  1. Пройденный шаг: зелёная галочка вместо номера, кнопок больше нет.
  2. Текущий шаг: синий номер и кнопка. Здесь это Включить фильтр, после нажатия macOS покажет окно с вопросом.
  3. Следующие шаги бледные и без кнопок. Они открываются по очереди, когда пройден предыдущий.
  4. Запускать при входе в систему отмечено заранее. Routekeeper добавится в объекты входа, когда вы закроете приветственный экран. Правила работают и без открытого приложения, но без него нет уведомлений, вопросов файрвола и обновлений. Позже это меняется в настройках.
  5. Настрою позже появляется здесь, когда все три разрешения получены (на схеме обведена пунктиром). Кнопка пропускает шаги с прокси и приложениями.
Схема приветственного экрана: расширение установлено, следующий шаг — фильтр. Данные выдуманные.

Шаг 1. Сетевое расширение

  1. На приветственном экране нажмите Установить. macOS может сообщить, что системное расширение заблокировано. Поверх окон появится подсказка Routekeeper Разрешите сетевое расширение.
  2. Разрешите расширение в Системных настройках. Путь зависит от версии macOS, он описан ниже.
  3. Введите пароль администратора, когда macOS его попросит.
  4. Вернитесь в Routekeeper. Через пару секунд шаг отметится сам, а подсказка напишет «Готово, расширение включено» и закроется.

macOS 15 Sequoia и новее

  1. Нажмите Открыть Системные настройки на приветственном экране или Открыть настройки в подсказке.
  2. Откроется раздел Системные настройки → Основные → Объекты входа и расширения. Найдите там Сетевые расширения. Если открылся общий список расширений, выберите По категории → Сетевые расширения.
  3. Включите переключатель у Routekeeper и подтвердите паролем.
  1. Основные в боковой колонке Системных настроек.
  2. Раздел Объекты входа и расширения.
  3. Строка Сетевые расширения в группе Расширения. Нажмите ⓘ справа, откроется список сетевых расширений.
  4. Переключатель у Routekeeper Extension. Включите его, введите пароль администратора и нажмите Готово.
Упрощённая схема Системных настроек macOS 15. Данные выдуманные.

macOS 14 Sonoma

  1. Откройте Системные настройки → Конфиденциальность и безопасность.
  2. Прокрутите до раздела Безопасность. Там будет сообщение о том, что загрузка системного ПО разработчика «Ilya Bazhenov» заблокирована.
  3. Нажмите Разрешить рядом с этим сообщением и введите пароль администратора. Если заблокированных программ несколько, macOS вместо этого покажет кнопку со списком: отметьте в нём Routekeeper.
  1. Конфиденциальность и безопасность в боковой колонке Системных настроек.
  2. Раздел Безопасность. До него нужно прокрутить список вниз.
  3. Разрешить рядом с сообщением о системном ПО разработчика «Ilya Bazhenov». После нажатия macOS спросит пароль администратора.
Упрощённая схема Системных настроек macOS 14. Данные выдуманные.

На macOS 14 подсказки Routekeeper описывают путь из macOS 15. Пункта «Объекты входа и расширения» в Sonoma нет, и кнопки Открыть Системные настройки и Открыть настройки ведут не туда. Откройте «Конфиденциальность и безопасность» вручную, как написано выше.

Если macOS попросит перезагрузку, на приветственном экране появится «Перезагрузите Mac, чтобы завершить установку». Перезагрузите Mac и снова откройте Routekeeper: приветственный экран продолжит с того же места.

Закрыли подсказку кнопкой Скрыть? Вернуть её можно из меню значка: Разрешить сетевое расширение…. Кнопка Повторить на приветственном экране заново отправляет запрос macOS.

Шаг 2. Фильтрация сетевого контента

Нажмите Включить фильтр. macOS покажет окно «Routekeeper хочет фильтровать сетевой контент». Нажмите Разрешить.

Шаг 3. Конфигурация прокси

Нажмите Включить прокси. macOS покажет окно «Routekeeper хочет добавить конфигурацию прокси». Нажмите Разрешить.

Шаги открываются по очереди: фильтр — после расширения, прокси — после фильтра.

  1. Появляется после Включить фильтр (шаг 2).
  2. Появляется после Включить прокси (шаг 3).
  3. В обоих окнах нажмите Разрешить. После Не разрешать шаг останется невыполненным, и кнопку на приветственном экране можно нажать ещё раз.
Схема двух окон macOS, которые появляются на шагах 2 и 3. Текст под заголовком упрощён. Данные выдуманные.

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

Ничего не сломалось: шаг просто остался невыполненным.

Подробнее: что появилось в системе
  • Расширение установлено как системное. В списках macOS оно называется Routekeeper Extension (в версии 0.2.1 — Routekeeper Network Extension).
  • В Системных настройках, в разделе Сеть, появились две конфигурации Routekeeper: фильтр контента и прокси. Управляйте ими из Routekeeper, а не оттуда.
  • Фильтр и прокси запускаются вместе с системой. После перезагрузки ваши маршруты работают, даже если окно Routekeeper не открывать.
  • Состояние всех трёх частей видно в настройках Routekeeper на вкладке Расширение, в блоке Состояние: Сетевое расширение, Фильтр, Прокси.
  • Список установленных системных расширений показывает команда в Терминале:
systemextensionsctl list

Первый прокси

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

Где взять прокси

Свой сервер

Арендуйте VPS, нажмите Свой сервер… и впишите IP и пароль сервера: Routekeeper сам поставит на него HTTPS-прокси и добавит его. Пошагово — на странице «Свой прокси-сервер».

Клиент на этом Mac

Клиенты вроде sing-box, Xray или Clash обычно открывают на Mac локальный SOCKS5-порт, например 127.0.0.1:1080. Его и добавьте. Подробно — локальный клиент.

Рабочий прокси

Адрес, порт, логин и пароль выдаёт администратор сети. Подробно — рабочий прокси.

Готовая строка

Если вам дали строку вида socks5://логин:пароль@сервер:1080, её достаточно скопировать и вставить.

Routekeeper подключается к прокси трёх типов: SOCKS5, HTTP и HTTPS. Другие протоколы, например Shadowsocks или VLESS, напрямую он не понимает. Для них нужен клиент на Mac с локальным SOCKS5-портом.

Добавить прокси на приветственном экране

Когда три разрешения выданы, становится доступен шаг Добавить прокси-сервер.

  1. Скопируйте строку прокси, например https://логин:пароль@my.example.com:443.
  2. Нажмите Вставить из буфера. Откроется форма прокси с заполненными полями Тип, Сервер, Порт, Логин и Пароль.
  3. Переключатели DNS через прокси и Блокировать UDP и QUIC уже включены. Оставьте их так. Зачем они нужны, рассказано на странице «Как это работает».
  4. Если хотите проверить прокси до сохранения, нажмите Проверить. Через пару секунд рядом появится «Работает · 48 мс · IP 203.0.113.7» или текст ошибки.
  5. Нажмите Добавить. Routekeeper сохранит прокси и сразу проверит его.

Есть арендованный сервер, но нет прокси? Нажмите Свой сервер…: откроется мастер, который поставит прокси на сервер, см. Установка из Routekeeper.

Строки нет? Нажмите Ввести вручную… и заполните поля сами:

Если в буфере обмена нет строки прокси, Routekeeper так и скажет и покажет пример. Какие форматы строк он понимает, описано на странице «Прокси».

Приветственный экран уже закрыт? Откройте раздел Прокси и нажмите ⌘V или кнопку Вставить ссылку под списком.

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

Первое приложение

Последний шаг приветственного экрана, Что пустить через прокси, предлагает два способа. Их можно сочетать.

Приложение целиком

  1. Нажмите Выбрать приложения…. Откроется список установленных приложений с поиском.
  2. Отметьте одно или несколько, например браузер, рабочий мессенджер или Терминал, и нажмите Добавить.

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

Вместе с приложением через прокси идут и программы, которые оно запускает, — его дочерние процессы. Например, если добавить Терминал, через прокси пойдут и запущенные в нём git, curl или npm.

Сервис во всех приложениях

Под кнопкой — сервисы: ChatGPT, Claude, GitHub и другие. Сервис — это набор адресов одного сайта или мессенджера. Выбранный сервис идёт через прокси в любом приложении: в браузере, в клиенте, в консольной программе. Всё остальное в этих приложениях идёт как раньше.

Полный список из 32 сервисов открывает кнопка Все сервисы…. Если у сервиса есть своё приложение для Mac, Routekeeper добавит и его. Такое приложение, установленное позже, Routekeeper добавит, когда будет запущен. Сервисы из группы Российские сервисы добавляются с маршрутом Напрямую.

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

Добавить или поменять потом

Куда идёт весь трафик приложения, задаётся в разделе Приложения, а не в разделе Правила. Правила нужны для исключений: отдельный домен, адрес или порт.

Подробно — на странице «Приложения и сервисы».

Уже открытые соединения на новый маршрут не переходят. Routekeeper решает, куда пустить соединение, в момент, когда оно открывается. Если приложение держит долгие соединения, как мессенджеры, перезапустите его.

Проверить, что работает

  1. Значок в строке меню. Щёлкните по нему. Если всё в порядке, под названием будет «Работает» и число приложений через прокси, а строкой ниже — внешний IP прокси и его страна. Это адрес, который видят сайты. Если через прокси идут только сервисы, а не приложения целиком, там будет «Нет приложений через прокси» — это нормально.
  2. Кнопка Проверить. В разделе Прокси выберите прокси и нажмите Проверить. Routekeeper подключится через прокси и покажет задержку и внешний IP: «Работает · 48 мс · IP 203.0.113.7». Если вместо этого ошибка, например «SOCKS5: неверный логин или пароль» или «Прокси не ответил вовремя», смотрите что означают сообщения об ошибках.
  3. Обзор. Это главный экран. Сверху общий итог: «Всё работает» и какие приложения через какой прокси идут. Если что-то не так, там же сказано, что именно, например «Прокси «Амстердам» недоступен» или «Есть соединения мимо прокси». Блок Сейчас через прокси показывает приложения, у которых прямо сейчас есть трафик через прокси.
  4. В самом приложении. Откройте приложение, которое пустили через прокси, например браузер, и зайдите на любой сайт, показывающий ваш IP-адрес. Он должен совпасть с IP из строки меню. В разделе Монитор видно, что соединения этого приложения идут через прокси.

Если приложение, которое должно идти через прокси, отправит что-то напрямую, Routekeeper покажет это в разделе Мимо прокси (в версии 0.2.1 — Утечки) и подскажет, как исправить. Подробно — на странице «Проверка и мониторинг».

Как быстро выключить

Если после настройки что-то перестало открываться, выключите Routekeeper целиком. Это безопасно и занимает секунду.

  1. Щёлкните значок Routekeeper в строке меню.
  2. Выключите переключатель справа от названия Routekeeper (Routekeeper включён). В окне Routekeeper такой же переключатель есть внизу боковой колонки, рядом с состоянием.
  1. Состояние. Зелёная строка — всё работает. Ниже — внешний IP прокси и его страна (их видят сайты) и общая скорость.
  2. Переключатель Routekeeper включён. Если что-то перестало открываться, выключите его: все соединения пойдут напрямую.
  3. Режим для соединений, на которые нет правила. Подробнее — «Режимы файрвола».
  4. Появляется, когда прокси два или больше. Щелчок переводит на этот прокси все приложения, Routekeeper сначала спросит подтверждение.
Схема меню, которое открывается щелчком по значку Routekeeper в строке меню. Данные выдуманные.

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

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

Завершить Routekeeper его не выключает. Эта команда закрывает только окно и значок. Сетевое расширение работает дальше и применяет ваши правила. Чтобы всё шло напрямую, нужен переключатель.

Подробнее: чем переключатель отличается от других способов
СпособЧто происходитКак вернуть
Переключатель Routekeeper включёнВсе соединения идут напрямую. Фильтр и прокси остаются зарегистрированы в macOS.Тот же переключатель.
Завершить RoutekeeperЗакрываются окно и значок. Расширение работает по правилам. В режиме Спрашивать задать вопрос некому, поэтому соединения без правила разрешаются.Открыть Routekeeper из «Программ».
Настройки → Расширение → Остановить…Фильтр и прокси выключаются в самой macOS.Переустановить там же. Переключатель их не вернёт.
Настройки → Расширение → Удалить…Расширение удаляется из системы. Правила остаются на диске.Пройти приветственный экран заново.

Подробно — на странице «Обновление и удаление».

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

Упал только прокси? По умолчанию приложения, которые идут через него, получают ошибку соединения, а не уходят напрямую. Так задумано: трафик не идёт мимо прокси. Как временно переключиться на другой прокси или пустить всё напрямую, описано в рецепте на этот случай.

Что дальше

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