Сетевой меш 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.
[ 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).
Как это работает:
- При деплое сервиса на ноду
bocchiStarry добавляет VIP контейнера (например,10.99.10.5/32) в секциюAllowedIPsдля нодыbocchiв конфигах всех остальных участников меша. - Весь трафик к
10.99.10.5мгновенно маршрутизируется ядром Linux через интерфейсstarry0прямо на нодуbocchi. - При миграции сервиса с ноды
bocchiнаnijikaStarry обновляет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 для сохранения корректного обратного пути пакетов.