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/prefix | Central → Network → Managed Routes | перекрывает домашнюю или офисную LAN |
| установленный маршрут | ip route / Get-NetRoute | маршрут отсутствует или ведёт не в ZeroTier |
| выбранный путь до IP | ip 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 subnet | gateway сам соединяется с 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 не должны попадать лишние пользовательские данные.
Изменение маршрута выкатывается двумя шагами
- Подготовить out-of-band доступ или второй административный канал к gateway и пилотному клиенту.
- Добавить новый непересекающийся или более точный маршрут рядом со старым.
- Дождаться его появления на пилотном клиенте и повторить route lookup.
- Проверить target port, обратный трафик и локальные ресурсы клиента.
- Перенести небольшую группу устройств и наблюдать ошибки соединения.
- Удалить старый маршрут только после проверки всех зависимых подсетей.
- Сохранить снимок 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` не передаются: для диагностики маршрута они не нужны.