Laboratorio de aislamiento: código no confiable encerrado con namespaces, cgroups, seccomp y gVisor en una VM Ubuntu privada

Este laboratorio enseña a ejecutar código que no escribiste, como un script que produjo un agente de IA o un programa que subió un estudiante o un cliente, en una sola VM Ubuntu privada. Un sustituto inofensivo, agent.py, lee una clave, llama hacia fuera y arranca procesos, y el estudiante lo encierra con las propias herramientas del kernel de Linux, una cada vez. Un único script que escribe el estudiante, con todas las vallas a la vez, lo califica una comprobación con valores que el estudiante nunca ve.

No se instala nada en el ordenador del estudiante. Cada herramienta es la de verdad, instalada desde el archivo de Ubuntu: unshare y setpriv, cgroups v2, libseccomp, bubblewrap, nftables y runsc de gVisor. Todo es para defender: el único programa que se encierra es el del propio laboratorio, en la copia del propio estudiante.

Qué aprenden los estudiantes

Lo que puede hacer un código no confiable y cómo cada valla del kernel frena una parte. Los namespaces PID, de red, de montaje, UTS y de usuario ocultan los procesos, la red, los archivos y el poder de root. Un cgroup pone límites de memoria, de CPU y de procesos, y el estudiante ve al kernel matar a un programa a 64 MB y rechazar el proceso número veinte. Una lista de permitidos de seccomp rechaza toda llamada al sistema que no nombra, las capacidades se quitan con setpriv, una lista de nftables decide adónde puede conectarse el código y bubblewrap construye una vista de solo lectura con una carpeta oculta. Después gVisor responde las llamadas al sistema del programa en un kernel propio, y se explican las microVM de Firecracker.

Las seis partes

Primero el agente sin nada que lo frene. Segundo los namespaces hechos a mano con unshare. Tercero los cgroups, con sbx limit, una ayuda corta nuestra. Cuarto seccomp, con sbx seccomp, y las capacidades. Quinto la red, con sbx egress y una lista de permitidos en un archivo, los archivos con bubblewrap, y gVisor con runsc. Sexto run-agent.sh, el único script que escribe el estudiante, que debe frenar el secreto, la red, las escrituras fuera de una carpeta, la memoria por encima de 64 MB, más de 20 procesos y cualquier llamada al sistema que no esté en su lista. README.md en la carpeta personal dice qué hacer y no da ninguna respuesta.

Ejecútalo en tu navegador

Los laboratorios VM se ponen como tarea de laboratorio en un módulo, y el ejemplo está en la página del laboratorio. La máquina es pequeña: una CPU, 1 GB de memoria y 10 GB de disco. Todo viene del archivo de Ubuntu, así que la VM de un visitante, que solo llega a ese archivo, puede instalarlo.

  1. Añadir el laboratorio. En un módulo que enseñes, añade una tarea y elige la tarjeta de laboratorio VM Ubuntu. La página muestra una breve descripción de la máquina en lugar de un archivo compose.
  2. Empezar desde el ejemplo. La página ofrece laboratorios ya hechos para empezar. Elige Sandboxing. Usar un ejemplo reemplaza el texto, y Deshacer recupera el tuyo.
  3. Publicar e iniciar tu propia copia. Publica y luego pulsa Iniciar. El script setup del laboratorio instala bubblewrap, libseccomp, nftables y gVisor desde el archivo de Ubuntu y escribe la ayuda sbx, el agente sustituto, los archivos de trabajo y el README, la primera vez que arranca la VM, en unos minutos.
  4. Abrir el terminal. Abre su terminal y lee README.md en la carpeta personal. No se abre nada en el navegador: el laboratorio es el terminal.

Una lección básica en este laboratorio

Sandboxing Basics es una lección pequeña que se da en este laboratorio, una VM Ubuntu. Tiene un gancho, un objetivo «Puedo», palabras clave, una pregunta de partida, una comprobación después de cada idea, un error común y una comprobación final, y cada paso tiene un botón Ejecutar que escribe su comando en el terminal de la máquina. El estudiante ve al agente leer una clave y llamar hacia fuera, y luego le pone una valla cada vez: sin red, un límite de memoria, una lista de permitidos de seccomp y una carpeta oculta.

La lección echa un vistazo y deja al estudiante la tarea propia del laboratorio, el script con todas las vallas: por eso no da ninguna respuesta. El módulo universitario Aislar código no confiable y escrito por IA se trabaja en el mismo laboratorio.

Cómo se califica

El laboratorio tiene una comprobación. Se ejecuta sobre una copia de la máquina guardada, como root, y pone un programa suyo en lugar de agent.py. Ejecuta el run-agent.sh del estudiante una vez por prueba: el programa debe imprimir una palabra al azar con un filtro seccomp puesto, no imprimir nunca un secreto nuevo escrito en la carpeta de secretos, no alcanzar nunca un servicio que escucha en un puerto al azar, escribir un archivo con un nombre al azar en la única carpeta permitida y en ningún otro sitio, ser frenado antes de tener 200 MB o de arrancar 20 procesos, y ver rechazada una llamada al sistema peligrosa, elegida al azar entre cinco. La primera línea de lo que imprimió la comprobación dice por qué.

  1. Entregarlo. Asigna el laboratorio como cualquier tarea, con fecha límite si quieres. Cada estudiante recibe una VM propia, que se conserva entre sesiones.
  2. Ejecutar la comprobación. En la fila de un estudiante en la lista de la clase, pulsa Ejecutar la comprobación. Inicia una copia de su máquina guardada que no se vuelve a guardar, ejecuta como root el script de comprobación del laboratorio y muestra si pasó, qué imprimió y cuándo. Al estudiante no se le comunica el resultado.
  3. Calificarlo. Lee la primera línea de lo que imprimió la comprobación: dice qué no está bien, por ejemplo un agente que leyó el secreto, que alcanzó la red o que llegó a tener 200 MB, o una llamada al sistema que no se rechazó. Devuelve el trabajo con un motivo si necesita más.

La definición en GitHub

El archivo es toda la definición del laboratorio, el mismo texto que ejecuta la plataforma: tamaño, script setup, la ayuda sbx, el agente, los archivos de trabajo, el README y la comprobación. Cópialo y cambia los límites o el agente para hacer un laboratorio más largo.

Prueba este laboratorio, y lo que cuesta

Con una cuenta personal gratuita puedes seguir las lecciones básicas de este laboratorio, con crédito gratuito suficiente cada mes para seguir la mayoría de las lecciones y sin tarjeta. Para una clase, un centro tiene gratis sus primeros 365 días, hasta 50 alumnos, y después paga por alumno y año, con todos los laboratorios incluidos y el profesorado gratis.

Preguntas frecuentes

¿El laboratorio necesita licencia?
No. bubblewrap, libseccomp, nftables, util-linux y gVisor son de código abierto, con las licencias LGPL, GPL y Apache-2.0, y se instalan desde el archivo de Ubuntu cuando arranca la VM del estudiante, así que no distribuimos nada de ellos.
¿Por qué no se ejecuta Firecracker?
Firecracker necesita /dev/kvm dentro de la máquina en la que se ejecuta, y las VM de la plataforma no ofrecen virtualización anidada. Las lecciones explican las microVM y ejecutan gVisor, que no necesita KVM.
¿Pueden los estudiantes dañar algo?
Solo su propia copia. El programa que encierran es el sustituto del propio laboratorio, su clave es un valor de prueba y la red que alcanza está dentro de la VM. Si un estudiante estropea un archivo entregado, sbx reset lo deja como se entregó.
¿Se probó el laboratorio en una VM real de estudiante?
El script setup, los comandos de cada lección y la comprobación, con cada manera de engañarla, se ejecutaron en un contenedor Ubuntu 26.04 privilegiado que hace de VM, en una máquina arm64. Una VM de estudiante ya arrancada, con sus reglas de AppArmor y los paquetes amd64, merece una prueba antes de una clase.