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

Рецепты: готовые настройки

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

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

Рецепты исходят из того, что Routekeeper уже установлен, разрешения macOS выданы и добавлен хотя бы один прокси. Если это не так, начните с быстрого старта.

Во всех рецептах подходит режим Только прокси: работают только ваши правила, а всё остальное идёт напрямую. Режим выбирается в панели внизу боковой колонки окна или в меню значка в строке меню. Про строгие режимы — в разделе «Режимы файрвола».

Мессенджер целиком через прокси

Кому: вы хотите, чтобы мессенджер на Mac (например, рабочий Slack) ходил в сеть только через ваш прокси, а остальные программы работали как обычно.

Здесь лучше направить через прокси приложение целиком, а не отдельные сайты. Мессенджеры часто подключаются к своим серверам по IP-адресу, без имени сайта. Правило по домену такое соединение не узнает, а маршрут приложения действует на все его соединения.

Шаги

  1. Откройте окно Routekeeper (значок в строке меню → Открыть Routekeeper) и перейдите в Прокси. Убедитесь, что у прокси зелёная точка. Если точка серая или красная, выделите прокси и нажмите Проверить: рядом с кнопкой появится «Работает», время ответа и внешний IP — или текст ошибки.
  2. Перейдите в Приложения, нажмите Добавить → Из списка установленных…, отметьте мессенджер и нажмите Добавить. Можно и просто перетащить приложение из Finder в список.
  3. Посмотрите на строку мессенджера. Справа указан маршрут, например Амстердам — имя прокси. Новое приложение сразу получает основной прокси — тот, через который идёт больше всего правил. Если прокси ещё нет, маршрут будет Напрямую. Чтобы выбрать другой прокси, нажмите на маршрут и выберите его в меню.
  4. Щёлкните строку правой кнопкой и проверьте, что отмечено Вместе с дочерними процессами. По умолчанию так и есть. Тогда под маршрут попадают и вспомогательные процессы мессенджера, через которые обычно идёт почти весь его трафик.
  5. Закройте мессенджер полностью (⌘Q) и откройте снова. Уже открытые соединения не переезжают на новый маршрут, а мессенджеры держат соединение часами.

Как проверить

Подводные камни

Подробнее: сервис вместо приложения

Если мессенджер есть в списке Сервисы, можно добавить и сервис: Приложения → Добавить → Сервис. Правило сервиса отправляет адреса этого сервиса через прокси в любом приложении, включая веб-версию в браузере. Начиная с версии 0.3.0 вместе с сервисом Routekeeper добавляет и приложение сервиса для Mac, если оно установлено или будет установлено позже. В 0.2.1 приложение нужно добавить самому, как в шагах выше.

Правило сервиса узнаёт соединения по имени сайта, а у некоторых сервисов ещё и по подсетям. Маршрут приложения целиком надёжнее: он не зависит от того, знает ли Routekeeper имя. Подробнее о сервисах — в разделе «Сервисы».

Один сервис в браузере через прокси

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

Шаги

  1. Откройте Приложения и нажмите Добавить → Сервис → GitHub. Если нужного сервиса нет в коротком меню, выберите Все сервисы…, отметьте его и нажмите Добавить. Сервис появится в группе Сервисы с маршрутом через основной прокси.
  2. Сам браузер в список приложений не добавляйте. Если он там уже есть с маршрутом через прокси, весь браузер и так идёт через прокси и этот рецепт не нужен.
  3. Перейдите в Правила и нажмите Новое правило (⌘N). Заполните окно так:
    • Приложение: нажмите Изменить → Выбрать… и укажите браузер. Вместе с дочерними процессами оставьте включённым.
    • Назначение: оставьте пустым — это любой адрес.
    • Порт: 443.
    • Протокол: UDP.
    • Действие: Блокировать.
    • Заметка: например, «QUIC браузера».
    Нажмите Сохранить.
  4. Закройте браузер полностью и откройте снова, чтобы старые соединения не остались на прежнем маршруте.

Зачем правило про UDP

Браузеры часто открывают сайты по QUIC — это протокол поверх UDP. Правило сервиса узнаёт соединение по имени сайта, а у QUIC-соединений Routekeeper не всегда это имя видит. Без имени правило сервиса не срабатывает, и соединение идёт по маршруту браузера, то есть напрямую.

Правило «браузер · 443 · UDP → Блокировать» закрывает браузеру QUIC. Браузер сам переходит на обычный HTTPS по TCP, где имя сайта известно, и правило сервиса срабатывает. Для остальных сайтов разница незаметна: они тоже открываются по TCP.

Как проверить

Подводные камни

Подробнее: почему побеждает нужное правило

Routekeeper выбирает одно правило — самое точное, порядок в списке не важен. Сначала сравнивается адрес: правило сервиса совпадает по имени сайта, поэтому для соединений с GitHub оно важнее маршрута браузера, у которого адрес «любой». У правила про UDP адрес тоже «любой», но заданы порт и протокол, поэтому для UDP-соединений на порт 443 оно важнее маршрута браузера.

Если UDP-соединение всё же пришло с именем сайта из списка, сработает правило сервиса: маршрут через прокси, а UDP через прокси не передаётся и блокируется переключателем Блокировать UDP и QUIC. Полностью порядок описан в разделе «Какое правило важнее», а про имена сайтов — в «Правила по именам сайтов».

DNS через HTTPS в браузере

Кому: браузер целиком идёт через прокси, а в разделе Мимо прокси появляются записи DNS мимо прокси от браузера, или Обзор пишет «DNS-запросы идут напрямую» (в версии 0.2.1 — «Есть утечки»).

Чтобы открыть сайт, браузер сначала узнаёт его адрес у DNS-сервера. Некоторые браузеры делают это сами, обычным запросом на порт 53 к DNS-серверу провайдера, — и такой запрос идёт мимо прокси. Основной трафик при этом всё равно идёт через прокси, но DNS-провайдер видит ваш IP и имена сайтов.

Выход — включить в браузере DNS через HTTPS (DoH). Тогда браузер спрашивает адреса по зашифрованному HTTPS-соединению, а оно идёт через прокси вместе с остальным трафиком браузера.

Шаги

Названия пунктов зависят от версии и языка браузера. Если не нашли пункт, введите DNS в поиск по настройкам браузера.

  1. Chrome. Откройте в адресной строке chrome://settings/security. Включите безопасный DNS (Use secure DNS) и выберите конкретного поставщика из списка, например Cloudflare или Google.
  2. Edge. Откройте edge://settings и найдите поиском «DNS». Включите безопасный DNS (Use secure DNS) и выберите поставщика из списка.
  3. Firefox. Откройте about:preferences#privacy, прокрутите до раздела про DNS через HTTPS (DNS over HTTPS) и выберите максимальную защиту (Max Protection) с любым поставщиком.
  4. Brave. Откройте brave://settings/security. Включите безопасный DNS (Use secure DNS) и выберите поставщика из списка.
  5. Перезапустите браузер.

Не блокируйте браузеру порт 53. Для браузеров Routekeeper нарочно не показывает кнопку Блокировать DNS. Без DoH браузер с закрытым портом 53 перестанет открывать сайты. Даже с DoH браузеру иногда нужен обычный DNS, например чтобы узнать адрес самого DNS-сервиса.

Как проверить

Подводные камни

Подробнее: какие DNS-запросы Routekeeper видит

Безопасный DNS браузера — это HTTPS-соединение на порт 443, его Routekeeper ведёт по маршруту браузера, то есть через прокси. Обычный запрос на UDP-порт 53 от приложения на прокси Routekeeper не блокирует, а пропускает напрямую и отмечает как DNS мимо прокси. Это самый низкий уровень важности. Служебные запросы ipv4only.arpa и _dns.resolver.arpa одинаковы у всех и не отмечаются.

Safari и большинство программ узнают адреса через системную службу macOS. Такие запросы делает сама система, и Routekeeper не привязывает их к приложению. Когда приложение передаёт имя сайта, а у прокси включено DNS через прокси, адрес узнаёт уже прокси-сервер. Подробнее — в разделе «DNS: как приложения узнают адрес сайта».

Терминал, инструменты разработчика и AI-приложения

Кому: нужно, чтобы git, npm, pip, brew, curl и AI-приложения для Mac выходили в интернет через ваш прокси. Например, когда рабочий репозиторий или API принимает подключения только с адреса вашего сервера. Остальные программы при этом работают как обычно.

Шаги

  1. Откройте Приложения → Добавить → Из списка установленных…. Отметьте Терминал и, если пользуетесь, iTerm. Нажмите Добавить.
  2. Проверьте, что у терминала отмечено Вместе с дочерними процессами (правый щелчок по строке; по умолчанию включено). Тогда под маршрут попадает всё, что вы запускаете в этом терминале: git, npm, pip, brew, curl, ssh. Это и есть дочерние процессы.
  3. Так же добавьте редактор кода (VS Code, Cursor, IDE JetBrains). Его расширения и встроенный терминал — дочерние процессы редактора.
  4. Добавьте AI-приложения для Mac — например, ChatGPT или Claude — так же, как в шаге 1.
  5. Новые команды пойдут через прокси сразу. Уже открытые соединения, например сессия ssh, останутся на прежнем маршруте до переподключения.

Как проверить

Выполните в терминале команду. Она должна напечатать внешний IP прокси — тот же, что показан в меню значка в строке меню.

curl https://ipinfo.io/ip

В Монитор введите в поиск curl: в столбце Маршрут будет имя прокси, а в поле Решение выделенной строки — правило терминала.

Подводные камни

Подробнее: сервисы для AI-инструментов

В списке Сервисы есть ChatGPT, Claude, Gemini, GitHub Copilot, Cursor, Perplexity и Grok, а также GitHub и JetBrains. Сервис отправляет свои адреса через прокси в любом приложении: в браузере, в редакторе и в консольных программах, даже если они запущены не из терминала.

Начиная с версии 0.3.0 вместе с сервисом Routekeeper добавляет и его приложения: например, ChatGPT, Claude, Cursor, IDE JetBrains, а для Claude ещё и консольную программу claude. Приложение, установленное позже, добавится само. В 0.2.1 приложения нужно добавлять отдельно.

Терминал «узнаёт» дочерний процесс по цепочке родителей: curl, запущенный из Терминала, попадает под правило Терминала, даже если сам curl подписан Apple. Подробнее — в разделе «Дочерние процессы».

Поверх sing-box, Xray или Clash

Кому: у вас уже есть клиент вроде sing-box, Xray или Clash, который подключается к серверу по протоколу, которого Routekeeper сам не знает (например, VLESS или Shadowsocks). Клиент открывает на Mac локальный SOCKS5-порт, а Routekeeper решает, какие приложения в него отправить.

Приложение → Routekeeper → 127.0.0.1:порт → клиент → ваш сервер → интернет

Шаги

  1. В настройках клиента найдите локальный вход SOCKS5 (иногда он называется mixed): адрес 127.0.0.1 и порт, например 1080 или 7890.
  2. В клиенте выключите системный прокси (System Proxy) и режим TUN (его ещё называют Enhanced Mode). Маршрутами должен управлять кто-то один, иначе правила Routekeeper не будут действовать.
  3. В Routekeeper откройте Прокси и добавьте прокси. Проще всего скопировать строку вида socks5://127.0.0.1:7890 и нажать Вставить ссылку под списком прокси: поля заполнятся сами. Или нажмите Добавить прокси и заполните их вручную: Тип — SOCKS5, Сервер — 127.0.0.1, Порт — порт клиента. Переключатели DNS через прокси и Блокировать UDP и QUIC оставьте включёнными. Нажмите Добавить.
  4. Routekeeper сразу проверит новый прокси. Рядом с кнопкой Проверить появится внешний IP — адрес сервера, к которому подключён клиент.
  5. В Приложения направьте нужные приложения на этот прокси, как в рецепте про мессенджер.
  6. Если вы работаете в режиме Спрашивать или Блокировать всё, разрешите самому клиенту выходить в сеть: добавьте его в Приложения с маршрутом Напрямую. В режиме Только прокси этот шаг не нужен.

Как проверить

Подводные камни

Подробнее: зачем выключать системный прокси клиента

Системный прокси — это настройка macOS, которую сами читают браузеры и многие программы. С ней браузер отправляет всё в клиент без участия Routekeeper. Routekeeper видит только соединение с 127.0.0.1, а соединения с этим же Mac он не трогает (Настройки → Сеть → Не трогать localhost). В итоге решает клиент, а правила Routekeeper для такого браузера не действуют.

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

Рабочий прокси для внутренних адресов

Кому: компания даёт HTTP-прокси, через который открываются внутренние сайты, например *.corp.example, и сеть 10.0.0.0/8. Всё остальное должно идти как обычно: напрямую или через ваш личный прокси.

Шаги

  1. Откройте Прокси → Добавить прокси. Заполните: Название — «Офис», Тип — HTTP (или HTTPS, если так сказано в инструкции компании), Сервер — например proxy.corp.example, Порт — например 3128. Логин и Пароль — если прокси их требует. Нажмите Добавить.
  2. Перейдите в Правила → Новое правило. Приложение оставьте Любое приложение. В Назначение впишите *.corp.example. В Действие выберите «Офис» в группе Через прокси. В Заметка — «Рабочие сайты». Нажмите Сохранить.
  3. Создайте второе правило так же, но в Назначение впишите подсеть 10.0.0.0/8.
  4. В Приложения на «Офис» ничего не направляйте: хватит этих двух правил.

Шаблон *.corp.example — это сам corp.example и все его поддомены (подробнее о шаблоне). Запись 10.0.0.0/8 — диапазон адресов от 10.0.0.0 до 10.255.255.255 (подсеть). Как ещё можно записать адрес, — в «Поля правила».

Как проверить

Подводные камни

Подробнее: почему эти правила важнее маршрута браузера

Даже если браузер целиком идёт через личный прокси, соединения с *.corp.example уйдут через «Офис». Routekeeper выбирает самое точное правило: шаблон имени точнее подсети, подсеть точнее «любого адреса», а у маршрута приложения адрес как раз «любой». Порядок правил в списке значения не имеет. Подробнее — в «Какое правило важнее».

Правило по имени срабатывает, когда приложение передало имя сайта. Правило по подсети сверяет IP-адрес и работает всегда, в том числе для соединений по имени, если оно указывает в эту подсеть. Соединения с самим адресом и портом «Офиса» всегда идут напрямую, чтобы не получилось петли. Подробнее о рабочем прокси — в разделе «Рабочий прокси».

Прокси перестал отвечать

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

Что происходит

Перевести маршруты одного прокси

  1. Откройте Обзор. В блоке Маршруты у недоступного прокси есть кнопка Перевести на «…» с именем другого прокси. Нажмите её. Другой прокси можно выбрать и вручную: меню строки (кнопка с многоточием) → Перевести маршруты на.
  2. Routekeeper покажет, что именно переедет и откуда. Нажмите Перевести.
  3. Если перевели не туда, в течение 10 секунд под прокси в панели боковой колонки можно нажать Отменить. Отменить можно и сочетанием ⌘Z, пока окно открыто.

Перевести все приложения сразу

Когда прокси два и больше, все маршруты можно перевести одним действием:

Routekeeper попросит подтверждение и покажет, что переедет. Учтите: так переезжают все правила с любым прокси, в том числе те, что вы нарочно отправили через другой, например рабочий.

Если другого прокси нет

Как проверить

Подводные камни

Подробнее: как Routekeeper выбирает прокси для кнопки на «Обзоре»

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

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