detachbox
Menü

Funktionen

Browser-TerminalTerminals-ModusBenachrichtigungenHandy und SpracheLimits-BoardAbo-RotationAgentenDockerPreviews und DateienSnapshotsVaultSSH

Anwendungsfälle

Refactorings über NachtParallele AgentenPR-FabrikAgenturen und FreelancerLange JobsAgenten vom HandyAbo-Limits im TeamStudierende und Indie-HackerDocker-Services
DokuSicherheitEnterprisePreiseAnmelden
Meine Box starten
SeitenPreview-URLs und geteilte Dateien

Preview-URLs und geteilte Dateien

Jeder Server, den deine Box auf 0.0.0.0 betreibt, bekommt eine eigene HTTPS-Adresse: https://<port>-<box>.detachbox.dev. Links sind anfangs privat für dich, und du machst einen Port öffentlich, wenn du ihn teilen willst. Dateien auf der Box bekommen eine zweite Adresse, mit Freigabelinks, die ohne Anmeldung funktionieren.

Previews von shipyard: Die Ports 3000, 5173 und 8080 sind unter eigenen HTTPS-Adressen auf detachbox.dev offen, Port 3000 öffentlich geteilt, die anderen privat für den Besitzer.

Einen Dev-Server im Browser öffnen

  1. Starte den Server auf 0.0.0.0 auf einem beliebigen Port von 1024 bis 65535.
  2. Öffne https://<port>-<box>.detachbox.dev. Ein Dev-Server auf Port 3000 der Box my-box öffnet sich unter https://3000-my-box.detachbox.dev.

Gängige Befehle, die auf 0.0.0.0 binden:

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 und Server-Sent Events funktionieren über die Preview. Die App sieht jede Anfrage so, als käme sie von localhost:<port>. Vite allowedHosts, Rails config.hosts, Django ALLOWED_HOSTS und Next.js im Dev-Modus brauchen keine Änderungen. Ein Request-Body darf bis zu 100 MB groß sein.

Die Agenten wissen das alles. Die gemeinsame AGENTS.md nennt ihnen die Preview-Adresse und die 0.0.0.0-Regel, also geben sie dir den Link, sobald ein Server läuft. Eine Seite, die der Agent auf localhost:<port> öffnet, kommt in deinem Browser als Preview-URL an.

Sehen, was die Box ausliefert

Öffne die Box und wähl Previews. Die Ansicht listet jeden lauschenden Port mit seinem Link, einem Kopier-Button und einem QR-Code. Sie prüft die Ports alle 10 Sekunden.

Ein Server auf localhost oder 127.0.0.1 zeigt eine Warnung: Der Link erreicht ihn nicht. Starte ihn auf 0.0.0.0 neu.

Ein Link, der nichts findet, zeigt statt eines Fehlers eine detachbox-Seite, zum Beispiel „Nothing is listening on port 3000 in my-box“. Auch eine gestoppte Box sagt das.

Wer eine Preview öffnen kann

Links sind anfangs privat. Nur du, angemeldet im Dashboard, kannst sie öffnen.

  • Der erste Aufruf läuft über my.detachbox.com, um zu prüfen, dass du es bist. Danach bleibt die Preview in diesem Browser 12 Stunden offen.
  • Jeder Port und jede Box hat ihren eigenen Pass. Ein geöffneter Port öffnet nie einen anderen.
  • Um eine private Preview am Handy zu öffnen, scann ihren QR-Code. Das Handy meldet sich zuerst bei detachbox an und öffnet dann den Port.

Eine Preview mit einem Kunden teilen

  1. Such auf Previews den Port.
  2. Wähl unter Wer Port 3000 öffnen kann den Punkt Öffentlich.
  3. Lies die Warnung in Port 3000 öffentlich machen? und wähl Öffentlich machen.
  4. Kopier den Link und schick ihn.

Jeder mit dem Link sieht jetzt, was der Port ausliefert, ohne Anmeldung. Die Änderung greift innerhalb von 5 Sekunden. Suchmaschinen werden angewiesen, öffentliche Seiten nicht zu indexieren, aber ein Link wandert: Chats, Screenshots, Browserverlauf.

Mach ihn jederzeit wieder privat. Innerhalb von 5 Sekunden öffnet sich der Link nur noch für dich. Eine Box hat bis zu 20 öffentliche Ports. Öffentliche Ports behalten ihre Adressen, solange die Box gestoppt ist. Ein Reset macht jeden Port wieder privat.

Eine Datenbank oder einen anderen TCP-Port erreichen

Preview-URLs transportieren nur HTTP. Für Postgres, Redis oder jeden rohen TCP-Port leitest du ihn über SSH weiter:

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

Dann verbindest du dich auf deinem Computer mit localhost:5432.

Dateien der Box im Browser öffnen

Jede Box hat außerdem eine Datei-Adresse: https://files-<box>.detachbox.dev/<absolute path>. Sie liefert jede Datei aus, die der Benutzer dev lesen kann, bis 1 GiB. Die Anmeldung funktioniert wie bei Previews.

  • Öffne einen Test-Coverage-Report oder einen dist-Ordner als Website. Lass die URL mit einem / am Ende auf den Ordner zeigen, und seine index.html lädt mit ihren relativen Assets.
  • Ein HTML-Report mit Assets daneben, etwa report.html plus report_files/, öffnet sich als Ordner.
  • Assets auf absoluten Pfaden wie /assets/app.js laden nicht. Für einen Vite-Build setzt du base: './'.

Der Button Gerendert öffnen im Datei-Viewer öffnet eine HTML-Datei unter dieser Adresse. Die Terminal-Anleitung erklärt den Viewer.

Eine Datei ohne Anmeldung teilen

  1. Öffne die Datei aus dem Terminal: ⌘-Klick oder Ctrl-Klick auf ihren Pfad, oder am Handy antippen.
  2. Wähl im Viewer Link teilen.
  3. Wähl unter Der Link gilt für den Punkt 15 Minuten, 1 Stunde, 1 Tag oder 7 Tage.
  4. Wähl Link erstellen und dann Link kopieren.

Jeder mit dem Link kann genau diese eine Datei herunterladen, ohne Konto. Der Link hört auf zu funktionieren, wenn seine Zeit um ist.

Previews listet deine Links unter Geteilte Dateien. Jede Zeile zeigt, wann der Link abläuft und wie oft er geöffnet wurde.

  • Wähl Widerrufen, um einen Link zu beenden. Er funktioniert innerhalb von 5 Sekunden nicht mehr.
  • Eine Box hat bis zu 50 aktive Links. Widerruf einen, den du nicht mehr brauchst, um Platz zu schaffen.
  • Ein Reset widerruft jeden Link der Box. Ein Klon startet ohne Links.

Mehr zur Datei-Adresse und zu Previews: /features/previews.