Если хост видит адрес приватной сети, а контейнер — нет, это ожидаемо для отдельных network namespaces. Не пытайтесь сначала «показать интерфейс» внутри контейнера. Определите задачу: приложению нужен только исходящий доступ, входящий адрес в overlay или собственная identity с отдельными ACL.

Снимите четыре факта на хосте и внутри контейнера: список интерфейсов, маршрут к целевому IP, результат DNS и TCP-подключение к конкретному порту. Обычный ping недостаточен: userspace networking может работать через SOCKS5, где ICMP не поддерживается.

Название overlay скрывает две разные сети

СетьГде живётЧто увидит контейнер
Docker overlayDocker/Swarm между daemon hostsТолько если подключён к этой Docker network
Tailscale/ZeroTier на хостеNetwork namespace хостаНе получает интерфейс автоматически
VPN sidecarОбщий namespace пары контейнеров или podПриложение использует sidecar-сеть
Userspace proxyПроцесс предоставляет SOCKS5/HTTPПриложение использует адрес proxy

Docker overlay driver соединяет контейнеры на нескольких Docker hosts и требует явного подключения сервиса к сети. Он не является синонимом интерфейса Tailscale или ZeroTier. Сначала назовите конкретную технологию и network ID, иначе диагностика смешивает разные control plane.

Маршрут выбирается по направлению трафика

  • Только outbound к нескольким сервисам: proxy или subnet route часто проще.
  • Inbound к одному приложению: proxy/ingress публикует конкретный сервис.
  • Собственная overlay-identity на replica: sidecar или клиент в общем namespace.
  • Нужен весь стек хоста: host network, если допустима потеря сетевой изоляции.
  • Нужен Docker multi-host service network: Docker overlay, а не VPN-интерфейс хоста.

Host network делит сетевой namespace с хостом; Docker отмечает, что контейнер тогда не получает отдельный IP, а публикация портов игнорируется. На Linux это прямое решение, но оно расширяет доступ приложения к хостовой сети и создаёт конфликты портов. Выбирайте его только как осознанную архитектуру.

Sidecar даёт identity без изменения приложения

services:
  overlay:
    image: tailscale/tailscale:stable
    # state, auth and capabilities задаются по официальной схеме
  app:
    network_mode: "service:overlay"
    depends_on: [overlay]

Фрагмент показывает идею совместного namespace, а не готовый production Compose: параметры state, healthcheck, secrets и capabilities зависят от выбранного клиента. Не встраивайте постоянный auth key в image. Сервис приложения стартует только после готовности overlay, иначе первый DNS lookup может навсегда закешировать ошибку.

Userspace proxy уменьшает привилегии

Tailscale описывает userspace mode, который предоставляет SOCKS5 для исходящих соединений; в Kubernetes-документации этот режим уменьшает требуемые permissions sidecar. Цена — приложение или его HTTP-клиент должны уметь работать через proxy, а обычный ping не служит проверкой.

Не добавляйте NET_ADMIN и доступ к /dev/net/tun всем контейнерам «на всякий случай». Эти полномочия нужны только компоненту, который действительно управляет сетевым стеком в kernel mode. Приложение остаётся непривилегированным, а ACL overlay ограничивают конкретные назначения и порты.

Проверка идёт от route к политике доступа

  1. На хосте подтвердить route, DNS и TCP к приватному адресу.
  2. В контейнере повторить route/DNS и записать network mode из inspect.
  3. Проверить readiness overlay-клиента и его выданную identity.
  4. Проверить ACL и destination port, не отключая firewall целиком.
  5. Перезапустить только приложение и убедиться, что связь восстанавливается без нового auth.

Для разбора подготовьте ОС и Docker version, Compose или inspect без секретов, маршруты хоста и контейнера, выбранную overlay-технологию и требуемое направление связи. По этому набору можно выбрать host, sidecar, proxy или routing, не превращая контейнер в привилегированный сетевой узел случайно.

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