From 6cdd90db9b1fe5e99212da48a4859e7a7dec0bdc Mon Sep 17 00:00:00 2001 From: buryan-agent Date: Tue, 20 Oct 2026 16:20:19 +0300 Subject: [PATCH] =?UTF-8?q?=D0=97=D0=B0=D1=89=D0=B8=D1=82=D0=B0=20Docker?= =?UTF-8?q?=20=D0=B8=20=D0=B0=D0=B2=D1=82=D0=BE=D0=B7=D0=B0=D0=BF=D1=83?= =?UTF-8?q?=D1=81=D0=BA=20Authentik?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 и при проблеме шлёт событие в ядро. --- ops/hardening/AUTHENTIK-AUTOSTART.md | 28 ++++++++++++++ ops/hardening/DOCKER-CONFIG.md | 55 ++++++++++++++++++++++++++++ ops/hardening/docker-config-check | 29 +++++++++++++++ ops/hardening/docker-daemon-set | 37 +++++++++++++++++++ 4 files changed, 149 insertions(+) create mode 100644 ops/hardening/AUTHENTIK-AUTOSTART.md create mode 100644 ops/hardening/DOCKER-CONFIG.md create mode 100755 ops/hardening/docker-config-check create mode 100755 ops/hardening/docker-daemon-set diff --git a/ops/hardening/AUTHENTIK-AUTOSTART.md b/ops/hardening/AUTHENTIK-AUTOSTART.md new file mode 100644 index 0000000..0609ec2 --- /dev/null +++ b/ops/hardening/AUTHENTIK-AUTOSTART.md @@ -0,0 +1,28 @@ +# Автозапуск Authentik + +## Проблема + +После перезагрузки хоста контейнеры Authentik (`authentik-security-*`) +остались в состоянии `Exited (255)` — политика перезапуска была `no`. +Из-за этого упали все восемь `oauth2-proxy`: они не видели провайдера и +отдавали 502. + +## Что сделано + +1. Для запущенных контейнеров включена политика: + ``` + docker update --restart=unless-stopped authentik-security-{server,worker,postgresql,redis}-1 + ``` +2. В `/opt/authentik-security/docker-compose.yml` добавлено + `restart: unless-stopped` каждому сервису (иначе пересоздание через + compose вернуло бы `no`). Файл проверен `docker compose config --quiet`. +3. Бэкап: `docker-compose.yml.bak-restart`. + +Проверка: все четыре контейнера `Up (healthy)`, +`/-/health/live/` → 200. + +## Важно + +На хосте два каталога с Authentik: `/opt/authentik` (в compose уже была +политика `unless-stopped`) и `/opt/authentik-security` (рабочий, без +политики). Правки внесены в рабочий; второй не запущен. diff --git a/ops/hardening/DOCKER-CONFIG.md b/ops/hardening/DOCKER-CONFIG.md new file mode 100644 index 0000000..cb3350f --- /dev/null +++ b/ops/hardening/DOCKER-CONFIG.md @@ -0,0 +1,55 @@ +# Защита от неверного конфига 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`, никогда — правкой +файла «на живую». diff --git a/ops/hardening/docker-config-check b/ops/hardening/docker-config-check new file mode 100755 index 0000000..72bf92a --- /dev/null +++ b/ops/hardening/docker-config-check @@ -0,0 +1,29 @@ +#!/bin/bash +# Ежедневная проверка конфига Docker и ключевых сервисов. +set -uo pipefail +CONF=/etc/docker/daemon.json +LOG=/var/log/docker-config-check.log +FAIL=0 + +echo "=== $(date -Is) ===" >> "$LOG" + +if ! dockerd --validate --config-file="$CONF" >> "$LOG" 2>&1; then + echo " FAIL: daemon.json невалиден" >> "$LOG" + FAIL=1 +fi + +if ! systemctl is-active --quiet docker; then + echo " FAIL: docker не активен" >> "$LOG" + FAIL=1 +else + RUNNING=$(docker ps -q 2>/dev/null | wc -l) + echo " docker активен, контейнеров: $RUNNING" >> "$LOG" +fi + +if [ "$FAIL" = "1" ]; then + curl -s -X POST --max-time 10 -H 'Content-Type: application/json' \ + -d '{"kind":"проверка","key":"docker-config","title":"Конфиг Docker невалиден","status":"тревога"}' \ + http://127.0.0.1:9120/event >> "$LOG" 2>&1 || true +fi + +exit "$FAIL" diff --git a/ops/hardening/docker-daemon-set b/ops/hardening/docker-daemon-set new file mode 100755 index 0000000..2361fa1 --- /dev/null +++ b/ops/hardening/docker-daemon-set @@ -0,0 +1,37 @@ +#!/bin/bash +# Применяет конфиг Docker только после проверки dockerd --validate. +# Использование: docker-daemon-set /path/to/new-daemon.json +set -uo pipefail +CONF=/etc/docker/daemon.json +NEW=${1:-} + +if [ -z "$NEW" ] || [ ! -f "$NEW" ]; then + echo "использование: $0 <файл-json>" + exit 1 +fi + +echo "=== ПРОВЕРКА КАНДИДАТА ===" +if ! dockerd --validate --config-file="$NEW" 2>&1 | sed 's/^/ /'; then + echo " конфиг не прошёл проверку — ничего не меняю" + exit 1 +fi +echo " конфиг валиден" + +BACKUP="$CONF.bak-$(date +%Y%m%d-%H%M%S)" +cp "$CONF" "$BACKUP" +echo " бэкап: $BACKUP" + +cp "$NEW" "$CONF" +echo "=== ПЕРЕЗАПУСК DOCKER ===" +systemctl reset-failed docker.service docker.socket 2>/dev/null +if systemctl restart docker; then + sleep 8 + echo " статус: $(systemctl is-active docker)" +else + echo " docker не поднялся — возвращаю прежний конфиг" + cp "$BACKUP" "$CONF" + systemctl reset-failed docker.service docker.socket 2>/dev/null + systemctl restart docker + echo " откат: $(systemctl is-active docker)" + exit 1 +fi