HomeLab вырос из нескольких отдельных серверов в небольшую инженерную платформу. Она связывает две площадки, кластер виртуализации, хранилища, мониторинг, домашнюю автоматизацию, редакционные процессы и локальные AI-инструменты.

Публичная схема намеренно показывает роли, а не IP-адреса, VMID, ключи и внешние точки входа.

Актуальная архитектура HomeLab

Сеть и площадки

Основная площадка находится дома: здесь живут гипервизоры, сервисные VM и управляющий контур. Вторая площадка работает как отдельный edge-сегмент. Между ними настроен маршрутизируемый site-to-site WireGuard.

Это L3-связь без попытки растянуть один broadcast domain на два физических места. Такая модель проще диагностируется, переживает частичные отказы и позволяет отдельно контролировать доступ между сегментами.

HOME / CORE                          EDGE / REMOTE
gateway --> switches --> servers    gateway --> edge devices
    |                                      |
    +---------- WireGuard / L3 ------------+

Административный доступ строится вокруг SSH-ключей, минимальных разрешений и выделенных маршрутов. Внешние интерфейсы не должны становиться обходным путём к внутренним сервисам.

Вычислительный слой

Основа платформы — кластер Proxmox. Нагрузки разделены по назначению: сетевые сервисы, автоматизация, мониторинг, умный дом и AI-инструменты не смешиваются в одну большую VM.

Для данных используется ZFS, включая mirror-конфигурации. Для критичных VM предусмотрены резервные копии и репликация. Совпадающий storage ID на узлах позволяет не изобретать отдельный сценарий для каждой миграции.

Сервисы

Сеть и доступ

  • WireGuard между площадками и для доверенного удалённого доступа;
  • маршрутизация и firewall на выделенных шлюзах;
  • reverse proxy на nginx;
  • SSH по ключам и ограниченные диагностические команды для агентов.

Наблюдаемость

  • интерактивный NOC на /status;
  • Zabbix для метрик, триггеров и событий;
  • внешний heartbeat, не зависящий от основной площадки;
  • Telegram-уведомления через автоматизацию;
  • daily health-check и журналы для критичных узлов.

/status закрыт Basic Auth: публичная статья объясняет подход, а оперативные данные остаются внутри административного контура.

Автоматизация и контент

  • n8n как оркестратор интеграций и Telegram-сценариев;
  • ежедневные новости с RSS-источниками, проверкой дублей и журналом ошибок;
  • ежедневные переводы с обязательной ссылкой на автора и источник;
  • AI-подкаст со сценарием, озвучкой, MP3, RSS и архивом;
  • HomeLab Journal с Markdown, Python-рендерами, Astro и Git.

Умный дом

Home Assistant OS работает в отдельной Proxmox VM. Zigbee-координатор передаётся через USB passthrough, а датчики образуют локальную mesh-сеть. Автоматизация не требует облака для базовых сценариев.

AI-контур

  • Hermes Agent — постоянно работающий помощник внутри HomeLab;
  • Codex — инженерная работа с кодом, публикацией и инфраструктурой;
  • OpenCode — дополнительный анализ и второе техническое мнение;
  • DeepSeek Harness и локальный OpenAI-compatible endpoint;
  • Buzz — координация агентов с разделением диагностики и изменений.

AI-агент не получает право на изменение инфраструктуры из текста сообщения. Диагностика отделена от действий, а доступ ограничивается на уровне SSH и команд.

Как проходит сигнал об инциденте

Контур наблюдаемости и реакции

host / service
      |
      v
metrics + heartbeat --> Zabbix / NOC --> n8n --> Telegram
      |                                      |
      +--------------- logs -----------------+

Главная цель мониторинга — не собрать максимум графиков, а быстро ответить на три вопроса: что сломалось, где проходит граница проблемы и какое действие безопасно выполнить первым.

Эксплуатационные правила

  • сначала снимок состояния и резервная копия;
  • затем минимальное изменение;
  • после него локальная проверка и health-check;
  • конфигурации nginx и systemd валидируются до reload/restart;
  • автоматические процессы используют общую файловую блокировку публикации;
  • Git хранит историю кода и документации, но не секреты.

Что развивается дальше

  • событийные сценарии поверх Zabbix, n8n и Telegram;
  • единый каталог сервисов и зависимостей;
  • расширение Home Assistant и локального Zigbee-контура;
  • более глубокая интеграция AI-агентов с read-only диагностикой;
  • развитие WEB и TERMINAL как двух интерфейсов к одной базе знаний.

Актуальные состояния узлов меняются быстрее этой страницы. Здесь зафиксирована архитектура и принципы, а не обещание, что каждый сервис прямо сейчас находится в состоянии green.