К основному содержанию
скилл CX Codex

containers-internals — скилл для Claude Code: намспейсы, cgroups, OCI

Скилл containers-internals для Claude Code по устройству Linux-контейнеров: намспейсы, cgroups v2, overlayfs, runc, seccomp и защита от escape.

MIT 358 установок ★ 298 обновлён 2026-06-27

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add mohitmishra786/low-level-dev-skills --skill containers-internals -a claude-code
Открыть на GitHub

Что делает containers-internals

Охватывает полный стек контейнеров: от системных вызовов clone() и unshare() до конфига OCI spec в config.json, от управления ресурсами через /sys/fs/cgroup до написания seccomp-профилей через libseccomp. Включает примеры на C и bash для создания минимальных контейнеров без Docker, отладки OOM и CPU throttling, а также миграции между cgroups v1 и v2.

Для работы нужны базовые знания Linux syscalls и доступ к системам с включённым cgroup v2. Скилл активируется на запросы о намспейсах, overlayfs, runc, seccomp-bpf, OCI spec и уязвимостях escape. Содержит таблицы действий seccomp (SCMP_ACT_KILL, SCMP_ACT_ERRNO, SCMP_ACT_ALLOW), список намспейсов с CLONE_* флагами, и слой защиты от escape: rootless контейнеры, user namespace, AppArmor/SELinux, отключение привилегий и read-only rootfs.

Какие задачи решает

  • отладить OOM и CPU throttling через cgroups v2
  • написать и применить seccomp-профиль для контейнера
  • создать минимальный контейнер с unshare и clone без Docker
  • исследовать и перекрыть вектор escape в контейнере
  • настроить rootless контейнер с маппингом UID/GID

Примеры запросов агенту

  • Покажи, как отладить памяти в контейнере: как читать memory.events из cgroups v2 и найти утечку
  • Напиши C-код на clone() с CLONE_NEWPID и CLONE_NEWNS, чтобы создать примитивный контейнер
  • Объясни, как написать и загрузить seccomp-профиль через libseccomp, блокируя mount и pivot_root

Как установить containers-internals

1Через Skills CLI (Vercel)

npx skills add mohitmishra786/low-level-dev-skills --skill containers-internals -a claude-code

2Вручную: положить файлы

~/.claude/skills/containers-internals/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/containers-internals/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о containers-internals

Как установить containers-internals?

Выполни для своей платформы: на Claude Code — npx skills add mohitmishra786/low-level-dev-skills --skill containers-internals -a claude-code, затем открой ~/.claude/skills/containers-internals/SKILL.md; на GitHub Copilot — gh skill install mohitmishra786/low-level-dev-skills containers-internals; на Cursor — npx skills add mohitmishra786/low-level-dev-skills --skill containers-internals -a cursor и ~/.cursor/skills/containers-internals/SKILL.md.

Что делает containers-internals?

Скилл объясняет, как работают Linux-контейнеры под капотом: намспейсы (изоляция процессов, сети, FS), cgroups v2 (лимиты памяти и CPU), overlayfs (слои образов), OCI runtime spec (конфиг контейнера), seccomp-bpf (фильтры syscall), capabilities (привилегии) и техники защиты от escape.

В чём разница между cgroups v1 и v2?

cgroups v2 — единая иерархия (вместо отдельных иерархий для памяти, CPU, IO) и более простой синтаксис в /sys/fs/cgroup. Скилл показывает, как работать с v2: где писать лимиты в memory.max, cpu.weight, как читать события в memory.events.

Исходный текст

SKILL.md · MIT
---
name: containers-internals
description: Linux containers internals skill for namespaces, cgroups, and OCI. Use when understanding clone/unshare namespaces, cgroups v2 limits, overlayfs, runc, seccomp profiles, capabilities, or escape mitigations. Activates on queries about namespaces, cgroups, overlayfs, runc, seccomp-bpf, OCI spec, or container escape.
---

# Containers Internals

## Purpose

Guide agents through Linux container internals: namespaces (`clone`, `unshare`, `nsenter`), cgroups v2 resource limits, overlayfs storage, runc and the OCI runtime spec, seccomp-bpf filtering, Linux capabilities for privilege dropping, and container escape mitigations.

## When to Use

- Understanding how Docker/Podman isolate processes under the hood
- Debugging container resource limits (OOM, CPU throttling)
- Writing custom seccomp profiles for sandboxed workloads
- Building minimal containers without Docker
- Investigating container escape vulnerabilities
- Tuning cgroups v2 for Kubernetes pods

## Workflow

### 1. Namespaces

```bash
# List namespaces for a process
ls -la /proc/self/ns/
readlink /proc/self/ns/pid
readlink /proc/1234/ns/net

# Enter container namespaces
nsenter -t <pid> -m -u -i -n -p bash

# Unshare namespaces (manual container)
unshare --fork --mount-proc --pid --net --uts --ipc bash
```

| Namespace | Isolates |
|-----------|----------|
| `CLONE_NEWNS` (mount) | Mount points, filesystem roots |
| `CLONE_NEWPID` | Process IDs |
| `CLONE_NEWNET` | Network stack |
| `CLONE_NEWUTS` | Hostname |
| `CLONE_NEWIPC` | SysV IPC, POSIX message queues |
| `CLONE_NEWUSER` | UID/GID mappings |
| `CLONE_NEWCGROUP` | cgroup root view |

```c
// clone() with namespaces
#define _GNU_SOURCE
#include <sched.h>

int container_init(void *arg) {
    sethostname("container", 9);
    mount("proc", "/proc", "proc", 0, NULL);
    execv("/bin/sh", (char *[]){"/bin/sh", NULL});
    return 1;
}

int stack[1024 * 1024];
clone(container_init, stack + sizeof(stack)/sizeof(int),
      CLONE_NEWPID | CLONE_NEWNS | CLONE_NEWNET | SIGCHLD, NULL);
```

### 2. cgroups v2

```bash
# Unified hierarchy (cgroup v2)
mount -t cgroup2 none /sys/fs/cgroup

# Create cgroup and set limits
mkdir /sys/fs/cgroup/mycontainer
echo $$ > /sys/fs/cgroup/mycontainer/cgroup.procs

# Memory limit 256MB
echo 256M > /sys/fs/cgroup/mycontainer/memory.max

# CPU weight (relative to siblings, default 100)
echo 50 > /sys/fs/cgroup/mycontainer/cpu.weight

# IO weight
echo default 100 > /sys/fs/cgroup/mycontainer/io.weight
```

```bash
# Check current cgroup
cat /proc/self/cgroup

# OOM events
cat /sys/fs/cgroup/mycontainer/memory.events
```

### 3. overlayfs

```
overlayfs layers
├── lowerdir (read-only image layers)
├── upperdir (container writes)
├── workdir (internal bookkeeping)
└── merged (mount point seen by container)
```

```bash
mount -t overlay overlay \
  -o lowerdir=lower1:lower2,upperdir=upper,workdir=work \
  merged

# Docker stores layers in /var/lib/docker/overlay2/
```

Copy-on-write: reads from lower, writes go to upper.

### 4. runc and OCI spec

```bash
# Generate default OCI config
mkdir -p mycontainer/rootfs
runc spec

# Edit config.json — namespaces, mounts, process args
# Run container
sudo runc run mycontainer

# List
runc list
```

`config.json` key sections:

```json
{
  "ociVersion": "1.0.2",
  "process": {
    "args": ["/bin/sh"],
    "capabilities": { "bounding": ["CAP_NET_BIND_SERVICE"] }
  },
  "linux": {
    "namespaces": [
      {"type": "pid"}, {"type": "network"}, {"type": "mount"}
    ],
    "seccomp": { ... },
    "resources": {
      "memory": { "limit": 268435456 }
    }
  },
  "root": { "path": "rootfs", "readonly": false }
}
```

### 5. seccomp-bpf

```c
// libseccomp example — block mount
#include <seccomp.h>

scmp_filter_ctx ctx = seccomp_init(SCMP_ACT_ALLOW);
seccomp_rule_add(ctx, SCMP_ACT_ERRNO(EPERM), SCMP_SYS(mount), 0);
seccomp_rule_add(ctx, SCMP_ACT_ERRNO(EPERM), SCMP_SYS(pivot_root), 0);
seccomp_load(ctx);
```

```bash
# Docker default seccomp profile (JSON)
# https://github.com/moby/moby/blob/master/profiles/seccomp/default.json

# Audit blocked syscalls
# kernel: seccomp log via auditd
ausearch -m SECCOMP
```

| Action | Effect |
|--------|--------|
| `SCMP_ACT_KILL` | Kill process |
| `SCMP_ACT_ERRNO(n)` | Return error |
| `SCMP_ACT_TRACE` | Notify tracer |
| `SCMP_ACT_ALLOW` | Permit syscall |

### 6. Linux capabilities

```bash
# Drop all caps except needed
capsh --drop=all --add=net_bind_service -- -c '/app/server'

# File capabilities
setcap cap_net_bind_service+ep /usr/bin/myserver
getcap /usr/bin/myserver
```

In containers: default Docker drops `CAP_SYS_ADMIN`, `CAP_NET_RAW`, etc. Run as non-root with minimal bounding set.

### 7. User namespace rootless

```bash
# Rootless podman/docker maps root in container to unprivileged UID on host
cat /proc/self/uid_map
#          0       1000          1
# container UID 0 → host UID 1000
```

Rootless limits: cannot mount most filesystems, no `CAP_SYS_ADMIN`.

### 8. Escape mitigations

```
Defense layers
├── User namespace (rootless)
├── seccomp (block dangerous syscalls)
├── AppArmor/SELinux (MAC)
├── Capabilities drop (--cap-drop=ALL)
├── Read-only rootfs
├── no-new-privileges
└── Seccomp + Landlock for filesystem
```

```bash
docker run --read-only --cap-drop=ALL --security-opt=no-new-privileges \
  --security-opt seccomp=default.json myimage
```

Known escape vectors: mounted docker.sock, privileged mode, kernel CVEs, `/proc` leaks.

## Common Problems

| Symptom | Cause | Fix |
|---------|-------|-----|
| Container OOMKilled | memory.max exceeded | Raise limit or fix leak |
| CPU throttled | cpu.max quota low | Adjust `cpu.max` or weight |
| Permission denied in container | Capability dropped | Add specific cap or fix app |
| seccomp kill on start | Missing syscall in profile | `strace` to find; allow syscall |
| overlay mount fail | workdir not empty | Clean workdir; check permissions |
| Rootless mount fail | User namespace limits | Use volume mounts from host |

## Related Skills

- `skills/virtualization/qemu-kvm` — VM isolation vs containers
- `skills/security/kernel-security` — SELinux, AppArmor, seccomp depth
- `skills/observability/ebpf` — trace container syscalls
- `skills/runtimes/binary-hardening` — seccomp and capabilities in production
- `skills/kernel/kernel-internals` — cgroups and namespaces in kernel
- `skills/profilers/strace-ltrace` — syscall tracing for seccomp tuning

© mohitmishra786 · MIT · mohitmishra786/low-level-dev-skills

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
systemd-services devops-skills Скилл systemd-services для Claude Code, Codex, Cursor и других платформ, который создаёт и настраивает systemd-юниты, таймеры и сокеты. Запускается при любой задаче, связанной с фоновыми службами Linux. CX Codex +1 600установок hardening-docker-containers-for-production mahipal Скилл hardening-docker-containers-for-production для Claude Code хардит Dockerfile, образы и настройки запуска контейнеров по CIS Docker Benchmark v1.8.0. Проверяет их через docker-bench-security, Hadolint и Dockle. CX Codex +1 373установок 706-technologies-containers-docker Juan Antonio Breña Moral Скилл 706-technologies-containers-docker помогает проверять и настраивать Docker-образы Java-проектов: от Dockerfile и jlink до безопасности и воспроизводимости сборки. CX Codex +1 225установок setup-docker-containers davila7 Команда setup-docker-containers настраивает Docker для разработки и production, включая multi-stage сборки, Compose и рабочие процессы контейнеров. CX Codex +1 740установок aws-containers aws Скилл aws-containers разворачивает контейнеры на AWS: EKS, ECS, Fargate, ECR и Elastic Beanstalk. Пригодится при деплое, отладке и оптимизации контейнерных сервисов. CX Codex +1 10 800установок deploying-containers-to-amazon-lightsail aws Скилл deploying-containers-to-amazon-lightsail для Claude Code разворачивает контейнеры в Amazon Lightsail Container Service и помогает разбирать сбои деплоя. Запускается для образа из Docker, публичного реестра или GitHub. CX Codex +1 900установок

Из того же набора140

Весь набор →
io-uring Скилл для работы с io_uring — новым API асинхронного ввода-вывода Linux. Пригодится при разработке высоконагруженных серверов, если нужно снизить количество системных вызовов и использовать передачу данных без копирования. CX Codex +1 361установок arm-sve Скилл arm-sve для работы со Scalable Vector Extension — расширением SIMD на процессорах ARM. Помогает писать код, который адаптируется к разной длине векторов на Graviton, Apple M4 и других AArch64 серверах. CX Codex +1 361установок af-xdp Настраивает сокеты AF_XDP и память UMEM для скоростной обработки сетевых пакетов в userspace. Пригодится при написании фильтров трафика и балансировщиков. CX Codex +1 359установок triton-lang Скилл triton-lang учит агента писать GPU-ядра на Triton: @triton.jit, блочные tl.load/tl.store с масками, атомарные операции, автотюнинг и интеграцию в PyTorch. CX Codex +1 358установок rdma-verbs Скилл rdma-verbs для Claude Code — справочник по RDMA-программированию через libibverbs для InfiniBand и RoCE; в нём описаны настройка очередей, односторонняя запись и тесты perftest. CX Codex +1 356установок riscv-privileged Скилл riscv-privileged для разработки ядер и прошивок на RISC-V: работа с привилегированной архитектурой, режимами машины и супервизора, CSR регистрами, обработчиками ловушек, контроллерами PLIC и CLINT, OpenSBI. CX Codex +1 355установок mpi Помогает писать параллельные программы на MPI: настраивать вызовы процессов, неблокирующие операции, гибрид с OpenMP и запуск через mpirun. CX Codex +1 354установок verilog-basics-for-lowlevel Скилл verilog-basics-for-lowlevel учит читать RTL-код на Verilog: модули, тактирование, reset-логику, шинные протоколы. Нужен разработчикам драйверов и firmware, когда документация неясна, а поведение железа объясняет баги. CX Codex +1 345установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой