Lo que necesita el servidor
Basta un servidor o una VM: Ubuntu Server 26.04, 4 núcleos, 17 GiB de RAM, un segundo disco vacío y ningún puerto de entrada. La instalación comprueba cada punto de esta página antes de cambiar nada, e imprime la solución de cada uno que falla. Instala el nodo muestra cómo ejecutar solo esas comprobaciones, días antes de instalar.
El servidor
- Un servidor solo para el nodo.
detachbox-node-hostse ejecuta como root y lleva a cabo los comandos que firma el servidor de detachbox, así que el nodo lo ocupa entero. A su lado no corre nada del mismo tipo: ni Docker, ni LXD, ni un Incus o un cloudflared tuyos, ni otro pool de ZFS. La comprobación lista todo lo que encuentra con el comando que lo quita. - Ubuntu Server 26.04 LTS en x86_64 (amd64), arrancado con systemd y cgroup v2, con el sistema de archivos raíz en ext4 o xfs, no en ZFS. Una VM en tu hipervisor o en tu cuenta en la nube sirve igual que el hardware físico.
- 4 núcleos de CPU o más. Dos se quedan para el sistema; todos los demás ejecutan tus terminales.
- 17 GiB de RAM como mínimo absoluto; el nodo empieza a compensar a partir de 64 GiB. 8 GiB se quedan para el sistema y la construcción de la imagen base. La caché de ZFS ocupa un dieciseisavo de la RAM, redondeado hacia abajo a una potencia de dos, entre 1 y 16 GiB. Tus terminales reciben el resto, y la comprobación imprime el reparto para tu servidor.
- Secure Boot desactivado, o la clave de DKMS registrada. Ubuntu 26.04 trae ZFS 2.4.1, que pierde bloques escritos con deduplicación, así que el instalador compila OpenZFS 2.4.4 y su módulo del kernel en el servidor. Las cabeceras del kernel en ejecución tienen que estar en apt.
- Un reloj sincronizado (NTP, UDP 123). El nodo solo acepta las peticiones del servidor si llegan con menos de 60 segundos de diferencia con su propio reloj.
El disco
El pool de ZFS del nodo necesita un segundo disco, entero y vacío, de 100 GiB o más. El 70 % del pool pasa a ser el disco de tu cuenta. El resto guarda el disco de sistema de cada terminal, las imágenes base y el espacio libre que ZFS necesita para seguir rápido. El pool usa compresión lz4, deduplicación y autotrim.
El instalador rechaza un disco con tabla de particiones, sistema de archivos, etiqueta de LVM, RAID o ZFS, o cualquier cosa montada. Nunca destruye datos y no tiene opción para forzarlo. Si lo que hay en el disco no importa, límpialo tú antes:
sudo wipefs -a /dev/sdb # el disco que le das al pool
sudo zpool destroy <pool> # antes, si el disco pertenece a un pool de ZFS
La red
El nodo no necesita ningún puerto de entrada. Todas las conexiones que abre son salientes:
| Destino · puerto | Para qué |
|---|---|
api.detachbox.com · TCP 443 | El servidor de detachbox: registro, versiones de node-host, informes |
region1.v2.argotunnel.com, region2.v2.argotunnel.com · TCP y UDP 7844 | El Cloudflare Tunnel del nodo |
Tu mirror de apt, archive.ubuntu.com, security.ubuntu.com · TCP 80 o 443 | Paquetes de Ubuntu, en el servidor y en la imagen base |
pkgs.zabbly.com · TCP 443 | Paquetes de Incus |
pkg.cloudflare.com · TCP 443 | Paquetes de cloudflared |
github.com, release-assets.githubusercontent.com, api.github.com · TCP 443 | La versión de OpenZFS; herramientas de la imagen base |
images.linuxcontainers.org · TCP 443 | La imagen de Ubuntu sobre la que se construye la imagen base |
download.docker.com, deb.nodesource.com, cli.github.com, gitlab.com · TCP 443 | Docker, Node.js y las CLI de GitHub y GitLab en la imagen base |
registry.npmjs.org, cdn.playwright.dev · TCP 443 | Codex, pnpm, yarn, Playwright y su navegador |
downloads.claude.ai, astral.sh, mise.run · TCP 443 | Claude Code, uv y mise |
Tus servidores NTP (los de Ubuntu: ntp.ubuntu.com) · UDP 123 | El reloj |
s.appmaster.io · TCP 443 | Los informes de errores de node-host y del edge a detachbox. Opcional: el nodo funciona sin él, y las comprobaciones no lo prueban |
El nodo reconstruye su imagen base cada 6 horas, así que estos hosts siguen en uso después de la instalación.
Da a los terminales la misma salida a internet que tiene el portátil de un desarrollador: los agentes llaman a sus proveedores de modelos, y las compilaciones descargan de los registros de paquetes.
Deja pasar estos hosts sin inspección TLS. node-host y cloudflared solo aceptan certificados de autoridades públicas, y si algo en medio vuelve a firmar el tráfico, la comprobación nombra la autoridad que recibió.
Los navegadores de tus ingenieros llegan al panel en my.detachbox.com y api.detachbox.com, y a las direcciones propias del nodo bajo detachbox.dev, que lista Lo que alcanzan los terminales.
El token
La instalación necesita un token de registro que te da tu contacto en detachbox. Sirve para un servidor y una instalación. Un servidor tiene 7 días para registrarse con él, y una vez registrado, el token admite repeticiones de esa instalación durante 7 días más. Un token nuevo sustituye al anterior.