Все разделы документации
У Routekeeper нет своих серверов. Трафик приложений он отправляет на прокси, который укажете вы: свой сервер, клиент другой программы на этом Mac, рабочий прокси или прокси от провайдера.
Приложение → Routekeeper → прокси → сайт
Своего прокси нет? Routekeeper поставит его на арендованный сервер сам: нужны только IP и пароль от сервера. Как — в разделе Свой прокси-сервер.
Какой тип выбрать
Routekeeper работает с прокси трёх типов. Тип определяет, как Routekeeper договаривается с сервером. Приложения разницы не замечают.
| Тип | Порт по умолчанию | Когда выбирать | Что важно знать |
|---|---|---|---|
| SOCKS5 | 1080 | Клиент sing-box, Xray или Clash на этом Mac. Прокси от провайдера со строкой вида socks5://…. | Соединение с прокси не шифруется: логин, пароль и имена сайтов видны по пути. |
| HTTP | 8080 | Рабочий прокси в офисе. Прокси со строкой вида http://…. | Соединение с прокси не шифруется. Вход только по логину и паролю. |
| HTTPS | 443 | Свой сервер, поднятый по инструкции. Прокси со строкой вида https://…. | Соединение с прокси зашифровано TLS. В поле Сервер нужно доменное имя. |
Как выбрать:
- Есть строка прокси от провайдера или из скрипта установки сервера — просто вставьте её, тип определится сам.
- Свой сервер по нашей инструкции — HTTPS.
- Клиент на этом Mac — SOCKS5, сервер
127.0.0.1. Подробнее — в разделе Локальный клиент. - Прокси на работе — HTTP, или HTTPS, если так сказали в IT-отделе. Подробнее — в разделе Рабочий прокси.
- Удалённый сервер и выбор есть — берите HTTPS. Через SOCKS5 и HTTP по интернету тоже работает, но логин, пароль и имена сайтов идут открытым текстом. Содержимое сайтов по HTTPS остаётся зашифрованным в любом случае.
Другие протоколы, например Shadowsocks или VLESS, Routekeeper напрямую не поддерживает. Если ваш сервер работает по такому протоколу, запустите на Mac его клиент и подключите Routekeeper к локальному порту клиента, как описано ниже.
Подробнее: как Routekeeper говорит с прокси каждого типа
- SOCKS5 — по RFC 1928, вход по логину и паролю — по RFC 1929. Используется только команда CONNECT, то есть только TCP. UDP ASSOCIATE Routekeeper не использует, поэтому UDP через SOCKS5 не идёт, даже если клиент его умеет.
- HTTP — для каждого соединения открывается туннель методом CONNECT, в том числе к порту 80. Логин и пароль передаются в заголовке
Proxy-Authorization: Basic. - HTTPS — тот же CONNECT внутри TLS 1.2 или новее, ALPN
http/1.1. Сертификат сервера проверяется по доверенным корневым сертификатам macOS и по имени из поля Сервер. Самоподписанный сертификат не пройдёт проверку. - На установку туннеля (TCP, TLS и договорённость с прокси) отводится 15 секунд, при проверке — 10 секунд. Открытые туннели проверяются TCP keepalive: после 30 секунд тишины три пробы раз в 10 секунд. Туннель, у которого пропал сервер, закрывается примерно через минуту.
Как добавить прокси
Быстрее всего — вставить строку прокси. Если строки нет, заполните поля вручную.
- В окне Routekeeper откройте раздел Прокси (⌘4).
- Нажмите + под списком прокси или кнопку + (Добавить прокси) на панели инструментов — там только значок. Из любого раздела то же делает ⌥⌘N. Справа откроются пустые поля. У кнопки на панели есть меню (стрелка рядом со значком): Прокси по адресу…, Вставить из буфера обмена и Свой сервер….
- Заполните поля по таблице ниже. Если прокси ещё нет, а есть арендованный сервер, вместо этого выберите Свой сервер… в меню кнопки Добавить прокси: Routekeeper поставит прокси на сервер и добавит его сам, см. Свой прокси-сервер.
- Нажмите Проверить. Проверять можно до сохранения: Routekeeper возьмёт то, что вписано в поля. Что означает результат, написано в разделе Проверка.
- Нажмите Добавить. Прокси появится в списке слева, и Routekeeper сразу проверит его ещё раз.
- Вставить ссылку открывает новый прокси из строки в буфере обмена, например
https://user:pass@nl.example.net:443. В списке то же делает ⌘V. Кнопка + открывает пустые поля, − удаляет выбранный прокси. - У HTTPS-прокси в поле Сервер нужно доменное имя, а не IP-адрес: по нему проверяется сертификат. Подсказка под полями появляется только у типа HTTPS. Поле IP-адрес сервера необязательное: «?» рядом объясняет, что Routekeeper находит адрес сам.
- DNS через прокси: имя сайта получает прокси и сам узнаёт его адрес. Включено по умолчанию. Пояснение — под «?».
- Блокировать UDP и QUIC: UDP приложений этого прокси блокируется, а не уходит мимо прокси. Включено по умолчанию. Пояснение — под «?».
- Проверить открывает соединение через прокси и показывает время, IP-адрес, который видят сайты, и код страны. Проверять можно до сохранения.
- Скопировать ссылку копирует строку прокси с логином и паролем, чтобы отправить её другому человеку. Сохранить становится доступной, когда поля изменены, и тогда рядом появляется Отменить изменения.
При первом запуске то же самое есть на приветственном экране: шаг Добавить прокси-сервер, кнопки Вставить из буфера и Ввести вручную….
| Поле | Что вписать |
|---|---|
| Название | Любое имя, которое вы увидите в меню маршрутов: «Амстердам», «Офис». Если оставить поле пустым, названием станет адрес сервера. |
| Тип | SOCKS5, HTTP или HTTPS. Как выбрать — выше. |
| Сервер | Доменное имя вроде proxy.example.net или IP-адрес вроде 203.0.113.10; IPv6 тоже можно. Без https:// и без порта. Для HTTPS — только доменное имя: по нему проверяется сертификат. |
| IP-адрес сервера | Необязательно, обычно оставляйте пустым. Routekeeper сам находит адрес сервера, даже когда DNS вашей сети его не отдаёт. Впишите IP, только если не получается и так: например, прокси не работает с сообщением «Не удалось узнать адрес сервера». Мастер своего сервера заполняет поле сам. Подробнее — «Как Routekeeper находит адрес сервера». |
| Порт | Порт прокси, число от 1 до 65535. Если оставить поле пустым, Routekeeper возьмёт порт по умолчанию для типа: 1080, 8080 или 443. Подсказка в поле показывает, какой именно. |
| Логин | Если прокси пускает без пароля, оставьте пустым. |
| Пароль | Сохраняется только вместе с логином. |
| DNS через прокси | Включено по умолчанию, обычно не трогайте. Что делает — в разделе ниже. |
| Блокировать UDP и QUIC | Включено по умолчанию, обычно не трогайте. |
Чтобы изменить прокси, выберите его в списке, поправьте поля и нажмите Сохранить. Пока ничего не изменено, кнопка Сохранить неактивна. После правки рядом появляется Отменить изменения: она возвращает сохранённые значения. Строка Используется в правилах: N под кнопкой Проверить показывает, сколько маршрутов и правил идут через этот прокси.
Подробнее: где хранится пароль
Пароль хранит сетевое расширение Routekeeper в своём файле настроек. Этот файл может прочитать только система (root). Окно Routekeeper сохранённый пароль не получает: в поле Пароль вместо него точки, а проверку прокси выполняет само расширение. Единственное исключение — кнопка Скопировать ссылку: по ней расширение отдаёт пароль, чтобы положить ссылку в буфер обмена. Если поле не трогать, при сохранении пароль остаётся прежним. Если очистить Логин, пароль удалится.
Вставить строку прокси
Провайдеры и скрипт установки сервера выдают прокси одной строкой. Routekeeper разбирает её сам.
- Скопируйте строку прокси (⌘C).
- Вставьте её в Routekeeper:
- Раздел Прокси: щёлкните по списку прокси слева и нажмите ⌘V, нажмите Вставить ссылку под списком или выберите Вставить из буфера обмена в меню кнопки Добавить прокси.
- Приветственный экран: на шаге Добавить прокси-сервер нажмите Вставить из буфера.
- Откроется новый прокси с заполненными полями. Проверьте тип, сервер, порт и логин, нажмите Проверить, затем Добавить. Пока вы не нажали Добавить, ничего не сохраняется.
Какие строки понимает Routekeeper:
| Строка | Тип | Логин и пароль |
|---|---|---|
socks5://user:pass@203.0.113.10:1080 | SOCKS5 | user и pass |
socks5h://203.0.113.10:1080, socks://203.0.113.10:1080 | SOCKS5 | нет |
http://proxy.corp.example:3128 | HTTP | нет |
https://user:pass@proxy.example.net:443 | HTTPS | user и pass |
203.0.113.10:1080 | SOCKS5 | нет |
203.0.113.10:1080:user:pass | SOCKS5 | user и pass |
user:pass@203.0.113.10:1080 | SOCKS5 | user и pass |
socks5://[2001:db8::1]:1080 | SOCKS5, адрес IPv6 в квадратных скобках | нет |
- Порт обязателен, даже в строке
https://. Строкаhttps://proxy.example.netбез:443не распознается. - Без приставки (
socks5://,http://,https://) получится SOCKS5. Если провайдер дал строкуадрес:портдля HTTP-прокси, после вставки смените Тип на HTTP. - Особые символы в логине и пароле можно записать в виде
%40вместо@или%3Aвместо:. Routekeeper раскодирует их. - Пробелы и переносы строк по краям и косая черта в конце не мешают.
- Название вставленного прокси — то, что после
#в конце строки (так его записывает ссылка из Routekeeper), а если его нет — адрес сервера. Название можно поменять в поле Название.
Если в буфере обмена не строка прокси, Routekeeper ответит: «В буфере обмена нет строки прокси. Ожидается, например, socks5://user:pass@host:1080». Пункт Скопировать адрес в контекстном меню прокси копирует только адрес:порт, без логина и пароля. Строку целиком копирует Скопировать ссылку.
Подробнее: socks5 и socks5h
В других программах буква h в socks5h:// значит «имена сайтов узнаёт прокси». В Routekeeper обе приставки дают одинаковый SOCKS5. Будет ли прокси получать имена, решает переключатель DNS через прокси, и у вставленного прокси он включён.
Поделиться прокси
Чтобы отправить прокси другому человеку или перенести на другой Mac, скопируйте его одной ссылкой:
- Выберите прокси в списке и нажмите Скопировать ссылку под полями. Или щёлкните прокси в списке правой кнопкой и выберите Скопировать ссылку с паролем.
- Вставьте ссылку в сообщение. Она выглядит так:
https://логин:пароль@proxy.example.net:443#Франкфурт. - Получатель вставляет её в Routekeeper: тип, сервер, порт, логин, пароль и название заполнятся сами. Другие программы обычно тоже понимают такую строку, название после
#они пропускают.
- В ссылке настоящий пароль. Отправляйте её только тем, кому доверяете, и лучше в личном сообщении, а не в общем чате. Кто получил ссылку, может пользоваться прокси, пока вы не смените пароль.
- Копируется то, что видно в полях, вместе с несохранёнными правками. Если поле Пароль не трогали, в ссылку попадёт сохранённый пароль.
- Особые символы в логине, пароле и названии записываются кодами вроде
%40, Routekeeper при вставке их раскодирует. Менеджеры буфера обмена, которые соблюдают пометку «скрытое содержимое», ссылку в историю не сохраняют. - Если связи с сетевым расширением нет, ссылка не скопируется: сохранённый пароль хранится только в нём.
DNS через прокси и блокировка UDP
У каждого прокси два переключателя: DNS через прокси и Блокировать UDP и QUIC. Оба включены по умолчанию, в том числе у вставленного прокси. Они действуют на соединения, которые идут через этот прокси.
DNS через прокси
Когда приложение открывает сайт по имени, Routekeeper передаёт прокси имя, например example.com, а не IP-адрес, который нашёл ваш Mac. Адрес сайта прокси узнаёт сам, через свой DNS.
Так сайт открывается по адресу, который подходит для местоположения сервера: крупные сайты отдают разные адреса в разных странах. И если DNS вашей сети ответил неверным адресом, прокси всё равно найдёт правильный.
Работает это, только когда имя известно. Если приложение само подключается к IP-адресу, прокси получает IP. Подробнее о соединениях без имени — в разделе Правила.
Когда выключать. Если нужные имена знает только DNS вашей локальной или рабочей сети, а прокси находится за её пределами. Например, внутренние сайты компании, которые открываются только из офисной сети: удалённый прокси их не найдёт. С выключенным переключателем Routekeeper передаёт прокси адрес, который нашёл ваш Mac. В остальных случаях держите переключатель включённым.
Подробнее: что видит DNS вашей сети
Соединение попадает в Routekeeper, когда приложение уже знает адрес сервера. Если имя узнавала сама macOS, её запрос ушёл в DNS вашей сети раньше, чем Routekeeper увидел соединение. Переключатель решает, по какому адресу прокси откроет сайт, но этот запрос не отменяет. Как устроен DNS в Routekeeper и как браузер может узнавать имена по защищённому каналу, рассказано в разделах Как это работает и DNS через HTTPS в браузере.
Адреса сайтов через прокси
DNS через прокси помогает, когда приложение подключается к сайту через прокси по имени. Но многие приложения сначала сами спрашивают адрес сайта у DNS вашей сети. Если сеть этого имени не знает или отвечает «такого имени нет», приложение так и не подключится, хотя идёт через прокси. Так бывает с корпоративным VPN, который знает только свои сайты, или с провайдером, который фильтрует DNS.
Для этого есть переключатель Настройки → Сеть → Узнавать адреса сайтов через прокси, по умолчанию включён. С ним DNS-запросы приложений, которые идут через прокси, отправляются через этот прокси публичному DNS (Cloudflare, при отказе Google), а не DNS сети. Остальные приложения и имена, которые по правилам идут напрямую, спрашивают DNS сети как раньше.
- Локальные имена остаются у DNS сети: имена без точки,
.local,.lan,.home,.internal,.corpи другие такие, домены VPN и локальной сети, а также домены из файлов/etc/resolver. Поэтому внутренние сайты компании находятся по внутренним адресам. - Если публичный DNS ответил «такого имени нет», Routekeeper переспрашивает DNS сети: имя может быть внутренним.
- Если прокси недоступен, приложение получает ошибку DNS. С Если прокси недоступен — пускать напрямую запрос уходит в DNS сети.
- Переключатель действует для прокси, у которых включено DNS через прокси.
Когда не сработает. Если macOS узнаёт адреса по шифрованному DNS, например стоит профиль DNS через HTTPS или сеть сама предлагает шифрованный DNS, обычных DNS-запросов нет, и переключатель ничего не меняет. Ещё macOS хранит общий кэш ответов: если другое приложение, которое идёт напрямую, недавно получило от сети «такого имени нет», этот ответ может достаться и приложению через прокси. Как устроен DNS — в разделе Как это работает.
Блокировать UDP и QUIC
SOCKS5, HTTP и HTTPS-прокси передают только TCP. UDP — другой вид трафика: на нём работают QUIC в браузерах, голосовые и видеозвонки, игры. Через прокси UDP пройти не может.
- Переключатель включён (по умолчанию). UDP-соединения приложений, которые идут через этот прокси, блокируются. Браузеры в ответ переходят на обычный HTTPS по TCP, и он идёт через прокси. Сайты открываются как обычно.
- Переключатель выключен. UDP этих приложений уходит напрямую, мимо прокси, с вашим настоящим IP. Каждое такое соединение отмечается в разделе Мимо прокси (в версии 0.2.1 — Утечки) как UDP мимо прокси.
DNS-запросы (порты 53 и 853) переключатель не блокирует: без них приложения перестали бы работать. Такие запросы идут напрямую и отмечаются в Мимо прокси как DNS мимо прокси.
Когда выключать. Когда важнее, чтобы работали звонки, чем чтобы они шли через прокси. Например, мессенджер идёт через прокси, а звонки в нём используют UDP: с блокировкой они не соединятся вовсе, без неё пойдут напрямую. Переключатель действует на все приложения этого прокси. Чтобы не трогать остальные, добавьте тот же сервер ещё раз под другим названием, выключите блокировку только у этой копии и выберите её маршрутом для мессенджера. Через прокси звонки по UDP не работают в любом случае, см. Ограничения.
Подробнее: когда срабатывает переключатель
Переключатель проверяется для UDP-соединения, которое по правилам должно идти через этот прокси: по маршруту приложения, по сервису или по правилу. Соединения на порты 53 и 853 пропускаются напрямую с отметкой «DNS мимо прокси», если раньше их не заблокировало отдельное правило. Остальной UDP блокируется или, при выключенном переключателе, пропускается напрямую с отметкой. UDP приложений, которые через прокси не идут, переключатель не касается. Например, QUIC браузера без имени сайта идёт по маршруту самого браузера, см. Правила по именам сайтов.
Проверка
Кнопка Проверить открывает через прокси соединение со службой ipinfo.io и спрашивает, какой IP-адрес она видит. Если ipinfo.io не отвечает или отказывает, а так бывает с адресами некоторых хостингов, Routekeeper спрашивает Cloudflare, затем ipify. Через пару секунд рядом появится результат, например:
Работает · 640 мс · IP 203.0.113.10 (NL)
- IP — адрес, который видят сайты. Если он совпадает с адресом вашего сервера, прокси работает.
- Код страны в скобках — где этот адрес зарегистрирован по данным службы, которая ответила.
- IP ? — службы ответили через прокси, но адрес не назвали. Прокси работает.
- Миллисекунды — время, за которое открывается новое соединение через прокси. Это несколько обменов с сервером, поэтому далёкий исправный сервер показывает 500–800 мс. В Обзоре время от 1500 мс помечается словом «медленно».
В списке прокси слева у каждого прокси цветная точка и короткая строка: зелёная — работает (SOCKS5 · 640 мс · NL), красная — недоступен, синяя — проверяем…, серая — не проверен.
Нажимать Проверить каждый раз не нужно. Routekeeper проверяет прокси сам: после сохранения; при открытии раздела Прокси, если прокси ещё не проверялся; при открытии меню значка в строке меню и после смены сети — основной прокси. Пока основной прокси не отвечает, он перепроверяется раз в минуту. Проверить все прокси сразу — кнопка Проверить все на панели инструментов.
История задержки
Над настройками выбранного прокси — график задержки за последний час, сутки, 7 или 30 дней. Routekeeper записывает время каждого соединения через прокси и каждой проверки. Отдельных замеров он не делает и лишнего трафика не тратит, поэтому за время, когда через прокси ничего не шло, данных нет и линия прерывается.
- Линия — обычная задержка в этот момент: половина соединений открылась быстрее. Полоса вокруг неё — как открывались 80 % соединений, без самых быстрых и самых медленных. Широкая полоса значит, что задержка скачет.
- Красные полосы — время, когда прокси не открывал соединения: не ответил, оборвал соединение или не принял пароль. Чем больше таких соединений, тем ярче полоса. Если прокси открыл соединение, а сайт за ним не ответил, это не сбой прокси и сюда не попадает.
- Пунктир «медленно» — 1500 мс, тот же порог, что и в Обзоре.
Наведите указатель на график, чтобы увидеть время, задержку и сколько соединений было в этот момент. Под графиком — итог за период: Обычно, Разброс, доля соединений Без ошибок и число Соединений.
История хранится 30 дней. Если поменять у прокси сервер, порт или тип, история начнётся заново: это уже другой сервер. Смена логина или пароля историю не сбрасывает.
Сообщения об ошибках
Если проверка не прошла, вместо результата появится сообщение. Те же сообщения показывает Монитор у соединений, которые не удалось провести через прокси.
| Сообщение | Что значит | Что сделать |
|---|---|---|
| Прокси не ответил вовремя | Прокси не ответил за 10 секунд при проверке или за 15 секунд у соединения приложения. Соединение приложения за это время делает до трёх попыток: если прежняя зависла, новая начинается через 1,5 и через 4 секунды. | Проверьте сервер и порт. Убедитесь, что сервер включён и порт не закрыт файрволом на нём. |
| Не удалось подключиться к прокси: … | macOS не смогла соединиться с сервером. После двоеточия — причина от macOS, часто по-английски. Connection refused значит, что на этом порту ничего не запущено. | Проверьте Сервер и Порт. Проверьте, что Mac в сети. |
| Не удалось подключиться к прокси: TLS: сертификат прокси не прошёл проверку | HTTPS: сертификат сервера не подходит. | В поле Сервер должно быть доменное имя, на которое выпущен сертификат, а не IP. Сертификат не должен быть просрочен или самоподписан. |
| Не удалось подключиться к прокси: TLS: ошибка TLS (число) | Не удалось установить зашифрованное соединение. | Чаще всего выбран тип HTTPS, а сервер на этом порту TLS не использует. Попробуйте HTTP или SOCKS5. |
| Прокси закрыл соединение | Сервер оборвал соединение посреди договорённости. | Часто это не тот тип прокси, например HTTP вместо SOCKS5, или не тот порт. |
| Ошибка протокола прокси: … | Сервер ответил не так, как отвечает прокси выбранного типа. | Проверьте Тип и Порт. Если после двоеточия «не удалось прочитать ответ сервиса проверки IP», ни одна служба проверки не ответила понятно. Повторите проверку позже. |
| Сервер … не найден: такого имени нет в DNS | Имени из поля Сервер не существует: так ответили и DNS сети, и DNS по HTTPS. | Проверьте Сервер: нет ли опечатки, не истёк ли домен. Для домена DuckDNS — что он не удалён. |
| Не удалось узнать адрес сервера …: DNS этой сети его не находит, а DNS через HTTPS недоступен | DNS вашей сети не отдаёт адрес сервера, а DNS по HTTPS из этой сети недоступен, и запомненного адреса нет. | Впишите IP-адрес сервера в карточке прокси, см. ниже. |
| SOCKS5: прокси требует логин и пароль | Логин не указан. | Впишите логин и пароль. |
| SOCKS5: неверный логин или пароль | Прокси не принял логин или пароль. | Скопируйте их заново, без пробелов по краям. |
| SOCKS5: прокси не принял ни один способ авторизации | Прокси не согласился ни на вход без пароля, ни на вход по логину и паролю. | Если логин не указан, укажите. Если указан, прокси требует способ входа, которого Routekeeper не поддерживает. |
| SOCKS5: соединение запрещено правилами прокси, SOCKS5: хост недоступен и другие ответы после «SOCKS5:» | Вход прошёл, но прокси не открыл соединение со службой проверки. | Прокси может запрещать некоторые адреса или порты. Проверка идёт на порт 80. |
| HTTP: прокси требует авторизацию (407) | Нет логина или пароля, они неверны, или прокси требует вход Windows (NTLM, Kerberos). | Проверьте логин и пароль. Routekeeper поддерживает только вход по логину и паролю, см. Рабочий прокси. |
| HTTP-прокси ответил 403 Forbidden и другие коды | Прокси отказал в соединении. | Офисные прокси часто разрешают туннели только на порт 443, а проверка идёт на порт 80. Тогда сайты по HTTPS работать будут, хотя проверка не проходит. |
| Нет связи с сетевым расширением | Проверку выполняет сетевое расширение, а оно не отвечает. | См. Переустановить и остановить расширение. |
Остальные сообщения Routekeeper и что с ними делать — в разделе Если не работает.
Как Routekeeper находит адрес сервера
Если в поле Сервер имя, Routekeeper должен узнать адрес сервера. Некоторые сети его не отдают: корпоративный VPN не знает внешних имён, провайдер фильтрует DNS. Поэтому Routekeeper спрашивает адрес через DNS по HTTPS у Cloudflare, Google, AdGuard и Control D, обращаясь к ним по IP, так что DNS сети для этого не нужен. Найденный адрес запоминается: следующее подключение начинается сразу, а свежий адрес узнаётся в фоне. Если и DNS по HTTPS недоступен, Routekeeper спрашивает DNS сети, как раньше.
Если в этой сети не работает ничего из этого, впишите IP-адрес сервера. Сертификат HTTPS-прокси при этом проверяется по имени из поля Сервер, поэтому имя оставьте как есть.
Прокси на своём сервере
Прокси, который Routekeeper поставил мастером Свой сервер…, получает внизу карточки блок Сервер. Routekeeper входит на сервер по своему ключу из связки ключей, делает одно действие и выходит.
- Работает ли Caddy с прокси на сервере. Если остановлен, нажмите Переустановить.
- Сколько адресов сейчас заблокировал fail2ban за подбор пароля к SSH.
- Проверить сервер заходит на сервер и обновляет эти строки. Routekeeper делает это и сам, когда открывается карточка, если последней проверке больше шести часов.
- Запускает установку ещё раз с тем же доменом. Если в новой версии Routekeeper установка новее, кнопка называется Обновить сервер, а выше появляется строка Есть обновление установки на сервере. Логин и пароль прокси не меняются.
- В меню: Сменить пароль прокси…, Закрыть вход на сервер по паролю…, Сохранить ключ SSH…, Удалить прокси с сервера… и Забыть сервер….
| Кнопка | Что делает |
|---|---|
| Проверить сервер | Узнаёт, работает ли прокси на сервере, до какого числа действует сертификат и сколько адресов не пускает fail2ban. Сертификат Caddy продлевает сам, за месяц до срока. |
| Переустановить или Обновить сервер | Запускает установку ещё раз с тем же доменом. Так чинят остановленный прокси и обновляют Caddy и настройки до версии из этого Routekeeper. Логин и пароль не меняются. |
| Ещё → Сменить пароль прокси… | Создаёт на сервере новые логин и пароль и сразу сохраняет их в этом прокси. Маршруты и правила остаются на нём. Если этот прокси настроен ещё где-то, там старый пароль перестанет подходить. |
| Ещё → Закрыть вход на сервер по паролю… | Сервер начинает пускать по SSH только по ключу. Подробнее — в разделе Вход на сервер по паролю. |
| Ещё → Сохранить ключ SSH… | Сохраняет в файл закрытый ключ, которым Routekeeper входит на сервер. С ним можно войти на сервер из Терминала: ssh -i файл root@IP. |
| Ещё → Удалить прокси с сервера… | Удаляет на сервере Caddy, сертификат, логин и пароль. Сервер и остальное на нём остаются. В диалоге можно удалить прокси и в Routekeeper или оставить его. |
| Ещё → Забыть сервер… | Routekeeper удаляет ключ этого сервера и перестаёт им управлять. Прокси на сервере и в Routekeeper продолжает работать, блок Сервер исчезает. |
Если блок показывает ошибку, ссылка Что с этим делать под ней ведёт в нужный раздел страницы Свой прокси-сервер.
Если вход на сервер по паролю закрыт, ключ Routekeeper может быть единственным, с которым сервер пускает. Забыть сервер… и удаление прокси удаляют этот ключ из связки ключей, поэтому сначала сохраните его: Ещё → Сохранить ключ SSH….
Несколько прокси
Прокси можно добавить сколько угодно. Каждое приложение, сервис и правило выбирает свой: в меню маршрута есть раздел Через прокси со всеми прокси по названию. Например, браузер идёт через «Амстердам», а рабочий мессенджер — через «Офис». Как выбрать маршрут, описано в разделе Приложения.
Если у двух прокси одинаковые названия, в меню к ним добавляются тип и порт. Понятнее дать им разные названия.
Основной прокси
Основной — прокси, через который идёт больше всего включённых маршрутов и правил. Если таких нет, основным считается первый в списке. Основной прокси:
- показан в панели внизу боковой колонки окна, со временем отклика и страной, и в меню значка в строке меню, с внешним IP и страной;
- становится маршрутом новых приложений и сервисов;
- предлагается в быстрых действиях Монитора.
Число вида «+1» рядом с ним в боковой колонке значит, что часть правил идёт через другие прокси.
Удаление прокси
Выберите прокси в списке и нажмите − под списком или клавишу Delete. Ещё можно щёлкнуть по прокси правой кнопкой и выбрать Удалить…. Routekeeper спросит подтверждение и скажет, сколько правил идёт через этот прокси. Удаление отменить нельзя: ⌘Z его не вернёт, логин и пароль удаляются вместе с прокси.
Маршруты и правила, которые шли через удалённый прокси, выключаются.
Если прокси поставил мастер Свой сервер…, в диалоге две кнопки: Удалить и с сервера снимает прокси с сервера и затем удаляет его в Routekeeper, Удалить только из Routekeeper оставляет прокси на сервере работать, а Routekeeper забывает сервер и его ключ.
Выключенное правило не действует. Приложения, которые шли через удалённый прокси, пойдут по остальным правилам и по режиму. В режиме Только прокси это значит напрямую, с вашим настоящим IP, и в Мимо прокси такие соединения не попадут. Поэтому сначала переведите маршруты на другой прокси, а потом удаляйте.
Перевод на другой прокси
Когда прокси перестал работать или вы переезжаете на другой сервер, маршруты можно перевести разом, не меняя каждое приложение. Для этого нужно хотя бы два прокси.
| Где | Что переводится |
|---|---|
| Обзор → Маршруты → кнопка ⋯ в строке прокси → Перевести маршруты на | Только маршруты и правила этого прокси. |
| Обзор → строка прокси, который не отвечает → Перевести на «…» | Только маршруты и правила этого прокси. Routekeeper предлагает прокси, который ответил при последней проверке. |
| Панель внизу боковой колонки → строка Прокси → Перевести все приложения на | Все включённые маршруты и правила, которые идут через любой прокси. |
| Меню значка в строке меню → Прокси для всех приложений | То же, что в боковой колонке. Список появляется в меню, только когда прокси два или больше. |
- Выберите прокси, на который переводить.
- Routekeeper спросит: Перевести на «…»? В вопросе написано, что переедет и откуда. Если правила шли через разные прокси, Routekeeper предупредит, что разделение пропадёт. Если выбранный прокси не ответил при последней проверке, тоже предупредит. Нажмите Перевести. В меню строки меню вопрос появляется прямо в меню.
- После перевода на 10 секунд появится строка вида «5 правил переведено» и кнопка Отменить: она вернёт переведённые правила на прежние прокси. Позже то же делает ⌘Z в окне Routekeeper.
Переводятся только включённые маршруты и правила с действием Через прокси. Напрямую, Блокировать и выключенные правила остаются как были. Уже открытые соединения остаются на прежнем прокси, пока приложение не переподключится.
Если прокси недоступен
По умолчанию соединения, которые должны идти через прокси, при его отказе обрываются. Приложение покажет ошибку или «нет сети», но напрямую соединения не уходят, и ваш настоящий IP не раскрывается.
Что вы увидите:
- в Обзоре — заголовок «Прокси «…» недоступен», а если другие прокси с маршрутами работают — «Работает частично»;
- в Маршрутах строка прокси станет оранжевой: «Не отвечает» и «Что идёт через этот прокси, сейчас не соединяется. Напрямую оно не уходит.», рядом кнопки Перевести на «…» и Проверить снова;
- в меню значка в строке меню — оранжевая строка «Прокси «…» недоступен», если отказал основной прокси.
Что делать: перевести маршруты на другой прокси, как описано выше, или подождать. Основной прокси перепроверяется раз в минуту. Как только сервер ответит, новые соединения снова пойдут через него.
Если вам важнее, чтобы приложения работали, чем чтобы они шли через прокси, включите Настройки → Сеть → Если прокси недоступен — пускать напрямую. По умолчанию это выключено. С этой настройкой соединение, которое не удалось провести через прокси, идёт напрямую: сайты видят ваш настоящий IP. Монитор покажет такие соединения как прямые, а в Мимо прокси они не попадут. Готовый сценарий — в рецепте Прокси перестал отвечать.
Подробнее: как отказ выглядит для приложения
Routekeeper принимает соединение приложения сразу и одновременно подключается к прокси. Так браузеры не открывают лишних запасных соединений. Если прокси отказал или не ответил за 15 секунд, соединение приложения обрывается. С настройкой «пускать напрямую» Routekeeper в этот момент подключается к адресу сайта сам. Блокировка UDP от состояния прокси не зависит.
Локальный клиент: sing-box, Xray, Clash
Если вы уже пользуетесь клиентом вроде sing-box, Xray, Clash или программой на их основе, Routekeeper может отправлять в него выбранные приложения. Клиент по-прежнему держит связь с вашим сервером по своему протоколу, а Routekeeper решает, какие приложения в него идут.
Приложение → Routekeeper → SOCKS5 127.0.0.1 → клиент → ваш сервер → сайт
- В настройках клиента найдите порт локального прокси. Он может называться SOCKS port, mixed port или inbound, например
1080или7890. - В клиенте выключите системный прокси (System Proxy, Set as system proxy) и режим TUN (TUN mode, Enhanced mode, VPN mode). С системным прокси приложения сами идут в клиент, и Routekeeper ими уже не управляет. TUN перехватывает весь трафик Mac, как VPN, и мешает Routekeeper, см. Ограничения.
- В Routekeeper добавьте прокси: Тип SOCKS5, Сервер
127.0.0.1, Порт — порт клиента. Логин и пароль обычно не нужны. Можно скопировать и вставить строкуsocks5://127.0.0.1:7890, подставив свой порт. - Оба переключателя оставьте включёнными. С DNS через прокси клиент получает имена сайтов и узнаёт адреса по своим настройкам.
- Нажмите Проверить. IP в ответе должен быть адресом вашего сервера, а не вашим домашним.
- Выберите приложения, которые пойдут через клиент: Приложения и сервисы.
Не отправляйте сам клиент через прокси. Его соединение с сервером вернётся к нему же, получится петля, и через этот прокси перестанет работать всё. Если у вас есть правило «Любое приложение · любой адрес → Через прокси», добавьте клиент в Приложения с маршрутом Напрямую: правило для конкретного приложения важнее правила для любого, см. Правила.
В режимах Спрашивать и Блокировать всё клиенту нужно явно разрешить выход к серверу. Добавьте его в Приложения с маршрутом Напрямую или ответьте Разрешить со сроком Навсегда в окне вопроса. Иначе соединение клиента с сервером будет заблокировано или будет ждать ответа, и все приложения на этом прокси останутся без сети. В режимах Только прокси и Тихий с настройками по умолчанию ничего делать не нужно. Подробнее о режимах — Режимы файрвола.
Если клиент выключен или завис, приложения на этом прокси остаются без сети и напрямую не уходят. Готовая пошаговая настройка — в рецепте Поверх sing-box, Xray или Clash.
Подробнее: localhost, UDP и HTTP-порт клиента
- Соединения на адрес и порт любого прокси из списка всегда идут напрямую, правила к ним не применяются. Соединения с
127.0.0.1и::1закрывают встроенные правила, см. Список правил. - Через SOCKS5 Routekeeper передаёт только TCP, даже если клиент умеет UDP. Поэтому переключатель Блокировать UDP и QUIC нужен и здесь.
- Если клиент даёт только HTTP-порт, выберите тип HTTP. Порт mixed принимает и SOCKS5, и HTTP.
Рабочий прокси
В офисе прокси обычно выдаёт IT-отдел: адрес, порт (часто 3128 или 8080) и, может быть, логин и пароль.
- Добавьте прокси: Название «Офис», Тип HTTP, Сервер и Порт от IT-отдела, Логин и Пароль, если нужны. Тип HTTPS выбирайте, только если IT-отдел сказал, что прокси принимает TLS.
- Нажмите Проверить. Если ответ «HTTP-прокси ответил 403 …», прочитайте пункт про порт 80 ниже.
- Решите, что пойдёт через рабочий прокси:
- приложения целиком, например рабочий мессенджер: маршрут «Офис» в разделе Приложения. Адреса локальной сети и подсети VPN такой маршрут оставляет напрямую;
- адреса компании из любых приложений: правило «Любое приложение ·
*.corp.example→ Через прокси «Офис»» в разделе Правила. Для внутренних сетей добавьте правило с подсетью, например10.0.0.0/8. Такое правило важнее маршрута приложения: браузер ходит через ваш обычный прокси, а сайты компании — через офисный.
Ограничения:
- Только вход по логину и паролю (Basic). Вход Windows — NTLM, Kerberos, Negotiate — не поддерживается. Такой прокси ответит «HTTP: прокси требует авторизацию (407)».
- PAC-файлы и автонастройка прокси (WPAD) не поддерживаются. Если компания раздаёт настройки PAC-файлом, откройте его в браузере и найдите строку вида
PROXY proxy.corp.example:3128, или спросите адрес у IT-отдела. Адреса, которые PAC-файл отправляет на прокси, перенесите в правила. - Только туннели. Routekeeper открывает через HTTP-прокси туннель (CONNECT) для любого соединения, в том числе к порту 80. Многие офисные прокси разрешают туннели только на порт 443. Тогда сайты по HTTPS работают, а сайты по HTTP и кнопка Проверить получают «HTTP-прокси ответил 403 …».
- По HTTP логин и пароль передаются открытым текстом. Внутри офисной сети это обычно приемлемо. Через интернет используйте HTTPS-прокси.
Готовый сценарий — в рецепте Рабочий прокси для внутренних адресов.
Сверено с кодом Routekeeper (версия 0.2.1 и следующая за ней) 4 октября 2026 года.