Managed Route в ZeroTier — это намерение контроллера, а фактический путь выбирает операционная система клиента вместе с локальными, VPN- и ZeroTier-маршрутами. Возьмите один IP назначения, сохраните список Managed Routes и выполните route lookup на проблемном устройстве. Если ОС выбрала Wi‑Fi, корпоративный VPN или другой gateway, перезапуск ZeroTier не устранит конфликт префиксов.

Не удаляйте все маршруты сразу, особенно если устройство находится удалённо и ZeroTier — единственный канал управления. Сначала подготовьте второй сеанс или out-of-band доступ, измените один префикс на пилотном узле и проверьте обратный путь. Ошибка в `via` может оборвать связь со всеми клиентами сети.

Control plane сравнивается с таблицей конкретного клиента

В Central запишите destination, prefix length и `via` для каждой Managed Route, а также ZeroTier IP маршрутизатора. На клиенте получите фактическое решение именно для IP сервиса, а не только полный список. Команда lookup сразу показывает выбранный интерфейс и next hop.

# Linux
zerotier-cli listnetworks
ip route get 192.168.100.25
ip route show table all

# Windows PowerShell
zerotier-cli.bat listnetworks
Get-NetRoute -AddressFamily IPv4 | Sort-Object DestinationPrefix
Test-NetConnection 192.168.100.25 -Port 443 -InformationLevel Detailed
ФактГде смотретьПлохой признак
разданный destination/prefixCentral → Network → Managed Routesперекрывает домашнюю или офисную LAN
установленный маршрутip route / Get-NetRouteмаршрут отсутствует или ведёт не в ZeroTier
выбранный путь до IPip route get / Test-NetConnectionдругой interface или next hop
состояние сетиzerotier-cli listnetworksне OK, неверный network ID/interface
обратный маршрутgateway и целевая LANответ уходит через default gateway

Более специфичный префикс обычно выигрывает

Клиент одновременно может иметь домашнюю сеть `192.168.1.0/24` и Managed Route с таким же destination. Одинаковые или пересекающиеся частные диапазоны создают неоднозначность. Сначала сравните prefix length: `/24` конкретнее `/16`. При равной специфичности решение зависит от метрик и правил ОС, поэтому одинаковые подсети по разные стороны VPN лучше не считать устойчивой конфигурацией.

Документация ZeroTier для маршрутизации в физическую LAN показывает осознанный приём: объявить через ZeroTier чуть более широкий маршрут, например `/23`, когда локальный физический `/24` должен иметь приоритет. Это не универсальная замена адресации. Приём подходит только после проверки, что расширенный диапазон не перехватит чужие сети и что нужные адреса действительно находятся за указанным gateway.

  • Составьте карту всех пересекающихся RFC1918-сетей пользователей, офисов, cloud VPC и других VPN.
  • Для критичного ресурса используйте уникальный непересекающийся диапазон, если можно изменить адресацию.
  • Не публикуйте default route через ZeroTier, если задача касается одной подсети.
  • Проверяйте IPv4 и IPv6 отдельно: исправление IPv4 не объясняет маршрут AAAA.

Поле via должно указывать на реальный ZeroTier-router

Для доступа к физической подсети Managed Route задаётся как destination через ZeroTier IP узла-маршрутизатора. Этот узел должен быть участником и авторизованным member той же сети, иметь стабильный managed IP, видеть физическую LAN и пересылать пакеты между интерфейсами. Если `via` указывает на адрес назначения, старый адрес узла или обычный LAN IP, клиенты получают бесполезный next hop.

Проверка gatewayОжидаемый результатЕсли нет
ZeroTier member authorizedузел online и виден в сетиисправить membership до маршрута
ZeroTier IP gatewayсовпадает с viaобновить назначение/route
доступ к physical subnetgateway сам соединяется с targetисправить LAN route/firewall
IP forwardingвключён и сохраняется после rebootнастроить forwarding
forward/NAT policyответ возвращается к ZT-клиентудобавить обратный route или ограниченный NAT

Односторонний ping часто означает обратный маршрут

Пакет может прийти из ZeroTier в LAN, а ответ уйти через default gateway физического хоста. Предпочтительный вариант — добавить на LAN-router обратный маршрут к ZeroTier subnet через ваш gateway. Если управлять LAN-router нельзя, официальный пример ZeroTier использует NAT/Masquerade на Linux gateway; у него есть ограничения, в том числе невозможность инициировать соединение из LAN к внешнему ZeroTier-клиенту в описанной схеме.

Проверяйте не только ICMP. Firewall может разрешать ping и закрывать TCP, либо наоборот. Зафиксируйте source IP на целевом сервисе, выполните подключение к реальному порту и при необходимости снимите короткий packet capture на обоих интерфейсах gateway. В capture не должны попадать лишние пользовательские данные.

Изменение маршрута выкатывается двумя шагами

  1. Подготовить out-of-band доступ или второй административный канал к gateway и пилотному клиенту.
  2. Добавить новый непересекающийся или более точный маршрут рядом со старым.
  3. Дождаться его появления на пилотном клиенте и повторить route lookup.
  4. Проверить target port, обратный трафик и локальные ресурсы клиента.
  5. Перенести небольшую группу устройств и наблюдать ошибки соединения.
  6. Удалить старый маршрут только после проверки всех зависимых подсетей.
  7. Сохранить снимок Central и команд вывода как rollback plan.

ZeroTier Central в текущей документации разделяет Managed Routes и IPv4 Auto-Assign. Адрес устройства сам по себе не применяется в ОС без подходящего managed route. Поэтому после изменения диапазона проверяйте оба объекта: выданный IP и объявленный маршрут должны описывать одну согласованную сеть.

Готовая схема подтверждается по одному пакету в обе стороны

Успех — это не статус ONLINE в Central. На клиенте route lookup выбирает ZeroTier interface и ожидаемый via, gateway получает пакет на ZeroTier-интерфейсе и передаёт в LAN, target отвечает, а обратный пакет возвращается тому же клиенту. Параллельно локальная домашняя или офисная сеть продолжает открываться своим прямым маршрутом.

Для удалённого разбора подготовьте network ID в маскированном виде, три Managed Routes, вывод lookup для одного destination, ZeroTier IP gateway, схему LAN и обезличенный trace. Identity secrets и файл `identity.secret` не передаются: для диагностики маршрута они не нужны.

Проверенные источники