Repository navigation
ru Routing
Режим маршрутизации определяет судьбу большей части трафика. Свои правила задают исключения: какие сайты, приложения, страны или адреса всегда идут через прокси, напрямую или блокируются.
Выбирается на панели подключения, в панели строки меню, в Settings → Routing или через Команды.
| Режим | Трафик, не совпавший ни с одним правилом |
|---|---|
| Global | идёт через сервер |
| Bypass regions | напрямую, если относится к включённому региону (Иран, Китай, Россия), иначе через сервер |
| Rules Only | напрямую; только трафик по правилу Proxy идёт на сервер |
| Direct | напрямую; используются только правила Block |
Settings → Routing → Traffic that matches no rule может переопределить режим: Follow mode (по умолчанию), Proxy, Direct или Block. Это также заменяет собственный запасной маршрут полного конфига.
Для Bypass regions нужен хотя бы один региональный пакет. Включите его в Settings → Routing; V2Mac скачает файлы geosite и geoip, проверит и будет обновлять их (по умолчанию еженедельно, или ежедневно / никогда, плюс Update Now). Иран — Chocolate4U/Iran-v2ray-rules; Китай и Россия — Loyalsoldier/v2ray-rules-dat.

Откройте Rules стеклянной кнопкой внизу боковой панели, через Open Rules… в Settings → Routing, из подключения в Connections или из строки меню. Список слева проверяется сверху, и первое совпавшее правило решает, куда идёт трафик:
-
Before your rules: локальная сеть (этот Mac, LAN и имена вроде
printer.localвсегда идут напрямую), Block QUIC (переключатель) и приложения, использующие прокси-порт (задаётся в Settings → Proxy). - My rules в вашем порядке. Порядок меняется перетаскиванием; у каждого есть переключатель.
- After your rules: собственные правила режима, затем Everything else (по режиму, Proxy, Direct или Block).
Любое изменение — черновик: изменённые правила отмечены точкой, ⌘Z отменяет, Apply (⌘S) сохраняет и один раз перезапускает работающее подключение. При закрытии окна с неприменёнными изменениями сначала будет вопрос.
- Send to: Proxy (сервер, к которому вы подключены), Via сервер или группа (самый быстрый отвечающий сервер группы), Direct или Block.
- Matches any of: приложения, домены, точные имена, ключевые слова, адреса и диапазоны, страны и списки сервисов. Вводите в одно поле и выбирайте из подсказок (установленные приложения, сервисы с размером, страны), вставляйте сразу много строк или нажмите Browse… — список приложений, плитки сервисов и карта мира. Щелчок правой кнопкой по сайту позволяет читать его как точное имя, ключевое слово или регулярное выражение. Щелчок по приложению показывает, с чем оно совпадает на этом Mac.
-
Only when (необязательно): порты (
443,8000-8100), TCP или UDP, протокол (TLS, HTTP, QUIC, BitTorrent) и приложения. Каждый элемент должен также соответствовать этим условиям. Например, правило с*.example.comи «Only when: Safari» совпадает только с трафиком Safari к этому сайту.
Правило только с «Only when» и без элементов совпадает со всем таким трафиком: «UDP, BitTorrent → Direct» отправляет торренты напрямую.
New Rule ▾ начинает с шаблона: сервисы ИИ, инструменты разработчика, сервисы Apple, соцсети и чаты, стриминг, сайты региона напрямую, торренты напрямую, реклама и трекеры.
Via отправляет трафик правила через другой сервер, не тот, к которому вы подключены, например сайты ИИ через сервер в другой стране. Выберите сервер или группу, чтобы использовать её самый быстрый отвечающий сервер (проверка каждые 30 секунд; если он перестаёт отвечать, его место занимает следующий).
Если ни один из его серверов не отвечает, трафик правила по умолчанию не проходит, так что никогда не уходит другим путём. Включите If its servers fail, use the current server, чтобы вместо этого использовать текущий сервер. Правило показывает, сколько серверов отвечает, а строка меню предупреждает, когда не отвечает ни один.
Введите сайт, ссылку, адрес или имя приложения в поле поиска. Над списком V2Mac покажет, куда это идёт и почему, например «api.github.com → Proxy, правилом Developer (#8), совпало: geosite:github», — по вашим правилам в текущем виде, применены они или нет.
Discovered показывает приложения и сайты, замеченные, пока было открыто окно Rules или Connections, и не охваченные ни одним правилом. Добавьте их в правило через Add to, перетащите на правило или нажмите Ignore. Сайт предлагается целым доменом (github.com для api.github.com).
Tidy Up… (в меню ⋯) предлагает объединить правила, делающие одно и то же, удалить правила, уже охваченные более ранними, и убрать повторы. Отметьте нужное; до Apply ничего не меняется.
В Connections щёлкните строку правой кнопкой: Add App to Rule, Add Host to Rule и Show Rule. Панель в строке меню показывает активное приложение, куда идёт его трафик, и Add to Rule. В «Быстрых командах» есть действие Add to Rule.
Приложение указывается как Telegram.app, bundle id (com.example.chat), шаблон (*code*), имя процесса (curl) или полный путь.
- Правила для приложений действуют для приложений, использующих системный прокси или порт V2Mac.
- В TUN приложение неизвестно, поэтому действуют только правила по хостам и IP.
- При выключенном System Proxy приложения, которые вы сами направили на порт V2Mac, пропускают правила и идут через сервер (в Connections — оранжевым App's proxy setting). При включённом System Proxy весь трафик через порт следует правилам.
Разделяйте записи переводом строки, запятой, пробелом или ;. Строки, начинающиеся с #, // или !, — комментарии.
| Запись | Совпадает с |
|---|---|
example.com, *.example.com, +.example.com, .ir
|
доменом и всеми поддоменами |
full:www.example.com |
только этим именем |
keyword:shop, *shop*
|
любым именем, содержащим слово |
regexp:^ads\d+\. |
регулярным выражением |
1.2.3.4, 10.0.0.0/8, 2001:db8::/32, 10.0.0.1-10.0.0.9
|
адресом или диапазоном |
geosite:google, geosite:category-ads-all
|
списком сайтов из geosite.dat
|
geoip:de, geoip:telegram
|
адресами страны или сервиса |
ext:region-ir-geosite.dat:ir |
списком из регионального пакета |
DOMAIN-SUFFIX,example.com,DIRECT |
правилами Clash (решает действие правила) |
0.0.0.0 ads.example.com |
строками файла hosts |
||ads.example.com^ |
доменными строками Adblock |
Всё нераспознанное показывается красной меткой и пропускается. Несуществующий список geosite: не даёт ядру запуститься; журнал называет его.
V2Mac читает правила других приложений, так что переезд не требует переписывать их: Proxifier (.ppx), Clash / Mihomo (.yaml), sing-box (.json), экспорт правил v2rayN / v2rayNG / Xray (.json) и Shadowrocket / Surge (.conf). Формат определяется сам.
- В окне «Правила» выберите Import… в меню ⋯.
- Выберите файл.
- Проверьте список и нажмите Import. До этого ничего не меняется.

Export (меню ⋯) сохраняет все или выбранные правила. Меню профилей хранит несколько именованных наборов правил (дом, работа, поездки).
Каждая строка TYPE,value,POLICY становится частью правила: DIRECT → Direct, REJECT → Block, любая другая политика (группа прокси) → Proxy. Идущие подряд строки с одной политикой становятся одним правилом с её именем. Читаются DOMAIN, DOMAIN-SUFFIX, DOMAIN-KEYWORD, DOMAIN-REGEX, IP-CIDR, GEOIP, GEOSITE и PROCESS-NAME; MATCH / FINAL остаётся режиму маршрутизации. DST-PORT, NETWORK и AND из простых условий становятся Only when; RULE-SET, OR и NOT пропускаются и называются при проверке.
Каждое правило маршрута становится одним правилом; действие задаёт его outbound (direct, block/reject, всё остальное — Proxy). Из v2rayN сохраняются имя и состояние вкл/выкл. Порт, диапазон портов, сеть и протокол становятся Only when; правила, ограничивающие inbound, пропускаются, чтобы не импортировать их шире, чем они были; наборы правил тоже.
| В Proxifier | В V2Mac |
|---|---|
| Правило на прокси на этом Mac (порт V2Mac) | правило Proxy |
| Правило Direct / Block | то же действие |
| Выключенное правило | импортируется выключенным |
| Правило на другой прокси или цепочку | пропускается и указывается оранжевым |
| Поле Applications | приложения правила ("App.app", bundle id, *шаблон*, имена процессов) |
Целевые хосты (*.example.com, диапазоны вроде 10.0.0.0-10.255.255.255) |
хосты правила |
| Целевые порты | порты Only when |
| Опция Block UDP 443 | включённый Block QUIC |
Импортированные правила встают после ваших, так что существующие правила сохраняют приоритет. Дальше это обычные правила V2Mac, которые можно изменить, переставить или выключить.
Отличия от Proxifier: V2Mac определяет приложения только для трафика через системный прокси или свой порт, но не в режиме TUN (там используйте правила по хостам).
| Цель | Действие | Хосты |
|---|---|---|
| Блокировать рекламу везде | Block | geosite:category-ads-all |
| ИИ-сервисы через прокси при обходе Ирана | Proxy |
geosite:openai, geosite:anthropic
|
| Обновления Apple и Microsoft мимо прокси | Direct |
geosite:apple, geosite:microsoft
|
| Офисная сеть напрямую | Direct |
10.0.0.0/8, full:intranet.example.com
|
| Только Telegram через прокси | Proxy (в режиме Rules Only) | приложения: Telegram.app
|
Для полного конфига Xray сначала работают правила и режим V2Mac, затем собственная маршрутизация конфига как запасной вариант (фиолетовый Config fallback в Connections).
V2Mac включает подписанную команду v2mac для агентов и терминала. Установите её в Settings → About; Homebrew использует тот же встроенный файл. Получите revision через v2mac rules list --json и передавайте его при каждой записи. --dry-run проверяет изменения без сохранения и переподключения. CLI не редактирует настройки напрямую; устаревшая revision и неприменённый черновик завершаются безопасной ошибкой.
V2Mac · GPL-3.0 · Report an issue