Все разделы документации
Правило отвечает на вопрос «какое приложение, куда, на какой порт и по какому протоколу — и что с этим делать». Раздел Правила (⌘3) показывает все правила, включая строки из Приложений.
Когда нужно правило
Чаще всего правила писать не нужно:
- куда идёт всё приложение, задаётся в разделе Приложения;
- куда идёт известный сайт или мессенджер из всех приложений, задаёт сервис.
Правило нужно для исключений и тонкой настройки:
- исключение внутри приложения: браузер идёт через прокси, а сайты компании — напрямую;
- адреса для всех приложений: «Любое приложение ·
*.corp.example→ Через прокси «Офис»»; - порт или протокол: заблокировать QUIC в браузере («браузер · порт 443 · UDP → Блокировать»), пустить SSH (порт 22) напрямую;
- один адрес: заблокировать сервер, куда приложение отправляет статистику.
Как создать правило:
- в разделе Правила нажмите Новое правило (+ на панели инструментов) или ⌘N. ⌘N работает из любого раздела: Файл → Новое правило…;
- в Мониторе выберите у соединения Создать правило… в контекстном меню или в подробностях: приложение и адрес уже будут заполнены;
- в режиме Спрашивать правило создаёт ответ в окне вопроса, см. Спрашивать.
Новое правило начинается как «Любое приложение · любой адрес → основной прокси». Если сохранить его, ничего не поменяв, через прокси пойдут все приложения, у которых нет своей строки. Заполните Назначение или выберите приложение. Если прокси ещё нет, действие нового правила — Напрямую.
Поля правила
Двойной щелчок по правилу или Новое правило открывает окно с полями:
| Поле | Что задаёт |
|---|---|
| Приложение | Любое приложение или конкретное. Кнопка Изменить: Любое приложение, Выбрать… (окно выбора файла) или одно из приложений, которые уже есть в правилах. |
| Вместе с дочерними процессами | Появляется, когда выбрано конкретное приложение. Что делает — в разделе Приложения и сервисы. |
| Назначение | Куда идёт соединение, см. таблицу ниже. Меню Сервис рядом вписывает сервис. |
| Порт | Одно число от 1 до 65535 — порт сервера. Пусто — любой порт. Например, 443 — HTTPS и QUIC, 80 — HTTP, 22 — SSH, 53 — DNS. |
| Протокол | TCP и UDP (любой), TCP или UDP. Почти все соединения — TCP; UDP — это QUIC, звонки и DNS. |
| Действие | Прокси из раздела Через прокси, Напрямую, Блокировать или Спрашивать. Подробнее — в разделе Как это работает. |
| Заметка | Любой текст для себя. Виден под назначением, по нему работает поиск. |
Кнопки: Сохранить, Отмена и, у существующего правила, Удалить. Срока действия в окне нет: правило из него действует, пока вы его не выключите или не удалите.
- «?» рядом с заголовком открывает короткую памятку о том, какое правило важнее. Подробно — «Какое правило важнее».
- Любое приложение или конкретное, выбор — в меню Изменить. Для конкретного приложения ниже появляется Вместе с дочерними процессами.
- Куда идёт соединение: имя (
files.example.com), шаблон (*.corp.example— сам домен и все его поддомены), IP, подсеть или@сервис. Пустое поле — любой адрес, в нём видна подсказка «Любой адрес · *.example.com · 10.0.0.0/8 · @youtube». Меню Сервис вписывает сервис. Как записать адрес — в таблице ниже. - Порт — одно число, пусто — любой порт. Протокол — меню: TCP и UDP, TCP или UDP.
- Что делать с соединением: прокси, Напрямую, Блокировать или Спрашивать.
Как записать адрес
| Что вписать | Что подходит | Пример |
|---|---|---|
| Пусто | Любой адрес. То же значат * и «любой адрес». | — |
| Имя | Только это имя, без поддоменов. | 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 |
- Регистр букв не важен.
- Только имя сервера: без
https://, без пути и без порта. Порт — отдельное поле. Routekeeper видит имя сервера, но не адрес страницы. - Звёздочка работает только в начале и с точкой:
*.example.com. Записи вроде*example.comилиex*.comне сработают. - Если Routekeeper не понял назначение, он ответит «Не понимаю назначение «…»». Неверный порт — «Порт должен быть числом от 1 до 65535».
Подробнее: коды сервисов для @
Меню Сервис вписывает код само. Если удобнее набрать руками:
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 берёт все включённые правила, которые к нему подходят, и выбирает самое точное. Правила сравниваются по очереди, пока не найдётся разница:
- Точнее назначение. Точное имя или IP-адрес важнее шаблона
*., шаблон важнее подсети, подсеть важнее любого адреса. Из двух шаблонов важнее длинный (*.cdn.example.comважнее*.example.com), из двух подсетей — меньшая (/24важнее/8). - Вписанный вручную адрес важнее сервиса, если оба одинаково точны.
- Правило с портом важнее правила без порта.
- Правило с протоколом важнее правила без протокола.
- Конкретное приложение важнее его дочерних процессов, а они важнее «Любого приложения».
- Действие: Блокировать важнее Через прокси, оно важнее Напрямую, а то — Спрашивать.
Если не подошло ни одно правило, решает режим. В режиме Только прокси соединение идёт напрямую.
Сначала адрес, потом приложение. Поэтому правило «Любое приложение · *.corp.example → Напрямую» для сайтов компании важнее маршрута «Браузер → Через прокси», хотя браузер указан конкретно. По той же причине сервис важнее маршрута приложения.
Разобранные примеры
1. Браузер через прокси, сайты компании напрямую
- Браузер → Через прокси «Амстердам» (строка в Приложениях);
- Любое приложение ·
*.corp.example→ Напрямую.
| Соединение | Результат | Почему |
|---|---|---|
Браузер → news.example.org | Через «Амстердам» | Подходит только маршрут браузера. |
Браузер → wiki.corp.example | Напрямую | Подходят оба. Шаблон точнее любого адреса, а назначение сравнивается раньше приложения. |
2. Два шаблона
- Любое приложение ·
*.example.com→ Через прокси «Амстердам»; - Любое приложение ·
*.cdn.example.com→ Напрямую.
| Соединение | Результат | Почему |
|---|---|---|
img.cdn.example.com | Напрямую | Подходят оба, длинный шаблон точнее. |
www.example.com | Через «Амстердам» | Второй шаблон сюда не подходит. |
3. Сервис и свой домен
- Сервис Slack → Через прокси «Амстердам»;
- Любое приложение ·
*.slack.com→ Через прокси «Офис».
| Соединение | Результат | Почему |
|---|---|---|
app.slack.com | Через «Офис» | Сервис совпал по slack.com, то есть так же точно, как *.slack.com. При равной точности вписанный вручную адрес важнее сервиса. |
slack-edge.com | Через «Амстердам» | Это имя есть только в сервисе. |
4. Порт, приложение и дочерние процессы
- Терминал → Через прокси «Амстердам», с дочерними процессами;
- Любое приложение · порт 22 · TCP → Напрямую;
curl→ Напрямую.
| Соединение | Результат | Почему |
|---|---|---|
ssh из Терминала → сервер, порт 22 | Напрямую | Назначение у обоих правил — любой адрес. Правило с портом важнее, и порт сравнивается раньше приложения. |
curl из Терминала → любой сайт | Напрямую | Строка самого curl важнее строки Терминала, который его запустил. |
git из Терминала → github.com, порт 443 | Через «Амстердам» | Подходит только строка Терминала: git — его дочерний процесс. |
Подробнее: точный алгоритм
- Если Routekeeper выключен переключателем Routekeeper включён, всё идёт напрямую.
- Соединение на адрес и порт любого прокси из списка идёт напрямую, правила не проверяются.
- Кандидаты — включённые правила с неистёкшим сроком, у которых совпали приложение, назначение и, если заданы, порт и протокол. Приложение совпадает точно, как дочерний процесс (если у правила включена настройка) или как «Любое приложение».
- У каждого кандидата считается вес — шесть чисел, которые сравниваются по порядку:
- назначение: точное имя или IP-адрес — 4000; шаблон
*.имя— 3000 плюс длина шаблона в символах; подсеть — 2000 плюс длина префикса; любой адрес — 0. Сервис получает вес совпавшей записи: имя из списка «только это имя» — как точное имя, имя «и поддомены» — как шаблон*.имя, подсеть — как подсеть; - адрес вписан вручную — 1, сервис — 0;
- порт задан — 1, нет — 0;
- протокол задан — 1, нет — 0;
- приложение: точное — 3, дочерний процесс — 2, любое — 1;
- действие: Блокировать — 3, Через прокси — 2, Напрямую — 1, Спрашивать — 0.
- назначение: точное имя или IP-адрес — 4000; шаблон
- Побеждает больший вес. При полном равенстве остаётся правило, которое раньше появилось в списке правил. Сортировка таблицы на это не влияет.
- Если победило правило Через прокси с любым адресом (маршрут приложения, в том числе унаследованный дочерним процессом) и включено Настройки → Сеть → Локальные сети — напрямую (включено по умолчанию), 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) так не пропускаются. Правила с адресом, подсетью или сервисом и правила с другим действием этот шаг не трогает. - Если кандидатов нет: соединение с этим же 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-адресу: так делают некоторые мессенджеры и игры,
ssh 203.0.113.10, программы со своим способом узнавать адреса; - соединение идёт по UDP, в том числе QUIC в браузерах: чаще всего имени у него нет.
Тогда правила по имени и сервисы к соединению не подходят. Оно идёт по правилам с IP-адресом или подсетью и по маршруту приложения. Исключение — сервисы, в которых есть подсети: их соединения узнаются и по IP. Подробнее — в разделе Ограничения.
Пример: часть сайта в браузере идёт мимо прокси
Браузер идёт Напрямую или его нет в списке, а сервис GitHub — Через прокси. Страницы открываются через прокси: обычный HTTPS идёт по TCP и несёт имя. А часть запросов браузер часто шлёт по QUIC — это UDP на порт 443, обычно без имени. Такое соединение идёт по маршруту браузера, то есть напрямую.
Решение — заблокировать браузеру QUIC:
- В разделе Правила нажмите ⌘N.
- Приложение: Изменить → выберите браузер.
- Назначение оставьте пустым. Порт:
443. Протокол: UDP. Действие: Блокировать. - Нажмите Сохранить.
Браузер перейдёт на обычный HTTPS по TCP. Такое соединение несёт имя и идёт по правилу сервиса, через прокси. Сайты продолжают работать. Подробный рецепт — Один сервис в браузере через прокси.
Если сам браузер идёт Через прокси, такое правило не нужно: его UDP и так блокирует переключатель прокси Блокировать UDP и QUIC.
Соединения без имени Монитор показывает только с IP-адресом, см. Монитор.
Список правил
Переключатель на панели инструментов выбирает, какие правила видны:
- Мои (так открывается раздел) — правила, которые создали вы: вручную, ответом в окне вопроса, а также правила На проверку.
- Системные — правила, которые Routekeeper создал сам: для программ Apple, для приложений, установленных до него, и встроенные правила для localhost.
- Все — и те и другие.
Под заголовком окна — сколько правил каждого вида, например «Мои: 9 · системные: 372». Если поиск ничего не нашёл среди своих правил, а среди системных нашёл, появится кнопка Искать во всех.
Столбцы
- Приложение — приложение или Все приложения.
- Назначение — адрес, «Любой адрес» или сервис с пометкой «сервис», например «сервис GitHub»; после двоеточия — порт, после точки — протокол. Ниже — заметка.
- Действие — маршрут: имя прокси (например, «Амстердам»), «Напрямую», «Блокировать» или «Спрашивать». У временного правила из окна вопроса рядом написано, до какого момента оно действует: «до выхода» (удалится, когда приложение завершит работу) или «до 14:30».
- Срок — Навсегда, До выхода или дата. Столбец скрыт; показать его можно, щёлкнув правой кнопкой по заголовку таблицы.
- Источник — откуда правило, см. ниже.
- Вкл. — переключатель. Выключенное правило не действует: соединения идут по остальным правилам и по режиму.
Щелчок по заголовку столбца сортирует список. Поиск на панели инструментов ищет по приложению, адресу и заметке.
Источники
| Источник | Откуда правило |
|---|---|
| Вручную | Вы создали его сами: в окне правила, в Приложениях, добавив сервис, или из Монитора. |
| Из окна-вопроса | Ваш ответ в окне вопроса со сроком «Пока процесс работает» или Навсегда. Ответ со сроком Один раз правила не создаёт. См. Спрашивать. |
| Apple | Режим Спрашивать сам разрешил программу Apple. |
| Установлено ранее | Режим Спрашивать сам разрешил приложение, установленное до Routekeeper. |
| На проверку | Routekeeper пропустил соединение без вопроса и оставил правило, чтобы вы его проверили. Так бывает в режиме Спрашивать, когда ответить было некому (приложение Routekeeper не было запущено), и в режиме Тихий с настройкой Создавать правила «на проверку». |
| По умолчанию | Встроенные правила, см. ниже. |
Правила Apple, Установлено ранее и По умолчанию — системные: они видны в Системные и Все. Остальные — в Мои. Чтобы разобрать правила На проверку, щёлкните заголовок столбца Источник, чтобы они встали рядом, откройте правило двойным щелчком, выберите действие и нажмите Сохранить. Или выделите несколько и задайте действие через контекстное меню. После этого источник станет Вручную.
Действия со списком
- Двойной щелчок открывает правило.
- Контекстное меню: Изменить…, Дублировать, Действие, Включить или Выключить, Удалить. Можно выделить несколько правил и изменить их разом.
- Delete удаляет выделенные правила без вопроса.
- ⌘Z (Правка → Отменить) отменяет последнее изменение: новое правило, правку, включение и выключение, удаление, перевод на другой прокси. Удаление прокси и импорт не отменяются, а история отмены после них очищается.
- ⌘N — новое правило.
Встроенные правила
Три правила с источником По умолчанию есть с первого запуска. Они системные, поэтому в Мои их не видно:
- Все приложения ·
127.0.0.0/8→ Напрямую и Все приложения ·::1/128→ Напрямую, заметка «Loopback». Соединения с этим же Mac (loopback) никогда не уходят в прокси: локальные серверы разработки, локальный клиент прокси. - Routekeeper → Напрямую, заметка «Само приложение (проверка прокси)». Собственные соединения Routekeeper, например проверка обновлений и загрузка списков сервисов, идут напрямую. В версии 0.2.1 это правило называется AppProxy.
Не удаляйте и не выключайте встроенные правила. Без первых двух приложение с маршрутом через прокси отправит в прокси и свои соединения с этим же Mac: маршрут приложения важнее настройки Не трогать localhost, которая действует, только когда не подошло ни одно правило.
Ещё два исключения работают вне списка: соединения на адрес и порт самих прокси всегда идут напрямую, а проверку прокси выполняет сетевое расширение, и правила на неё не действуют.
Импорт и экспорт
Экспорт
- В разделе Правила нажмите Импорт и экспорт на панели инструментов и выберите Экспортировать…. Из любого раздела: Файл → Экспортировать правила….
- Выберите, куда сохранить файл. По умолчанию он называется
Routekeeper-rules.json.
В файл попадают все правила, включая встроенные, и все прокси: адреса серверов, порты и логины. Пароли прокси в файл не попадают. Настройки (режим, вкладки Настройки) тоже не сохраняются. Храните файл как личный: в нём адреса ваших прокси и логины.
Импорт
- Импорт и экспорт → Импортировать… или Файл → Импортировать правила…. Выберите файл.
- Routekeeper спросит: Заменить все правила и прокси? и покажет, сколько правил и прокси сейчас и сколько в файле.
- Нажмите Заменить.
- Откройте раздел Прокси, впишите пароли у прокси с логином и нажмите Проверить.
Импорт заменяет, а не добавляет. Все текущие правила и прокси удаляются, на их место встают правила и прокси из файла. Отменить это нельзя, ⌘Z не поможет. Перед импортом экспортируйте текущие правила, чтобы осталась копия.
- Если импортировать файл, выгруженный на этом же Mac, у прокси, которые никуда не делись, сохранённые пароли останутся.
- Правила, которые ссылаются на прокси, которого нет в файле, после импорта выключены.
- Если файл не читается, Routekeeper ответит «Не удалось прочитать файл правил».
Перенос на другой Mac: экспортируйте правила, перенесите файл, импортируйте его на другом Mac и впишите пароли прокси. Приложения с подписью разработчика узнаются и там. Программы без подписи узнаются по пути к файлу, поэтому если на другом Mac они лежат в другом месте, добавьте их заново, см. Программы командной строки.
Сверено с кодом Routekeeper (версия 0.2.1 и следующая за ней) 4 октября 2026 года.