Одноразовая виртуальная машина с контейнером Ubuntu

Этот каталог собирает и запускает Docker-контейнер Ubuntu внутри одноразового гостя Ubuntu QEMU. PoC копируются в гостя и никогда не выполняются хост-скриптами.

Зависимости хоста

• Bash
• QEMU x86-64 и qemu-img
• curl
• Клиентские утилиты OpenSSH
• xorriso
• socat только при использовании VM_PAYLOAD_CONSOLE=1

KVM используется, когда доступен; в противном случае QEMU переключается на TCG.

Сборка эталонного образа

UBUNTU_VERSION=26.04 \
VM_EXPECTED_KERNEL=7.0.0-31-generic \
./vm/build_image.sh

Сборщик скачивает облачный образ выбранного выпуска Ubuntu, проверяет его по опубликованному Ubuntu файлу SHA256SUMS, устанавливает обновления пакетов и Docker, загружает соответствующий образ контейнера Ubuntu и записывает vm/ubuntu-<version>.qcow2.

URL-адреса по умолчанию привязаны к последним официальным образам выпусков, доступным на 16 сентября 2026 года:

• Ubuntu 24.04: серийный номер выпуска 20260911
• Ubuntu 26.04: серийный номер выпуска 20260823

Задайте UBUNTU_RELEASE_URL, UBUNTU_IMAGE_URL или UBUNTU_SUMS_URL, чтобы использовать другой выпуск.

Сгенерированный образ qcow2 и SSH-ключ являются локальными артефактами, игнорируемыми Git. Закрытый ключ сохраняет режим 0600.

Запуск бинарного файла

UBUNTU_VERSION=26.04 \
VM_EXPECTED_KERNEL=7.0.0-31-generic \
./vm/run_container.sh ./path/to/binary [arguments...]

Каждый запуск создаёт временный оверлей qcow2, загружает гостя, копирует бинарный файл по SSH и запускает его в свежем контейнере с отключённой сетью. Аргументы, стандартные потоки и код завершения передаются.

Запустите без бинарного файла, чтобы открыть интерактивную оболочку в свежем контейнере:

./vm/run_container.sh

Используйте --shell с бинарным файлом, чтобы скопировать его в гостя и смонтировать в /payload без выполнения:

./vm/run_container.sh --shell ./path/to/binary

Полезные переопределения:

VM_CPUS=4 VM_MEMORY_MB=4096 ./vm/run_container.sh ./binary
VM_SSH_PORT=2223 ./vm/run_container.sh ./binary
KEEP_VM_RUN_DIR=1 ./vm/run_container.sh ./binary

KEEP_VM_RUN_DIR=1 сохраняет оверлей и журналы в /tmp/ubuntu-container.*. Каждый вызов выполняет одну загрузку виртуальной машины и одну попытку запуска полезной нагрузки. Установите VM_PAYLOAD_CONSOLE=1 для полезной нагрузки, которая явно использует второй последовательный порт гостя.