Skip to content

Сетевой меш WireGuard, Кочующие VIP и Nftables ​

Starry объединяет все ноды кластера в децентрализованную P2P-сеть с использованием протокола WireGuard (starry0). Сеть работает поверх публичного интернета, преодолевая NAT и файрволы благодаря встроенному механизму PersistentKeepalive = 25.


1. Топология сети и NAT Traversal ​

В традиционных архитектурах серверы за NAT изолированы. В Starry:

  • Ноды с белыми IP-адресами (is_public: true) объявляют свои публичные Endpoint.
  • Ноды за NAT подключаются к публичным нодам и отправляют keepalive-пакеты каждые 25 секунд, удерживая состояние в таблицах трансляции NAT-шлюзов.
  • Публичные ноды выполняют транзитную маршрутизацию между серверами за NAT.
text
[ VPS-1: Публичный IP (is_public: true) ]
   ▲                            ▲
   │ WireGuard                  │ WireGuard
   │ Keepalive=25               │ Keepalive=25
   ▼                            ▼
[ VPS-2: За провайдерским NAT ]  [ VPS-3: За корпоративным NAT ]

2. Кочующие VIP контейнеров (Container VIPs 10.99.x.x) ​

Каждый развертываемый сервис получает свой постоянный виртуальный IP-адрес в подсети оверлея (10.99.x.x).

Как это работает: ​

  1. При деплое сервиса на ноду bocchi Starry добавляет VIP контейнера (например, 10.99.10.5/32) в секцию AllowedIPs для ноды bocchi в конфигах всех остальных участников меша.
  2. Весь трафик к 10.99.10.5 мгновенно маршрутизируется ядром Linux через интерфейс starry0 прямо на ноду bocchi.
  3. При миграции сервиса с ноды bocchi на nijika Starry обновляет AllowedIPs (wg syncconf): трафик перенаправляется на nijika без смены IP сервиса!

Взаимодействие с Nginx Proxy Manager (NPM) / Reverse Proxy ​

Любой обратный прокси (NPM, Traefik, Caddy), запущенный на публичной ноде, может направлять трафик на http://10.99.10.5:8080. Ему не нужно знать физический IP сервера, на котором сейчас работает контейнер — оверлейный меш прозрачно доставит пакеты в нужную точку!


3. Встроенный Internal DNS (*.internal) ​

В агент Starry встроен легковесный DNS-сервер, слушающий порт 53 оверлейного интерфейса:

  • Домен api.internal -> 10.99.10.5
  • Домен database.internal -> 10.99.0.2

Контейнеры используют агент Starry в качестве первичного DNS-сервера, что позволяет сервисам обращаться друг к другу по стабильным доменным именам.


4. Файрвол и проброс портов в nftables (table inet starry) ​

Starry управляет изолированной таблицей table inet starry, не конфликтуя с правилами Docker или хостовой системы:

  • Политика chain input: по умолчанию drop.
  • Разрешены: lo, starry0, входящий SSH и входящий WireGuard UDP 51820.
  • chain prerouting: DNAT проброс публичных портов IPv4/IPv6 на внутренние VIP контейнеров.
  • chain postrouting: SNAT masquerade для сохранения корректного обратного пути пакетов.

Released under the MIT License.