4.2 KiB
4.2 KiB
NetBird: архитектура overlay-сети
Статус: установка панели. Роль — roles/netbird. Машина и домен — в inventories/prod.
Задача
NetBird — транспортный фундамент новой инфраструктуры. Новый хост (VPS, LXC, ВМ, ноутбук) сначала вступает в overlay и только потом получает сервисы.
Сервис не привязан к имени машины. Меняется хост — меняется строка в inventory, роль roles/netbird/ остаётся той же.
Компоненты
| Компонент | Назначение | Порты |
|---|---|---|
netbird-server 0.82.0 |
management, signal, relay и STUN в одном контейнере | 443/tcp через Traefik, 3478/udp |
| Dashboard | веб-панель | 443/tcp через Traefik |
| Traefik v3.7.14 | сертификат Let's Encrypt и маршрутизация | 80/tcp, 443/tcp |
| Встроенный вход | пользователи панели без отдельного Zitadel | — |
Манифесты живут в roles/netbird/ и доставляются сценарием Gitea Actions. Официальный установщик — ориентир по составу контейнеров, не способ запуска.
Требования к VPS
| Параметр | Минимум | Комментарий |
|---|---|---|
| CPU / RAM | 1 vCPU / 1 ГБ | запас — 2 vCPU / 2 ГБ |
| Диск | 20 ГБ | база management растёт медленно |
| Сеть | белый IPv4 | стабильность важнее локации |
| ОС | Ubuntu 24.04 или Debian 12+ | baseline хоста тоже из этого репозитория |
| Порты | 80, 443/tcp; 3478/udp | signal и API идут через 443 |
80/tcp нужен на выпуск Let's Encrypt. Дальше трафик панели и management идёт на 443.
Адресация и группы
Overlay NetBird — 100.64.0.0/10.
Группы описывают роль пира, не имя хоста. Состав группы меняется без смены политики.
| Группа | Кто в ней | Политика |
|---|---|---|
infra-core |
management и будущие управляющие узлы | DNS и маршруты, которые нужны остальным группам |
servers |
VPS с сервисами | SSH из admin |
workstations |
ПК и ноутбуки | доступ к servers по ACL |
iot |
умный дом, камеры | только явно разрешённые направления |
Политика по умолчанию — default-deny.
Решения до аренды VPS
- Домен.
central.gunihome.ru, A-запись на адрес VPS создана вручную. - IdP. На старте встроенный вход панели. Внешний IdP — отдельное решение, когда появится общий SSO.
- Хостинг. Провайдер и локация. На состав сервиса не влияют.
- Бэкап базы management. Куда складывать снимок и как часто. Решить до появления пиров кроме рабочей станции.
Развёртывание
- Цель доставки —
central.gunihome.ru. Отдельного каталога хоста нет. - Сценарий
netbird-installзапускаетplaybooks/site.ymlс ограничением на группуnetbird. Рольhostставит Docker, рольnetbirdоткрывает порты панели и поднимает её. - Сертификат выпускает Traefik. Первый администратор создаётся на
/setup. - Группы и политики из этого документа задаются уже в панели.
- Первый пир — рабочая станция. Проверка: пинг по overlay-адресу и SSH на management по адресу NetBird.