// homelab · self-hosted · Debian

Домашняя инфраструктура

Сам собрал и держу домашний сервер: интернет-шлюз, десяток сервисов в Docker за одним reverse-proxy, зеркальное хранилище и защищённый удалённый доступ. Всё, что описано ниже, работает у меня дома в постоянной эксплуатации.

Linux Debian systemd Docker · Compose Traefik nftables · ufw Tailscale · WireGuard Pi-hole mdadm RAID Ansible PostgreSQL · MariaDB Prometheus · Grafana Bash
01

Схема инфраструктуры

Логические слои по ходу трафика: интернет, шлюз и сеть, reverse-proxy, сервисы, хранилище. Наведите или коснитесь любого блока, чтобы прочитать, что это и зачем.

Интернет · WAN

Шлюз и сеть

Узлы и удалённый доступ

Reverse-proxy

Сервисы · Docker

Медиа

Облако и данные

Коммуникации

Наблюдаемость и разработка

Хранилище

02

Инженерные кейсы

Реальные задачи, которые пришлось разбирать: что было, что сделал, что получилось. По ним видно, как я подхожу к диагностике и выбору решений.

Docker · systemd · storage

Split-brain у Docker после перезагрузки

Ситуация
После перезагрузки фото и медиа открывались пустыми. Docker стартовал раньше, чем монтировался дисковый массив, и разворачивал данные на системном диске вместо зеркала. Настоящие файлы и рабочий каталог Docker оставались на неподключённом массиве, а обращения к контейнерам падали с ошибкой доступа.
Что сделал
Локализовал: демон держал данные не на том диске. Аккуратно остановил Docker, проверил что массив на месте, свёл демон обратно на зеркало и поднял стек. Корень был в порядке загрузки, монтирование массива не было обязательным условием старта. Закрыл это жёсткой зависимостью docker от монтирования тома через systemd.
Результат
Сервисы вернулись на реальные данные. Теперь без своего хранилища Docker просто не стартует и падает заметно, а не молча уезжает на системный диск. Такая гонка больше не повторится.
Kubernetes · k3s

k3s: кластер и разбор ImagePullBackOff

Ситуация
Осваивал оркестрацию: развернул multi-node кластер k3s. При выкатке сервиса поды застряли в ImagePullBackOff, образы не тянулись.
Как искал причину
Начал с событий пода: kubectl describe pod показывает, на каком шаге падает pull и с какой именно ошибкой. Дальше проверял по слоям, чтобы отсечь лишнее: тянется ли образ руками с самого узла, доходит ли узел до registry, отвечает ли DNS внутри кластера. Так сузил общий сбой выкатки до конкретного звена между узлом и registry.
Что сделал
Починил выкатку на найденном звене. Параллельно сравнил с Docker Compose и для прода на одном узле оставил Compose как более простой и предсказуемый вариант.
Результат
Разобрался, как в Kubernetes устроены pull образов и сетевой слой. Заодно понял, как выбирать инструмент по масштабу задачи: там, где хватает Compose, кластер только добавляет сложности.
mdadm · RAID · восстановление

RAID 1 и восстановление затёртого диска

Ситуация
Важные данные (фото, облако, медиа) лежали на паре обычных дисков, нужна была устойчивость к отказу одного из них. Отдельная история: у друга случайно затёрли раздел с музыкой и проектами.
Что сделал
Собрал программное зеркало на mdadm и вынес на него данные Docker. Для восстановления снял побайтовый образ диска через ddrescue, вытащил файлы карвингом (photorec) и честно отделил то, что восстановилось (пара тысяч проектов и аудио), от того, что уже перезаписано.
Результат
Массив переживает смерть одного диска без потери данных. Файлы друга вернул, образ оставил как страховку. Заодно разобрался, чем удаление файла отличается от перезаписи блоков.
network · PPPoE · nftables

Сервер как роутер квартиры и выборочный VPN

Ситуация
Штатный роутер упирался в потолок скорости и ронял WiFi. Хотелось поднять скорость, свести весь роутинг в одну точку и пустить часть трафика через VPN сразу для всех устройств, без настройки на каждом.
Что сделал
Перенёс роутинг на сервер: интернет по PPPoE, NAT на nftables, роутер оставил только точкой доступа. Долго ловил засаду: ufw молча резал входящий GRE, из-за чего туннель поднимал управляющий канал, но данные не шли. Разрешил протокол в правилах ufw. Дальше тюнинг: BBR, буферизация туннеля, шейпер CAKE. Для выборочного VPN поднял прокси в режиме прозрачного шлюза по спискам доменов.
Результат
Скорость выросла почти втрое, задержка под нагрузкой около 4 мс. SSH закрыл наружу, оставил доступ только через VPN. Как следует разобрался в сетевом стеке Linux: PPPoE, nftables, ufw, GRE, QoS.
03

Как развёрнута эта страница

Тем же способом, что и остальное на сервере: статический файл в контейнере nginx за Traefik. Reverse-proxy подхватывает его по docker-лейблам и сам выпускает сертификат Let's Encrypt. Правки едут через git: коммит с ноутбука, а сервер подтягивает новую версию сам.