# homelab-infra Инфраструктура как код для личной сети: домашний homelab, внешние VPS и overlay-сеть на базе NetBird. ## Идея Репозиторий — единственный источник правды о состоянии инфраструктуры. Правки на хостах вручную по SSH не вносятся: изменения коммитятся сюда, доставка — через Gitea Actions (GitOps). **Принцип: сервисы первичны, хосты — заменяемы.** Конфигурация сервисов не привязана к конкретным машинам. Хосты и группы сервисов на них будут меняться — структура каталогов это учитывает. ## Структура ``` homelab-infra/ ├── AGENTS.md # правила для AI-агентов, работающих в этом репозитории ├── INVENTORY.md # карта инфраструктуры (хосты, IP, роли, статусы) ├── docs/ │ └── netbird/ # архитектура overlay-сети NetBird ├── services/ │ └── netbird/ # манифесты NetBird (management, signal, relay) ├── hosts/ # описания хостов (по одному каталогу на узел) └── .gitea/ └── workflows/ # пайплайны Gitea Actions ``` ## Текущий фокус Этап 0: проектирование и подготовка к развёртыванию **NetBird management** на новом арендованном VPS. См. `docs/netbird/design.md`. ## Связанные ресурсы - Вики и разборы: Trilium → «Хоумлаб» (человекочитаемая документация) - Git: `https://gitea.gunihome.ru/karpenok/homelab-infra`