URLs de preview

Abra no navegador o que o agente construiu, confira no celular ou mande para um cliente. Cada servidor que um terminal roda em 0.0.0.0 ganha o próprio endereço HTTPS: https://<port>-<terminal ID>.detachbox.dev. Os links começam privados para você, e você torna uma porta pública quando quiser compartilhá-la. Cada preview pertence a um terminal: seu endereço é mantido após uma reinicialização e deixa de funcionar quando você encerra o terminal.

Abra um servidor de desenvolvimento no navegador

1. Inicie o servidor em 0.0.0.0 em qualquer porta de 1024 a 65535.
2. Na barra do terminal, escolha Arquivos e prévias. Previews lista a porta com o link dela.

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

HTTPS, websockets e hot reload funcionam pelo preview. Dois terminais podem rodar servidores na mesma porta: cada um responde no endereço do próprio terminal. O AGENTS.md compartilhado ensina aos agentes a regra do 0.0.0.0, então eles passam o link a você quando um servidor sobe.

Seu servidor de desenvolvimento roda sem mexer no host

O seu servidor vê cada requisição como se viesse de um navegador no mesmo computador: o host é localhost:<port>, e a origem e o referrer correspondem a esse host. O allowedHosts do Vite, o config.hosts do Rails, o ALLOWED_HOSTS do Django e as origens de desenvolvimento do Next.js funcionam sem alterações.

Server-sent events e outras respostas em streaming passam conforme chegam, e uma requisição pode levar até 100 MiB, o bastante para uploads de arquivos no seu app.

Veja o que um terminal está servindo

O painel Previews na página Arquivos e prévias de um terminal lista cada porta em uso com o programa que a utiliza, o link, um botão de copiar, um botão de abrir e um QR code. Ele verifica as portas a cada 10 segundos.

• Um servidor em localhost ou 127.0.0.1 recebe um aviso e um link riscado: o preview não o alcança, então reinicie-o em 0.0.0.0.
• Uma porta pública sem nada nela continua na lista: o link volta a responder assim que um servidor sobe de novo naquela porta.
• Sem nada escutando ainda, o painel mostra comandos para subir um servidor em 0.0.0.0, cada um com um botão de copiar.

Pegue o link pelo terminal

detachbox-preview 3000 imprime o endereço de preview da porta 3000, e detachbox-preview 3000 /admin acrescenta um caminho. Ele avisa quando o servidor escuta só em localhost ou quando nada escuta ainda. detachbox-open http://localhost:3000 abre o mesmo endereço no seu navegador.

Quem pode abrir um preview

Os links começam privados. Só você, logado no painel, consegue abri-los.

• A primeira visita passa pelo my.detachbox.com para confirmar que é você. Depois, o preview fica aberto naquele navegador por 12 horas.
• Cada porta tem o próprio passe. Abrir uma porta nunca abre outra.
• Um preview privado só responde às próprias páginas. Outro site não consegue buscá-lo, abrir o websocket dele nem colocá-lo num frame para desviar seus cliques.
• Os buscadores são orientados a não indexar nenhum preview, público ou privado.

Abra um preview no celular

Escaneie o QR code da porta em Arquivos e prévias com a câmera do celular. Uma porta privada faz o celular entrar no detachbox primeiro e depois abre a página. Uma porta pública abre para qualquer pessoa que escanear o código.

Compartilhe um preview com um cliente

1. Na página Arquivos e prévias do terminal, encontre a porta em Previews.
2. Em Quem pode abrir a porta 3000, escolha Pública.
3. Leia o aviso em Tornar a porta 3000 pública? e escolha Tornar pública.
4. Copie o link, ou deixe o cliente escanear o QR code, e envie.

Qualquer pessoa com o link agora vê o que a porta serve, sem login, inclusive quem copiar o link de um chat, de uma captura de tela ou do histórico do navegador. Torne a porta privada de novo quando quiser, e o link fecha na hora para todos os outros. Uma página que alguém já tenha aberta mantém a conexão ao vivo até recarregar.

Um terminal pode ter até 20 portas públicas. Uma porta pública continua pública depois de uma reinicialização do terminal.

Quando um preview não abre

Se o link abrir com um erro do seu servidor, leia o log desse servidor no terminal.

Acesse um banco de dados ou outra porta TCP

As URLs de preview levam HTTP. Rode os clientes de banco no terminal ao lado do banco: psql, redis-cli, sqlite3 e o cliente MariaDB já vêm instalados. Guarde os dados do banco num bind mount na pasta do projeto, e eles sobrevivem ao terminal.