Bubblewrap (bwrap)

17 ноября 2026 · ~14 мин чтения

инструмент linux безопасность изоляция devops

Bubblewrap (bwrap)

Bubblewrap (bwrap) — это сверхлёгкая утилита командной строки для Linux, которая за единицы миллисекунд создаёт одноразовую изолированную песочницу вокруг запускаемой программы на базе механизмов ядра, без фонового сервиса-демона и прав администратора.

История

История Bubblewrap начинается в 2016 году в компании Red Hat. Инженеры Александер Ларссон (Alexander Larsson) и Колин Уолтерс (Colin Walters) развивали инициативу Project Atomic — стек для атомарно обновляемых серверных систем (rpm-ostree) и универсальных настольных пакетов (xdg-app, которые вскоре переименовали в Flatpak). Обоим проектам требовался один и тот же надёжный кирпичик: крошечный, легко проверяемый аудиторами инструмент, способный запирать произвольную программу в изолированном окружении.

Контекст эпохи был непростым. В 2013 году в ядре Linux 3.8 появились unprivileged user namespaces (непривилегированные пользовательские пространства имён). Они позволили обычному пользователю создавать изолированный «мини-мир», где процесс считает себя root (суперпользователем), не получая власти над системой. Но новая подсистема открыла огромную поверхность атаки: через неё можно было дотянуться до участков кода ядра, ранее доступных только администратору. Из-за волны уязвимостей дистрибутивы Debian и Red Hat Enterprise Linux (RHEL) отключили эту возможность по умолчанию.

Тянуть ради одного браузера или генератора миниатюр целый Docker с его тяжёлым daemon (фоновый процесс-диспетчер) было избыточно. Весной 2016 года Ларссон и Уолтерс объединили код xdg-app-helper и идеи linux-user-chroot, выпустив Bubblewrap 0.1.0 как самостоятельный проект. При отключённых пользовательских пространствах имён он работал через минималистичный SUID-бинарник (исполняемый файл с правами root, сбрасывающий привилегии сразу после настройки изоляции), а при включённых — вообще без повышенных прав.

Дальнейшее развитие принесло три важные вехи:

Сейчас Bubblewrap — открытый проект на языке C из нескольких тысяч строк кода под лицензией LGPLv2+, поддерживаемый сообществом containers (инженеры Red Hat, Collabora, GNOME и Debian).

Что это такое

Bubblewrap — это конструктор одноразовых изолированных сред на уровне одного дерева процессов Linux. Ты не скачиваешь гигабайтные образы, не настраиваешь виртуальные сети и не держишь в памяти фоновый демон. Вместо этого одной строкой в терминале ты задаёшь границы: «Запусти вон тот скрипт, покажи ему системную папку /usr только на чтение, открой на запись лишь папку текущего проекта, скрой все личные файлы, выключи интернет и убей процесс, если закроется родительская программа».

Вся капсула собирается за 3–10 миллисекунд и бесследно исчезает в ту же долю секунды, когда команда завершается. Утилита ничего не оставляет на диске — отсюда и название Bubblewrap («пузырчатая плёнка»).

Не замена упаковщику образов

Bubblewrap — не система доставки софта, как Docker. Он не несёт внутри другую операционную систему с отдельным набором пакетов, а за миллисекунды собирает «ограниченный вид» на ту систему, которая уже установлена на твоём сервере или ноутбуке.

Чтобы место bwrap стало совсем понятным, сравним его с тремя привычными инструментами:

Аналогии из жизни

Проще всего прочувствовать механику Bubblewrap через три разные аналогии из реального мира.

1. Стерильный перчаточный бокс в лаборатории. Представь биолога, который работает с неизвестным реактивом внутри герметичной камеры из оргстекла с воздушным шлюзом. Внутрь положили ровно две пробирки и пинцет. Из резиновых перчаток невозможно дотянуться ни до полок в комнате, ни до соседних столов. Закончили опыт — камеру прожгли ультрафиолетом, и от неё не осталось следа.
- Где работает: идеально передаёт минимальную видимость каталогов (--ro-bind для инструментов, --bind для одной рабочей папки) и полную одноразовость среды.
- Где ломается: если в самой лаборатории одна общая вентиляция (аналог общего ядра Linux), то летучий газ уровня zero-day (уязвимости нулевого дня) в этой вентиляции пройдёт мимо стеклянных стенок бокса.

2. Одноразовая переговорная комната в банке. К вам пришёл внешний подрядчик с задачей сверить договор. Вместо того чтобы пускать его в главный архив к клиентским досье, служба безопасности сажает его в пустую комнату без окон, розеток и городской линии связи. На стол кладут ксерокопии ровно двух папок и один черновик для пометок.
- Где работает: наглядно объясняет отключение сети (--unshare-net), скрытие соседних процессов (--unshare-pid) и заклеивание секретов вроде .ssh или .env поверх домашней папки.
- Где ломается: в жизни подрядчик в комнате не делит с директором одну кровеносную систему, а в Linux процессы внутри и снаружи всё же общаются с одним общим ядром ОС. И если ты сам оставил на столе служебный телефон с открытым корпоративным чатом — то есть пробросил внутрь живой сокет D-Bus или Docker, — двери без окон не спасут.

3. Декорации на пустой бетонной сцене. На огромной пустой площадке за пять минут ставят фанерный кабинет ровно с одним столом и дверью для короткой сцены, а сразу после финальной реплики разбирают его за три секунды. Для актёра этот кабинет — весь видимый мир.
- Где работает: хорошо иллюстрирует tmpfs (временную файловую систему в оперативной памяти) — пустой корень, к которому точечно прикручивают нужные ветки диска без копирования гигабайтов данных.
- Где ломается: в отличие от фанеры, у bwrap жёсткие ядерные замки, но актёр всё равно стоит на общем бетонном полу с залом: без внешних лимитов он способен перегрузить процессор или забить всю память здания.

Как это работает

За 3–10 миллисекунд между моментом, когда ты запускаешь bwrap ... -- python3 script.py, и выполнением первой строки кода под капотом проходят четыре чётких этапа:

1. Изоляция через clone() и unshare(). Утилита обращается к ядру через syscall (системный вызов к ядру ОС) clone() или unshare() и запрашивает свежие пространства имён Linux (namespaces). В зависимости от флагов отрезаются: таблица монтирования (mount), дерево процессов (pid — внутри капсулы виден только свой процесс с номером PID 1), сетевой стек (net — остаётся лишь локальная петля lo без выхода наружу), межпроцессное взаимодействие (ipc), имя хоста (uts), пользовательские идентификаторы (user) и контрольные группы (cgroup).

2. Сборка пустого корня в памяти и точечный проброс. В новом mount-пространстве bwrap монтирует пустую файловую систему tmpfs в оперативной памяти. В эту секунду программа не видит на диске вообще ничего. Затем через bind mount (зеркальное монтирование папки) bwrap без копирования байтов показывает нужные каталоги хоста: системные /usr, /lib и /bin подключаются строго на чтение (--ro-bind), папка проекта — на чтение и запись (--bind), а вместо системных директорий даётся изолированный --proc /proc и минимальный --dev /dev. Опасные директории с ключами вроде ~/.ssh легко накрыть пустым --tmpfs, чтобы процесс видел там пустоту.

3. Полная замена корня через pivot_root(). Собрав карту каталогов, bwrap вызывает pivot_root(), переключая корневой каталог процесса на свежесобранную tmpfs, и следом вызывает umount2() с флагом MNT_DETACH, чтобы окончательно отцепить старый корень хоста. Обратной дороги на настоящий диск больше не существует.

4. Запирание дверей изнутри. Перед передачей управления целевой программе (execve) bwrap сбрасывает все capabilities (мандатные привилегии Linux — дробные права суперпользователя), через prctl() ставит необратимый флаг ядра PR_SET_NO_NEW_PRIVS (запрещая любое повышение привилегий даже через SUID-файлы), при необходимости загружает фильтр вызовов seccomp (белый список системных вызовов ядра), отвязывает процесс от терминала (--new-session) и вешает --die-with-parent, чтобы при смерти родителя ядро мгновенно уничтожило всю песочницу.

bwrap \
  --ro-bind /usr /usr \
  --ro-bind /lib /lib \
  --ro-bind /lib64 /lib64 \
  --bind ./project /workspace \
  --tmpfs /tmp \
  --proc /proc \
  --dev /dev \
  --unshare-all \
  --die-with-parent \
  --new-session \
  --chdir /workspace \
  -- python3 analyze.py
[ Хост Linux: /home/user/.ssh, сеть eth0, все PID ]
                 |  clone() + pivot_root()
                 v
[ Капсула bwrap: tmpfs в RAM, нет сети, NO_NEW_PRIVS ]
  /usr, /lib  <- только чтение (--ro-bind)
  /workspace  <- запись только в ./project
  /proc, /dev <- минимальные, чужих PID не видно

Не прокидывай внутрь «отмычки»

Песочница мгновенно теряет смысл, если ты сам смонтируешь внутрь сокет Docker (/var/run/docker.sock), полную шину рабочего стола D-Bus или X11-сокет: через них программа попросит хост выполнить команду снаружи и легко выйдет за пределы капсулы.

Где встречается в обычной жизни

Даже если ты никогда не работал в консоли Linux, ты почти наверняка сталкивался с Bubblewrap в популярных продуктах:

Где встречается в IT и бизнесе

В коммерческой разработке и инфраструктуре bwrap закрывает целый класс задач, где Docker или виртуальная машина оказываются слишком неповоротливыми:

Сочетай bwrap с контролем ресурсов

bwrap изолирует видимость файлов, процессов и сети, но не ограничивает аппетиты программы по CPU и оперативной памяти. В продакшене оборачивай его в systemd-run или cgroups (контрольные группы ядра) с лимитами, чтобы зависший скрипт не положил весь сервер.

Кто пользуется

Альтернативы и конкуренты

Когда НЕ стоит использовать

  1. Жёсткий multi-tenant (мультитенантный режим) для враждебного кода. Запускать произвольные бинарники от анонимных пользователей интернета рядом с продовой базой данных через один bwrap опасно, потому что ядро Linux остаётся общим и любая свежая уязвимость zero-day в ядре пробивает пространства имён — здесь нужны Firecracker microVM, gVisor или отдельные ВМ.
  2. Кроссплатформенная разработка без Linux. Нативно на macOS и Windows bwrap не запускается, потому что у ядра XNU и Windows просто нет Linux-механизмов user namespaces и pivot_root (на Mac используют встроенный sandbox-exec / Seatbelt или поднимают Linux-виртуалку).
  3. Фиксация версий библиотек при деплое. Если нужно гарантировать абсолютно одинаковые версии Python, glibc и системных утилит на ноутбуке и сервере, выбирай Docker или Podman, потому что bwrap не хранит образы, а монтирует окружение хоста.

Связанные понятия

Литература и источники

Где встретилось у меня

Вчера при раскатке и боевой проверке серверного конвейера внутри виртуальной машины настраивалась изоляция запуска внешнего CLI ИИ-агента через bwrap в связке с профилем AppArmor (чтобы разрешить непривилегированные пространства имён на свежей Ubuntu и жёстко ограничить процессу доступ к файловой системе и портам), а затем через эту песочницу прогонялись контрольные smoke-запросы. При сборе вчерашних логов сработала отсечка по объёму ([...достигнут лимит вывода]), поэтому понятие выбиралось по дошедшей части контекста, где bwrap всё равно уверенно стал лидером дня с 74 упоминаниями.

Краткое резюме