Bubblewrap (bwrap)
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, сбрасывающий привилегии сразу после настройки изоляции), а при включённых — вообще без повышенных прав.
Дальнейшее развитие принесло три важные вехи:
- 2017 год, CVE-2017-5226. Выяснилось, что процесс внутри песочницы может вызвать
ioctl (системный вызов управления терминалом)с командойTIOCSTIи вбросить символы прямо в буфер ввода родительского терминала — фактически печатая команды снаружи после выхода. Вbwrapдобавили флаг--new-sessionна базеsetsid(), отрезающий управляющий терминал. - Переход в
containersи массовое внедрение. Проект переехал на GitHub в организациюcontainers/bubblewrapи стал основой для Valve Pressure Vessel (Steam и Steam Deck), GNOME и пакетного менеджера OCaml (opam). - 2024–2026 годы: ИИ-агенты и AppArmor в Ubuntu. С бумом консольных ИИ-агентов
bwrapстал стандартом нативной Linux-песочницы. Одновременно Ubuntu 23.10 и 24.04+ ограничили непривилегированные пространства имён черезAppArmor (мандатный контроль доступа по профилям программ), из-за чего подbwrapна свежей Ubuntu настраивают явный AppArmor-профиль.
Сейчас Bubblewrap — открытый проект на языке C из нескольких тысяч строк кода под лицензией LGPLv2+, поддерживаемый сообществом containers (инженеры Red Hat, Collabora, GNOME и Debian).
Что это такое
Bubblewrap — это конструктор одноразовых изолированных сред на уровне одного дерева процессов Linux. Ты не скачиваешь гигабайтные образы, не настраиваешь виртуальные сети и не держишь в памяти фоновый демон. Вместо этого одной строкой в терминале ты задаёшь границы: «Запусти вон тот скрипт, покажи ему системную папку /usr только на чтение, открой на запись лишь папку текущего проекта, скрой все личные файлы, выключи интернет и убей процесс, если закроется родительская программа».
Вся капсула собирается за 3–10 миллисекунд и бесследно исчезает в ту же долю секунды, когда команда завершается. Утилита ничего не оставляет на диске — отсюда и название Bubblewrap («пузырчатая плёнка»).
Не замена упаковщику образов
Bubblewrap — не система доставки софта, как Docker. Он не несёт внутри другую операционную систему с отдельным набором пакетов, а за миллисекунды собирает «ограниченный вид» на ту систему, которая уже установлена на твоём сервере или ноутбуке.
Чтобы место bwrap стало совсем понятным, сравним его с тремя привычными инструментами:
- Bubblewrap vs Docker / Podman. Контейнерные движки оперируют слоёными образами, реестрами, виртуальными сетевыми мостами и в классическом Docker — фоновым root-демоном. Это отличный способ упаковать микросервис, но тяжёлая пушка для одного скрипта.
bwrap— одиночный компактный бинарник без образов и демонов, оборачивающий уже лежащую на диске команду. - Bubblewrap vs виртуальные машины (QEMU/KVM, Lima). Виртуальная машина эмулирует железо и загружает отдельное
kernel (ядро ОС), стартует секунды и резервирует сотни мегабайт оперативной памяти.bwrapделит с хостом одно ядро Linux и почти ничего не стоит по RAM, но не умеет запускать Windows на Linux. - Bubblewrap vs классический
chroot (смена видимого корня каталогов). Старый Unix-механизмchrootподменяет только верхнюю папку, оставляя общими процессы, сеть и сокеты, требует правrootи не мешает привилегированному процессу выбраться наружу.bwrapизолирует все подсистемы через пространства имён,pivot_root (полная замена корня файловой системы)и необратимый ядерный замокPR_SET_NO_NEW_PRIVS.
Аналогии из жизни
Проще всего прочувствовать механику 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 в популярных продуктах:
- Программы из Flathub на Linux. Когда ты запускаешь Telegram, OBS Studio, Spotify или браузер, установленный через формат Flatpak, система при каждом клике по иконке сначала поднимает
bwrap. Приложение видит только разрешённые папки вроде «Загрузок», а не весь домашний каталог с паролями. - Превью картинок и PDF в GNOME Files (Nautilus). Когда ты открываешь папку со скачанными фото или документами в рабочем столе GNOME, генераторы миниатюр и фоновый индексатор LocalSearch (бывший Tracker) стартуют строго внутри
bwrapбез сети и права записи — чтобы специально повреждённый JPEG или PDF с эксплойтом не взломал компьютер. - Игры на Steam Deck и Steam для Linux. На портативной консоли Steam Deck от Valve миллионы игроков запускают Windows-игры через слой совместимости Proton. Чтобы игры разных эпох не ломались от обновлений системы, внутри Steam работает прослойка Pressure Vessel — модифицированный
bwrap, собирающий стабильное окружение Steam Runtime. - Автономные консольные ИИ-агенты. Встроенный режим песочницы в Claude Code на Linux запускает команды внутри
bwrap: агент может редактировать файлы репозитория и прогонять тесты, но физически не дотягивается до SSH-ключей и не ходит в сеть без разрешения.
Где встречается в IT и бизнесе
В коммерческой разработке и инфраструктуре bwrap закрывает целый класс задач, где Docker или виртуальная машина оказываются слишком неповоротливыми:
- Безопасное исполнение кода и bash-команд от LLM-агентов. Когда серверный ИИ-ассистент генерирует Python-скрипт для разбора таблицы или запускает консольную утилиту,
bwrapза миллисекунды ограничивает процесс временной рабочей папкой и отрезает выход в корпоративную сеть. - Онлайн-тренажёры и автопроверка кода (autograders). Платформы обучения программированию и олимпиадные платформы изолируют проверку сотен студенческих решений в минуту, не давая чужому коду прочитать эталонные тесты или соседние задания.
- Конвертация недоверенных пользовательских файлов на бэкенде. При обработке загруженных клиентами видео, изображений и документов через
FFmpeg,ImageMagick,GhostscriptилиLibreOffice headless (без графического интерфейса)запуск конвертера вbwrapстрахует сервер от классических уязвимостей в парсерах форматов. - Воспроизводимые сборки пакетов и CI-раннеры. Системы сборки вроде BuildStream и пакетный менеджер
opamзапускают шаги компиляции вbwrap, чтобы скрипт видел ровно объявленные зависимости, не цеплял случайные библиотеки хоста и не требовал раздачи опасногоdocker.sock.
Сочетай bwrap с контролем ресурсов
bwrap изолирует видимость файлов, процессов и сети, но не ограничивает аппетиты программы по CPU и оперативной памяти. В продакшене оборачивай его в systemd-run или cgroups (контрольные группы ядра) с лимитами, чтобы зависший скрипт не положил весь сервер.
Кто пользуется
- Red Hat, Fedora и Flathub. Тысячи настольных Linux-приложений и сотни миллионов загрузок через Flatpak ежедневно стартуют под защитой
bwrap. - Valve. Миллионы проданных консолей Steam Deck и десктопов со Steam на Linux опираются на
bwrapвнутри системы Pressure Vessel. - GNOME Foundation. Десятки миллионов рабочих станций Ubuntu, Fedora и Debian используют
bwrapпо умолчанию для генерации превью и индексации файлов. - Anthropic. Применяет
bwrapкак штатную Linux-песочницу для изоляции команд и файловых операций в Claude Code CLI. - Экосистема OCaml (
opam). Изолирует сценарии сборки пакетов на Linux с помощьюbwrap.
Альтернативы и конкуренты
- Firejail. Популярная десктопная песочница с готовой библиотекой из сотен профилей для браузеров, мессенджеров и офисных пакетов.
- Плюсы: работает «из коробки» одной короткой командой без ручного описания папок монтирования.
- Минусы: исторически построена как крупный монолитный SUID-бинарник на десятки тысяч строк C-кода и за годы накопила десятки уязвимостей
privilege escalation (повышения привилегий). - nsjail (от Google). Мощная серверная песочница для CTF-соревнований и систем проверки кода.
- Плюсы: объединяет пространства имён, лимиты
cgroups, таймеры жизни процесса и удобный язык описания правилKafel-seccompв одном конфиге. - Минусы: тяжелее в настройке для быстрых однострочников и реже встречается в стандартных репозиториях десктопных систем.
- gVisor (
runsc) и Firecracker microVM. Облачная изоляция с перехватом системных вызовов на Go (gVisor) или собственным микро-ядром на базе KVM (Firecracker). - Плюсы: обеспечивают настоящую границу безопасности даже от уязвимостей нулевого дня в хостовом ядре Linux при жёстком мульти-тенанте.
- Минусы: старт медленнее (десятки и сотни миллисекунд), выше расход памяти, заметно сложнее инфраструктура.
- Docker / Podman (в режиме rootless). Полноценные контейнерные движки стандарта OCI (Open Container Initiative).
- Плюсы: идеальны для доставки слоёных образов со своими версиями языков, библиотек и конфигураций сервисов.
- Минусы: избыточны, когда нужно за 5 миллисекунд безопасно обернуть уже установленный на сервере бинарник или скрипт.
Когда НЕ стоит использовать
- Жёсткий
multi-tenant (мультитенантный режим)для враждебного кода. Запускать произвольные бинарники от анонимных пользователей интернета рядом с продовой базой данных через одинbwrapопасно, потому что ядро Linux остаётся общим и любая свежая уязвимостьzero-dayв ядре пробивает пространства имён — здесь нужны Firecracker microVM, gVisor или отдельные ВМ. - Кроссплатформенная разработка без Linux. Нативно на macOS и Windows
bwrapне запускается, потому что у ядра XNU и Windows просто нет Linux-механизмовuser namespacesиpivot_root(на Mac используют встроенныйsandbox-exec/ Seatbelt или поднимают Linux-виртуалку). - Фиксация версий библиотек при деплое. Если нужно гарантировать абсолютно одинаковые версии Python,
glibcи системных утилит на ноутбуке и сервере, выбирай Docker или Podman, потому чтоbwrapне хранит образы, а монтирует окружение хоста.
Связанные понятия
- Linux Namespaces — механизм ядра Linux, дающий процессу изолированный вид на файлы, сеть, дерево процессов и пользователей.
- seccomp-bpf — фильтр ядра Linux, блокирующий запрещённые системные вызовы по заданному белому списку.
- AppArmor — система мандатного контроля доступа в Linux на основе профилей разрешений для программ.
- cgroups (Control Groups) — подсистема ядра Linux для учёта и жёсткого лимитирования CPU, памяти и ввода-вывода группы процессов.
- pivot_root — системный вызов полной замены корневой файловой системы процесса в текущем пространстве монтирования.
- Capabilities (мандатные привилегии Linux) — разбиение прав суперпользователя
rootна отдельные узкие разрешения, которые можно сбрасывать.
Литература и источники
- Официальный репозиторий: github.com/containers/bubblewrap (en) — исходный код, история релизов и документация флагов CLI.
- Документация Flatpak: docs.flatpak.org (en) — архитектура песочницы и порталов XDG поверх Bubblewrap.
- Справочник ядра Linux: man7.org/linux/man-pages/man7/namespaces.7.html и
user_namespaces(7)(en) — первоисточник по пространствам имён. - Container Security (Liz Rice, O'Reilly, 2020, en) — разбор пространств имён,
capabilities,pivot_rootиseccompпростым языком. - The Linux Programming Interface (Michael Kerrisk, No Starch Press, 2010, en) — классика по системным вызовам Linux; детали про CVE-2017-5226 и профили Ubuntu 24.04 ищи в Google по запросу
"CVE-2017-5226 TIOCSTI bubblewrap".
Где встретилось у меня
Вчера при раскатке и боевой проверке серверного конвейера внутри виртуальной машины настраивалась изоляция запуска внешнего CLI ИИ-агента через bwrap в связке с профилем AppArmor (чтобы разрешить непривилегированные пространства имён на свежей Ubuntu и жёстко ограничить процессу доступ к файловой системе и портам), а затем через эту песочницу прогонялись контрольные smoke-запросы. При сборе вчерашних логов сработала отсечка по объёму ([...достигнут лимит вывода]), поэтому понятие выбиралось по дошедшей части контекста, где bwrap всё равно уверенно стал лидером дня с 74 упоминаниями.
Краткое резюме
- Bubblewrap (
bwrap) — минималистичная утилита Linux, создающая одноразовую песочницу за миллисекунды без демона и правroot. - Изоляция строится на механизмах ядра Linux: пространства имён (
namespaces), пустойtmpfs,pivot_root, сбросcapabilitiesи флагPR_SET_NO_NEW_PRIVS. - В отличие от Docker и виртуальных машин,
bwrapне хранит образы и не поднимает отдельное ядро, а на лету пробрасывает нужные папки хоста. - Уже работает у миллионов пользователей в Flatpak, GNOME, Steam Deck (Pressure Vessel) и ИИ-агентах вроде Claude Code.
- Главное ограничение — общее ядро Linux: для враждебного мульти-тенанта нужны микро-ВМ, а для лимитов CPU и памяти —
cgroups.