URL de vista previa

Abre en tu navegador lo que construyó el agente, revísalo en el teléfono o mándaselo a un cliente. Cada servidor que un terminal ejecuta en 0.0.0.0 recibe su propia dirección HTTPS: https://<port>-<terminal ID>.detachbox.dev. Los enlaces nacen privados para ti, y haces público un puerto cuando quieres compartirlo. Las vistas previas pertenecen a su terminal: sobreviven a un reinicio del terminal y terminan cuando lo finalizas.

Abre un servidor de desarrollo en tu navegador

1. Arranca el servidor en 0.0.0.0, en cualquier puerto del 1024 al 65535.
2. En la barra del terminal, elige Archivos y vistas previas. Vistas previas lista el puerto con su enlace.

npm run dev -- --host 0.0.0.0
python3 -m http.server 3000 --bind 0.0.0.0

HTTPS, websockets y la recarga en caliente funcionan a través de la vista previa. Dos terminales pueden ejecutar servidores en el mismo puerto: cada uno responde en la dirección de su propio terminal. El AGENTS.md compartido enseña a los agentes la regla de 0.0.0.0, así que te pasan el enlace en cuanto un servidor arranca.

Tu servidor de desarrollo no necesita ajustes de host

Tu servidor ve cada petición como si viniera de un navegador en la misma computadora: el host es localhost:<port>, y el origen y el referer coinciden con él. allowedHosts de Vite, config.hosts de Rails, ALLOWED_HOSTS de Django y los orígenes de desarrollo de Next.js lo aceptan tal cual.

Los server-sent events y otras respuestas en streaming pasan a medida que llegan, y una petición puede llevar hasta 100 MiB, suficiente para subir archivos a tu app.

Mira lo que sirve un terminal

El panel Vistas previas de la página Archivos y vistas previas de un terminal lista cada puerto en escucha con el programa que escucha en él, su enlace, un botón para copiarlo, otro para abrirlo y un código QR. Revisa los puertos cada 10 segundos.

• Un servidor en localhost o 127.0.0.1 recibe un aviso y un enlace tachado: la vista previa no llega a él, así que reinícialo en 0.0.0.0.
• Un puerto público sin nada detrás sigue en la lista: su enlace responde en cuanto un servidor vuelve a arrancar en ese puerto.
• Si todavía no escucha nada, el panel muestra comandos para arrancar un servidor en 0.0.0.0, cada uno con un botón para copiarlo.

Consigue el enlace desde el terminal

detachbox-preview 3000 imprime la dirección de vista previa del puerto 3000, y detachbox-preview 3000 /admin le añade una ruta. Avisa cuando el servidor solo escucha en localhost o cuando todavía no escucha nada. detachbox-open http://localhost:3000 abre esa misma dirección en tu navegador.

Quién puede abrir una vista previa

Los enlaces nacen privados. Solo tú, con la sesión iniciada en el panel, puedes abrirlos.

• La primera visita pasa por my.detachbox.com para comprobar que eres tú. Después, la vista previa queda abierta en ese navegador durante 12 horas.
• Cada puerto tiene su propio pase. Abrir un puerto nunca abre otro.
• Una vista previa privada solo acepta peticiones de sus propias páginas. Otro sitio no puede pedirla, abrir su websocket ni meterla en un marco para desviar tus clics.
• Se pide a los buscadores que no indexen ninguna vista previa, ni pública ni privada.

Abre una vista previa en el teléfono

Escanea el código QR del puerto en Archivos y vistas previas con la cámara del teléfono. Con un puerto privado, el teléfono inicia sesión en detachbox primero y luego abre la página. Un puerto público se abre para cualquiera que escanee el código.

Comparte una vista previa con un cliente

1. En la página Archivos y vistas previas del terminal, busca el puerto en Vistas previas.
2. En Quién puede abrir el puerto 3000, elige Público.
3. Lee el aviso de ¿Hacer público el puerto 3000? y elige Hacer público.
4. Copia y envía el enlace, o deja que tu cliente escanee el código QR.

Cualquiera con el enlace ve ahora lo que sirve el puerto, sin iniciar sesión, también quien lo copie de un chat, de una captura o del historial del navegador. Vuelve a hacer privado el puerto cuando quieras, y el enlace se cierra al momento para todos los demás. Una página que alguien ya tenga abierta mantiene su conexión en vivo hasta que se recargue.

Un terminal puede tener hasta 20 puertos públicos. Un puerto público sigue siéndolo tras un reinicio del terminal.

Cuando una vista previa no se abre

Un enlace que se abre pero muestra un error de tu servidor es la respuesta de tu servidor: lee su log en el terminal.

Llega a una base de datos u otro puerto TCP

Las URL de vista previa llevan HTTP. Ejecuta los clientes de base de datos en el terminal, junto a la base: psql, redis-cli, sqlite3 y el cliente de MariaDB vienen instalados. Guarda los datos de la base en un bind mount bajo la carpeta del proyecto, y duran más que el terminal.