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

Правила: исключения по адресам

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

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

Правило отвечает на вопрос «какое приложение, куда, на какой порт и по какому протоколу — и что с этим делать». Раздел Правила (⌘3) показывает все правила, включая строки из Приложений.

Когда нужно правило

Чаще всего правила писать не нужно:

Правило нужно для исключений и тонкой настройки:

Как создать правило:

Новое правило начинается как «Любое приложение · любой адрес → основной прокси». Если сохранить его, ничего не поменяв, через прокси пойдут все приложения, у которых нет своей строки. Заполните Назначение или выберите приложение. Если прокси ещё нет, действие нового правила — Напрямую.

Поля правила

Двойной щелчок по правилу или Новое правило открывает окно с полями:

ПолеЧто задаёт
ПриложениеЛюбое приложение или конкретное. Кнопка Изменить: Любое приложение, Выбрать… (окно выбора файла) или одно из приложений, которые уже есть в правилах.
Вместе с дочерними процессамиПоявляется, когда выбрано конкретное приложение. Что делает — в разделе Приложения и сервисы.
НазначениеКуда идёт соединение, см. таблицу ниже. Меню Сервис рядом вписывает сервис.
ПортОдно число от 1 до 65535 — порт сервера. Пусто — любой порт. Например, 443 — HTTPS и QUIC, 80 — HTTP, 22 — SSH, 53 — DNS.
ПротоколTCP и UDP (любой), TCP или UDP. Почти все соединения — TCP; UDP — это QUIC, звонки и DNS.
ДействиеПрокси из раздела Через прокси, Напрямую, Блокировать или Спрашивать. Подробнее — в разделе Как это работает.
ЗаметкаЛюбой текст для себя. Виден под назначением, по нему работает поиск.

Кнопки: Сохранить, Отмена и, у существующего правила, Удалить. Срока действия в окне нет: правило из него действует, пока вы его не выключите или не удалите.

  1. «?» рядом с заголовком открывает короткую памятку о том, какое правило важнее. Подробно — «Какое правило важнее».
  2. Любое приложение или конкретное, выбор — в меню Изменить. Для конкретного приложения ниже появляется Вместе с дочерними процессами.
  3. Куда идёт соединение: имя (files.example.com), шаблон (*.corp.example — сам домен и все его поддомены), IP, подсеть или @сервис. Пустое поле — любой адрес, в нём видна подсказка «Любой адрес · *.example.com · 10.0.0.0/8 · @youtube». Меню Сервис вписывает сервис. Как записать адрес — в таблице ниже.
  4. Порт — одно число, пусто — любой порт. Протокол — меню: TCP и UDP, TCP или UDP.
  5. Что делать с соединением: прокси, Напрямую, Блокировать или Спрашивать.
Схема окна нового правила: Chrome идёт через прокси, а сайты компании — напрямую. Данные выдуманные.

Как записать адрес

Что вписатьЧто подходитПример
ПустоЛюбой адрес. То же значат * и «любой адрес».—
ИмяТолько это имя, без поддоменов.files.example.com — не подходит ни для example.com, ни для a.files.example.com
*.имяСамо имя и все его поддомены (шаблон).*.example.com — подходит для example.com, www.example.com, a.b.example.com
IP-адресТолько этот адрес, IPv4 или IPv6.203.0.113.10, 2001:db8::1
ПодсетьВсе адреса подсети.10.0.0.0/8, 192.168.1.0/24, fd00::/8
@сервисВсе адреса сервиса.@github, @chatgpt, @ru-banks
Подробнее: коды сервисов для @

Меню Сервис вписывает код само. Если удобнее набрать руками:

  • github, slack, zoom, notion, figma, jetbrains, spotify;
  • chatgpt, claude, gemini, copilot, cursor, perplexity, grok;
  • ru-gov, ru-banks, ru-sites.

Остальные коды проще не набирать, а выбрать в меню Сервис. В версии 0.2.1 нет slack, zoom, github, figma и ещё трёх сервисов.

Действие Через прокси для UDP: UDP через прокси не проходит, его судьбу решает переключатель прокси Блокировать UDP и QUIC.

Какое правило важнее

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

  1. Точнее назначение. Точное имя или IP-адрес важнее шаблона *., шаблон важнее подсети, подсеть важнее любого адреса. Из двух шаблонов важнее длинный (*.cdn.example.com важнее *.example.com), из двух подсетей — меньшая (/24 важнее /8).
  2. Вписанный вручную адрес важнее сервиса, если оба одинаково точны.
  3. Правило с портом важнее правила без порта.
  4. Правило с протоколом важнее правила без протокола.
  5. Конкретное приложение важнее его дочерних процессов, а они важнее «Любого приложения».
  6. Действие: Блокировать важнее Через прокси, оно важнее Напрямую, а то — Спрашивать.

Если не подошло ни одно правило, решает режим. В режиме Только прокси соединение идёт напрямую.

Сначала адрес, потом приложение. Поэтому правило «Любое приложение · *.corp.example → Напрямую» для сайтов компании важнее маршрута «Браузер → Через прокси», хотя браузер указан конкретно. По той же причине сервис важнее маршрута приложения.

Разобранные примеры

1. Браузер через прокси, сайты компании напрямую

СоединениеРезультатПочему
Браузер → news.example.orgЧерез «Амстердам»Подходит только маршрут браузера.
Браузер → wiki.corp.exampleНапрямуюПодходят оба. Шаблон точнее любого адреса, а назначение сравнивается раньше приложения.

2. Два шаблона

СоединениеРезультатПочему
img.cdn.example.comНапрямуюПодходят оба, длинный шаблон точнее.
www.example.comЧерез «Амстердам»Второй шаблон сюда не подходит.

3. Сервис и свой домен

СоединениеРезультатПочему
app.slack.comЧерез «Офис»Сервис совпал по slack.com, то есть так же точно, как *.slack.com. При равной точности вписанный вручную адрес важнее сервиса.
slack-edge.comЧерез «Амстердам»Это имя есть только в сервисе.

4. Порт, приложение и дочерние процессы

СоединениеРезультатПочему
ssh из Терминала → сервер, порт 22НапрямуюНазначение у обоих правил — любой адрес. Правило с портом важнее, и порт сравнивается раньше приложения.
curl из Терминала → любой сайтНапрямуюСтрока самого curl важнее строки Терминала, который его запустил.
git из Терминала → github.com, порт 443Через «Амстердам»Подходит только строка Терминала: git — его дочерний процесс.
Подробнее: точный алгоритм
  1. Если Routekeeper выключен переключателем Routekeeper включён, всё идёт напрямую.
  2. Соединение на адрес и порт любого прокси из списка идёт напрямую, правила не проверяются.
  3. Кандидаты — включённые правила с неистёкшим сроком, у которых совпали приложение, назначение и, если заданы, порт и протокол. Приложение совпадает точно, как дочерний процесс (если у правила включена настройка) или как «Любое приложение».
  4. У каждого кандидата считается вес — шесть чисел, которые сравниваются по порядку:
    • назначение: точное имя или IP-адрес — 4000; шаблон *.имя — 3000 плюс длина шаблона в символах; подсеть — 2000 плюс длина префикса; любой адрес — 0. Сервис получает вес совпавшей записи: имя из списка «только это имя» — как точное имя, имя «и поддомены» — как шаблон *.имя, подсеть — как подсеть;
    • адрес вписан вручную — 1, сервис — 0;
    • порт задан — 1, нет — 0;
    • протокол задан — 1, нет — 0;
    • приложение: точное — 3, дочерний процесс — 2, любое — 1;
    • действие: Блокировать — 3, Через прокси — 2, Напрямую — 1, Спрашивать — 0.
  5. Побеждает больший вес. При полном равенстве остаётся правило, которое раньше появилось в списке правил. Сортировка таблицы на это не влияет.
  6. Если победило правило Через прокси с любым адресом (маршрут приложения, в том числе унаследованный дочерним процессом) и включено Настройки → Сеть → Локальные сети — напрямую (включено по умолчанию), Routekeeper проверяет адрес. Если он в одной из локальных сетей этого Mac, соединение идёт напрямую, а не в прокси. Адрес считается локальным, когда он частный (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, 100.64.0.0/10 — сюда входят адреса Tailscale, fc00::/7) и по таблице маршрутов Mac уходит либо в подключённую сеть без роутера, либо в туннель VPN (интерфейсы utun, ipsec, ppp, tun, tap). Адреса 169.254.0.0/16 и fe80::/10 локальные всегда. Запросы DNS (порты 53 и 853) так не пропускаются. Правила с адресом, подсетью или сервисом и правила с другим действием этот шаг не трогает.
  7. Если кандидатов нет: соединение с этим же Mac (127.0.0.0/8, ::1, localhost) при включённой настройке Не трогать localhost идёт напрямую, остальное решает режим.

Следствия:

  • Правило с портом, но с любым адресом проигрывает правилу с адресом, но без порта: точность адреса сравнивается первой.
  • Если в списке сервиса есть точное имя, для этого имени сервис важнее вашего шаблона *.: шаблон проигрывает точному имени, кто бы его ни вписал. Чтобы перебить сервис, впишите точное имя.
  • Шаблон всегда важнее подсети. *.corp.example перебьёт 10.0.0.0/8 для имени из этого домена, даже если его адрес лежит в подсети.
  • Правило «Любое приложение · любой адрес» срабатывает раньше режима: режим решает, только когда не подошло ни одно правило.
  • Маршрут приложения через прокси не уводит в прокси домашнюю сеть, корпоративный VPN и Tailscale: удалённый прокси до них не дотянется. Чтобы такой адрес всё же шёл через прокси, например офисный, создайте правило с этим адресом или подсетью и действием Через прокси, как в рецепте «Рабочий прокси для внутренних адресов».
  • Частный адрес, который уходит через обычный роутер, локальным не считается. Некоторые DNS-серверы отвечают на запрос имени частным адресом. Такое соединение идёт в прокси, и прокси сам узнаёт настоящий адрес сайта.
  • Если внутренние серверы компании стоят на публичных адресах, Routekeeper не узнает в них локальную сеть. Для них создайте правило с подсетью компании → Напрямую.
  • Локальные адреса идут напрямую и по UDP: Блокировать UDP и QUIC их не блокирует, а раздел Мимо прокси не отмечает. В Монитор в поле Решение у них написано «локальная сеть, мимо прокси из правила для …».

Правила по именам сайтов

Правила с именем (example.com, *.example.com) и сервисы сравнивают имя сервера. Routekeeper знает имя, когда приложение попросило macOS подключиться по имени. Так делают браузеры и большинство приложений.

Имени нет, когда:

Тогда правила по имени и сервисы к соединению не подходят. Оно идёт по правилам с IP-адресом или подсетью и по маршруту приложения. Исключение — сервисы, в которых есть подсети: их соединения узнаются и по IP. Подробнее — в разделе Ограничения.

Пример: часть сайта в браузере идёт мимо прокси

Браузер идёт Напрямую или его нет в списке, а сервис GitHub — Через прокси. Страницы открываются через прокси: обычный HTTPS идёт по TCP и несёт имя. А часть запросов браузер часто шлёт по QUIC — это UDP на порт 443, обычно без имени. Такое соединение идёт по маршруту браузера, то есть напрямую.

Решение — заблокировать браузеру QUIC:

  1. В разделе Правила нажмите ⌘N.
  2. Приложение: Изменить → выберите браузер.
  3. Назначение оставьте пустым. Порт: 443. Протокол: UDP. Действие: Блокировать.
  4. Нажмите Сохранить.

Браузер перейдёт на обычный HTTPS по TCP. Такое соединение несёт имя и идёт по правилу сервиса, через прокси. Сайты продолжают работать. Подробный рецепт — Один сервис в браузере через прокси.

Если сам браузер идёт Через прокси, такое правило не нужно: его UDP и так блокирует переключатель прокси Блокировать UDP и QUIC.

Соединения без имени Монитор показывает только с IP-адресом, см. Монитор.

Список правил

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

Под заголовком окна — сколько правил каждого вида, например «Мои: 9 · системные: 372». Если поиск ничего не нашёл среди своих правил, а среди системных нашёл, появится кнопка Искать во всех.

Столбцы

Щелчок по заголовку столбца сортирует список. Поиск на панели инструментов ищет по приложению, адресу и заметке.

Источники

ИсточникОткуда правило
ВручнуюВы создали его сами: в окне правила, в Приложениях, добавив сервис, или из Монитора.
Из окна-вопросаВаш ответ в окне вопроса со сроком «Пока процесс работает» или Навсегда. Ответ со сроком Один раз правила не создаёт. См. Спрашивать.
AppleРежим Спрашивать сам разрешил программу Apple.
Установлено ранееРежим Спрашивать сам разрешил приложение, установленное до Routekeeper.
На проверкуRoutekeeper пропустил соединение без вопроса и оставил правило, чтобы вы его проверили. Так бывает в режиме Спрашивать, когда ответить было некому (приложение Routekeeper не было запущено), и в режиме Тихий с настройкой Создавать правила «на проверку».
По умолчаниюВстроенные правила, см. ниже.

Правила Apple, Установлено ранее и По умолчанию — системные: они видны в Системные и Все. Остальные — в Мои. Чтобы разобрать правила На проверку, щёлкните заголовок столбца Источник, чтобы они встали рядом, откройте правило двойным щелчком, выберите действие и нажмите Сохранить. Или выделите несколько и задайте действие через контекстное меню. После этого источник станет Вручную.

Действия со списком

Встроенные правила

Три правила с источником По умолчанию есть с первого запуска. Они системные, поэтому в Мои их не видно:

Не удаляйте и не выключайте встроенные правила. Без первых двух приложение с маршрутом через прокси отправит в прокси и свои соединения с этим же Mac: маршрут приложения важнее настройки Не трогать localhost, которая действует, только когда не подошло ни одно правило.

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

Импорт и экспорт

Экспорт

  1. В разделе Правила нажмите Импорт и экспорт на панели инструментов и выберите Экспортировать…. Из любого раздела: Файл → Экспортировать правила….
  2. Выберите, куда сохранить файл. По умолчанию он называется Routekeeper-rules.json.

В файл попадают все правила, включая встроенные, и все прокси: адреса серверов, порты и логины. Пароли прокси в файл не попадают. Настройки (режим, вкладки Настройки) тоже не сохраняются. Храните файл как личный: в нём адреса ваших прокси и логины.

Импорт

  1. Импорт и экспорт → Импортировать… или Файл → Импортировать правила…. Выберите файл.
  2. Routekeeper спросит: Заменить все правила и прокси? и покажет, сколько правил и прокси сейчас и сколько в файле.
  3. Нажмите Заменить.
  4. Откройте раздел Прокси, впишите пароли у прокси с логином и нажмите Проверить.

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

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

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