4.5 KiB
NetBird: архитектура overlay-сети
Статус: проект. VPS ещё не арендован. Документ фиксирует состав сервиса и решения, которые нужны до развёртывания.
Задача
NetBird — транспортный фундамент новой инфраструктуры. Новый хост (VPS, LXC, ВМ, ноутбук) сначала вступает в overlay и только потом получает сервисы.
Сервис не привязан к имени будущей машины. Меняется хост — меняется цель доставки, состав services/netbird/ остаётся тем же.
Компоненты
| Компонент | Назначение | Порты |
|---|---|---|
| Management | control plane: пиры, политики, ключи, координация | 443/tcp, 33073/tcp (gRPC) |
| Signal | обмен метаданными для установления соединений | 10000/tcp |
| Relay (TURN) | ретрансляция, если p2p не собрался | 3478/udp |
| Dashboard | веб-панель | 443/tcp |
| IdP | аутентификация. На старте — встроенный Zitadel | — |
Манифесты живут в services/netbird/ и рассчитаны на доставку через Gitea Actions. Официальный установщик — ориентир по составу контейнеров, не способ запуска в проде.
Требования к VPS
| Параметр | Минимум | Комментарий |
|---|---|---|
| CPU / RAM | 1 vCPU / 1 ГБ | запас — 2 vCPU / 2 ГБ |
| Диск | 20 ГБ | база management растёт медленно |
| Сеть | белый IPv4 | стабильность важнее локации |
| ОС | Ubuntu 24.04 или Debian 12+ | baseline хоста тоже из этого репозитория |
| Порты | 80, 443, 33073/tcp; 3478/udp | 10000/tcp, если signal на том же хосте |
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
- Домен. Поддомен
gunihome.ruдля management и dashboard. Кто создаёт DNS-запись: вручную или через API. - IdP. На старте встроенный Zitadel. Внешний IdP — отдельное решение, когда появится общий SSO.
- Хостинг. Провайдер и локация. На состав сервиса не влияют.
- Бэкап базы management. Куда складывать снимок и как часто. Решить до появления пиров кроме рабочей станции.
Развёртывание
- Аренда VPS. В репозитории появляется цель доставки, не отдельный каталог «хост».
- Baseline через код: пользователь
deploy, SSH-ключ, firewall на порты из таблицы выше, Docker. - Манифесты
services/netbird/коммитятся и доставляются на VPS. Пока runner не подключён — по runbook изservices/netbird/README.md, сразу следом — Gitea Actions. - Сертификат, вход в dashboard, группы и политики из этого документа.
- Первый пир — рабочая станция. Проверка: пинг по overlay-адресу и SSH на management по адресу NetBird.