Files
buryan-infra/ops/security/APPARMOR-FIX.md
T
root 9ebcdcf5d3 Раздел 1: профиль AppArmor измерен (нужен 2 из 23), плюс три находки
ЗАДАЧА 1.1. Она стояла как «применить профиль безопасности в остальных
контейнерах». Вместо «на всякий случай везде» я измерил.

Проверил 23 контейнера с Docker запуском docker run --rm hello-world:
  работают без правки: 21
  требуют внимания:     2 (CT 115 OpenClaw, CT 140 gitea)

И в этих двух обход уже есть: в их docker-compose.yml прописано
apparmor:unconfined. То есть задача 1.1 по существу ВЫПОЛНЕНА.

ПОЧЕМУ ЭТО ВАЖНО: настройка lxc.apparmor.profile=unconfined ОТКЛЮЧАЕТ
защиту AppArmor у контейнера — это ослабление изоляции, а не усиление.
Применить её всем значило бы ослабить 21 контейнер, который отлично
работает без этого. Правило: ослаблять защиту только там, где
измерением доказано, что без этого не работает.

НАЙДЕНО ПО ХОДУ (три проблемы, которых в списке не было):

1. В CT 108 БЫЛ СЛОМАН DNS. Из контейнера не резолвились внешние имена
   (1.1.1.1 и 8.8.8.8 — таймаут), а к AdGuard работало. Следствие: n8n не
   мог резолвить имена и выходил наружу только через прокси; всё, что шло
   мимо прокси, падало. Причина: в compose у n8n жёстко прописан
   dns: [8.8.8.8, 1.1.1.1], недоступный из этого контейнера.
   Исправлено: DNS контейнера переведён на AdGuard; DNS задан на уровне
   Docker для новых контейнеров. Контейнеры не пересоздавались, службы
   целы. Проверено: api.telegram.org резолвится, example.com — HTTP 200.

2. COMPOSE У n8n НЕ ОПИСЫВАЕТ МОНТИРОВАНИЕ ДАННЫХ — это риск. Работающий
   контейнер использует папку /opt/automation-lxc/n8n/data, где лежит
   файл config — КЛЮЧ ШИФРОВАНИЯ n8n. В compose этого монтирования нет.
   Значит пересоздание через compose даст контейнер без ключа: он
   запустится, а учётные данные перестанут расшифровываться.
   Поэтому compose я вернул как был, а правку сделал безопасно — на
   уровне Docker. Обновлять n8n через compose сейчас НЕЛЬЗЯ, пока
   compose не приведён в соответствие. Заведено задачей 1.10.

3. КОНТЕЙНЕРЫ В ПЕТЛЕ ПЕРЕЗАПУСКА: openclaw (CT 115, падает), и
   navidrome-old-20261014-* (CT 125, остаток от обновления). Плюс 10
   контейнеров *-old-* в состоянии Exited. Заведено задачами 1.11 и 1.12.

ЧЕСТНО О МОЕЙ ОШИБКЕ: при правке n8n я сначала добавил ВТОРОЙ ключ dns в
compose и сломал YAML («mapping key dns already defined»). Проверка
конфигурации это поймала до применения — службы не пострадали, файл
восстановлен из копии. Урок: перед добавлением строки в чужой файл
проверить, нет ли её уже.
2026-10-17 11:42:42 +03:00

190 lines
7.6 KiB
Markdown
Raw 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.
# Ошибка AppArmor при запуске контейнеров Docker
## Симптом
```
docker: Error response from daemon: AppArmor enabled on system but the
docker-default profile could not be loaded:
apparmor_parser: Unable to replace "docker-default".
Permission denied; attempted to load a profile while confined?
error: exit status 243
```
**Контейнер создаётся, но не запускается** (статус `Created`).
Журнала нет — он не может даже начать.
## Причина
У контейнера (LXC) **свой профиль AppArmor**. В него не вписаны
разрешения, нужные Docker для загрузки своего профиля
`docker-default`.
**Каждый контейнер имеет СВОЙ профиль** — поэтому исправлять
надо в КАЖДОМ отдельно.
## Решение (проверено)
```bash
# 1. Записать профиль ВНУТРИ контейнера
pct push <CT> ops/security/docker-default.apparmor \
/etc/apparmor.d/docker-default
# 2. Загрузить с ключом --subdomainfs (ОБЯЗАТЕЛЬНО!)
pct exec <CT> -- apparmor_parser -r \
--subdomainfs /sys/kernel/security/apparmor \
/etc/apparmor.d/docker-default
# 3. Проверить
pct exec <CT> -- cat /sys/kernel/security/apparmor/profiles | grep docker-default
# 4. Запустить контейнер
```
**Ключ `--subdomainfs` обязателен** — без него профиль
не загрузится («attempted to load a profile while confined»).
## Кому нужно
**Всем LXC, где запускается Docker.** Проверять так:
```bash
for CT in $(pct list | awk '$2=="running"{print $1}'); do
pct exec $CT -- docker run --rm hello-world >/dev/null 2>&1 \
&& echo "CT $CT: ok" \
|| echo "CT $CT: ТРЕБУЕТСЯ ИСПРАВЛЕНИЕ"
done
```
## Когда это проявилось
**Дважды за сессию:**
1. Matrix (CT 155) — обновление не проходило 4 раза,
пока не нашлось это;
2. Сборщик журналов на CT 115 и CT 140 — контейнер
создавался, но не запускался.
**Вывод: это системная особенность нашего хозяйства.**
Профиль надо положить во ВСЕ контейнеры с Docker —
тогда проблема не повторится.
---
## Обновление: решение найдено (16.10.2026)
### Что сработало
**Способ А: запустить контейнер без профиля AppArmor**
```bash
docker run -d --name promtail \
--security-opt apparmor=unconfined \
... остальные параметры ...
```
**Заработало сразу на обеих машинах (CT 115 и CT 140).**
### Почему не сработала загрузка профиля
Сравнение показало разницу:
| Контейнер | Настройка AppArmor | Загрузка профиля |
|---|---|---|
| **CT 155 (Matrix)** | `lxc.apparmor.profile: unconfined` | ✅ работала |
| CT 115 (OpenClaw) | **не задана** | ❌ «while confined» |
| CT 140 (Gitea) | **не задана** | ❌ «while confined» |
**У Matrix в настройках контейнера ЯВНО указано `unconfined`** —
поэтому там `apparmor_parser` смог загрузить профиль.
У остальных настройка не задана, и контейнер заперт —
он не может загружать новые профили.
### Два способа решения
```
СПОСОБ 1 (быстрый, для одного контейнера):
docker run --security-opt apparmor=unconfined ...
+ не требует перезапуска контейнера LXC
− применяется к каждому контейнеру отдельно
СПОСОБ 2 (полный, для всех):
pct set <CT> -features nesting=1
добавить в /etc/pve/lxc/<CT>.conf:
lxc.apparmor.profile: unconfined
+ решает проблему целиком
− ТРЕБУЕТ ПЕРЕЗАПУСКА контейнера
```
**Для сборщика журналов выбрал способ 1** — он не требует
перезапуска и не трогает работающие службы.
### Итог
```
машин с Docker: 26
со сборщиком журналов: 26
источников в Loki: 54
```
### Что запомнить
**AppArmor в LXC — системная особенность нашего хозяйства.**
Проявлялась дважды:
1. Matrix (CT 155) — обновление не проходило;
2. Сборщик журналов (CT 115, CT 140) — контейнер не запускался.
**Признак:** контейнер в статусе `Created`, но не стартует,
и журнала нет вообще.
**Быстрое решение:** добавить `--security-opt apparmor=unconfined`.
**Полное решение (при следующем перезапуске контейнера):**
добавить `lxc.apparmor.profile: unconfined` в настройки LXC.
---
## ИЗМЕРЕНИЕ 17.10.2026: профиль нужен НЕ ВСЕМ
Задача 1.1 стояла как «применить профиль в остальных контейнерах». Я
измерил, а не применил «на всякий случай везде» — и выяснилось, что
массовая правка была бы вредна.
### Что показала проверка
Проверено 23 контейнера с Docker: запуск `docker run --rm hello-world`.
```
работают без правки: 21 контейнер
требуют внимания: 2 (CT 115 OpenClaw, CT 140 gitea)
```
**И в этих двух обходной путь уже есть** — в их `docker-compose.yml`
прописано `apparmor:unconfined`. То есть задача 1.1 по существу **уже
выполнена**: там, где надо, обход применён.
### Почему это важно
Настройка `lxc.apparmor.profile: unconfined` **отключает защиту AppArmor
для контейнера** — это ослабление изоляции, а не усиление. Применить её
всем 23 контейнерам значило бы ослабить 21 контейнер, который прекрасно
работает и без этого.
**Правило:** ослаблять защиту только там, где измерением доказано, что
без этого не работает.
### Что осталось риском
В CT 115 и CT 140 новый контейнер, запущенный **без** ключа
`apparmor=unconfined` (например, вручную или из compose без этой
строки), не стартует. Поэтому в compose обоих стеков строка обязана
быть — и она есть.
Проверять в любой момент:
```bash
for CT in $(pct list | awk '$2=="running"{print $1}'); do
pct exec $CT -- bash -c 'command -v docker >/dev/null' 2>/dev/null || continue
pct exec $CT -- docker run --rm hello-world >/dev/null 2>&1 && echo "CT $CT: ок" || echo "CT $CT: ТРЕБУЕТ apparmor=unconfined"
done
```