detachbox
Menu

Recursos

Terminal no navegadorModo TerminaisNotificaçõesCelular e vozPainel de limitesAlternânciaAgentesDockerPreviews e arquivosSnapshotsVaultSSH

Casos de uso

Refatorações noturnasAgentes em paraleloFábrica de PRsAgências e freelancersJobs longosAgentes pelo celularLimites da equipeEstudantes e indie hackersServiços Docker
DocsSegurançaEnterprisePreçosEntrar
Iniciar meu box
PáginasURLs de preview e arquivos compartilhados

URLs de preview e arquivos compartilhados

Cada servidor que o seu box roda em 0.0.0.0 ganha um endereço HTTPS próprio: https://<port>-<box>.detachbox.dev. Os links começam privados para você, e você torna uma porta pública quando quiser compartilhar. Os arquivos do box ganham um segundo endereço, com links de compartilhamento que funcionam sem login.

Previews do shipyard: as portas 3000, 5173 e 8080 abertas, cada uma no seu endereço HTTPS em detachbox.dev, a porta 3000 compartilhada publicamente e as outras privadas para o dono.

Abra um servidor de desenvolvimento no navegador

  1. Inicie o servidor em 0.0.0.0, em qualquer porta de 1024 a 65535.
  2. Abra https://<port>-<box>.detachbox.dev. Um servidor de desenvolvimento na porta 3000 do box my-box abre em https://3000-my-box.detachbox.dev.

Comandos comuns que escutam em 0.0.0.0:

npm run dev -- --host 0.0.0.0
vite --host 0.0.0.0
next dev -H 0.0.0.0
python3 -m http.server 3000
rails s -b 0.0.0.0
uvicorn app:app --host 0.0.0.0

HTTPS, websockets, hot reload e server-sent events funcionam pelo preview. O app vê cada requisição como vinda de localhost:<port>. O allowedHosts do Vite, o config.hosts do Rails, o ALLOWED_HOSTS do Django e o modo dev do Next.js não precisam de mudança. O corpo de uma requisição vai até 100 MB.

Os agentes sabem de tudo isso. O AGENTS.md compartilhado passa a eles o endereço de preview e a regra do 0.0.0.0, então eles entregam o link quando um servidor sobe. Uma página que o agente abre em localhost:<port> chega ao seu navegador como URL de preview.

Veja o que o box está servindo

Abra o box e escolha Previews. A tela lista cada porta aberta com o link, um botão de copiar e um QR code. Ela confere as portas a cada 10 segundos.

Um servidor em localhost ou 127.0.0.1 mostra um alerta: o link não alcança esse servidor. Reinicie-o em 0.0.0.0.

Um link que não encontra nada mostra uma página do detachbox em vez de um erro, por exemplo "Nothing is listening on port 3000 in my-box". Um box parado também avisa.

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 e cada box tem o próprio passe. Abrir uma porta nunca abre outra.
  • Para abrir um preview privado no celular, escaneie o QR code dele. O celular entra no detachbox primeiro e depois abre a porta.

Compartilhe um preview com um cliente

  1. Em Previews, encontre a porta.
  2. Em Quem pode abrir a porta 3000, escolha Pública.
  3. Leia o alerta em Tornar a porta 3000 pública? e escolha Tornar pública.
  4. Copie o link e mande.

Agora qualquer pessoa com o link vê o que a porta serve, sem login. A mudança vale em até 5 segundos. Os buscadores são instruídos a não indexar páginas públicas, mas um link circula: chats, prints, histórico do navegador.

Torne a porta privada de novo quando quiser. Em até 5 segundos, o link volta a abrir só para você. Um box mantém até 20 portas públicas. As portas públicas mantêm os endereços enquanto o box está parado. Um reset torna todas as portas privadas de novo.

Acesse um banco de dados ou outra porta TCP

As URLs de preview só carregam HTTP. Para Postgres, Redis ou qualquer porta TCP pura, encaminhe a porta por SSH:

ssh -N -L 5432:localhost:5432 <box>@ssh.detachbox.com

Depois conecte em localhost:5432 no seu computador.

Abra arquivos do box no navegador

Cada box também tem um endereço de arquivos: https://files-<box>.detachbox.dev/<absolute path>. Ele serve qualquer arquivo que o usuário dev consiga ler, até 1 GiB. O login funciona do mesmo jeito que nos previews.

  • Abra um relatório de cobertura de testes ou uma pasta dist como site. Aponte a URL para a pasta com uma / no final, e o index.html dela carrega com os recursos relativos.
  • Um relatório HTML com recursos ao lado, como report.html mais report_files/, abre como pasta.
  • Recursos em caminhos absolutos, como /assets/app.js, não carregam. Num build do Vite, defina base: './'.

O botão Abrir renderizado do visualizador de arquivos abre um arquivo HTML nesse endereço. O guia do terminal explica o visualizador.

Compartilhe um arquivo sem login

  1. Abra o arquivo pelo terminal: ⌘-clique ou Ctrl-clique no caminho, ou toque nele no celular.
  2. No visualizador, escolha Compartilhar link.
  3. Em O link funciona por, escolha 15 minutos, 1 hora, 1 dia ou 7 dias.
  4. Escolha Criar o link e depois Copiar link.

Qualquer pessoa com o link pode baixar aquele arquivo, sem precisar de conta. O link para de funcionar quando o tempo acaba.

Previews lista os seus links em Arquivos compartilhados. Cada linha mostra quando o link expira e quantas vezes foi aberto.

  • Escolha Revogar para encerrar um link. Ele para de funcionar em até 5 segundos.
  • Um box mantém até 50 links ativos. Revogue um que você não usa mais para abrir espaço.
  • Um reset revoga todos os links do box. Um clone começa sem nenhum.

Mais sobre o endereço de arquivos e os previews: /features/previews.