Files
buryan-agent 6cdd90db9b Защита Docker и автозапуск Authentik
Authentik: политика restart=unless-stopped для четырёх контейнеров и в
compose (/opt/authentik-security). Раньше после перезагрузки они оставались
Exited (255), из-за чего падали все восемь oauth2-proxy.

Docker: скрипт docker-daemon-set применяет конфиг только с откатом —
сначала проверка dockerd --validate, бэкап, применение, и если демон не
поднялся, возврат бэкапа. Важное открытие: dockerd --validate НЕ ловит
неверный CIDR (говорит configuration OK на 192.168.1.115.1/24), поэтому
защита строится на откате. Проверено: битый конфиг откатился, Docker остался
активным.

Ежедневная проверка docker-config-check (06:15) валидирует конфиг, проверяет
активность Docker и при проблеме шлёт событие в ядро.
2026-10-20 16:20:19 +03:00

56 lines
2.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Защита от неверного конфига Docker
## Зачем
После перезагрузки хоста Docker не поднялся: в `/etc/docker/daemon.json`
стояло `"bip": "192.168.1.115.1/24"` (пять октетов) и
`"fixed-cidr": "192.168.1.115.100-192.168.1.115.200"` (диапазон вместо CIDR).
Демон падал с `invalid CIDR address`, и все контейнеры на хосте остались
лежать: freshrss, heimdall, immich, navidrome, n8n, portainer, adguard,
traefik, machine-learning.
## Что сделано
### 1. Безопасное применение конфига
`/usr/local/bin/docker-daemon-set <файл.json>`:
1. проверяет кандидат `dockerd --validate`;
2. делает бэкап текущего конфига;
3. применяет, перезапускает Docker;
4. **если Docker не поднялся — возвращает бэкап и перезапускает снова.**
### 2. Важное открытие
`dockerd --validate` **не ловит неверный CIDR**: на конфиг
`{"bip": "192.168.1.115.1/24"}` он отвечает `configuration OK`, а демон
потом падает. Поэтому защита строится не на валидации, а на
**откате после неудачного запуска**. Проверено: подсунул битый конфиг —
скрипт откатился, Docker остался активным.
### 3. Ежедневная проверка
`/usr/local/bin/docker-config-check` (cron 06:15):
* валидирует конфиг;
* проверяет, что Docker активен;
* при проблеме отправляет событие в ядро (`kind: проверка`,
`key: docker-config`), откуда оно уходит в Matrix.
## Текущий рабочий конфиг
```json
{
"bip": "10.115.0.1/24",
"fixed-cidr": "10.115.0.0/24"
}
```
Бэкапы: `/etc/docker/daemon.json.bak-cidr` (прежний сломанный) и
`daemon.json.bak-<дата>` (перед каждым применением).
## Правило на будущее
Менять конфиг Docker только через `docker-daemon-set`, никогда — правкой
файла «на живую».