Preview-URLs

Öffne im Browser, was der Agent gebaut hat, prüf es auf dem Handy oder schick es einem Kunden. Jeder Server, den ein Terminal auf 0.0.0.0 startet, bekommt dafür seine eigene HTTPS-Adresse: https://<port>-<terminal ID>.detachbox.dev. Links sind anfangs nur für dich offen, und du machst einen Port öffentlich, wenn du ihn teilen willst. Previews gehören zu ihrem Terminal: Einen Neustart des Terminals überstehen sie, und sie enden, wenn du es beendest.

Einen Dev-Server im Browser öffnen

1. Starte den Server auf 0.0.0.0 auf einem beliebigen Port von 1024 bis 65535.
2. Wähl in der Leiste des Terminals Dateien und Vorschauen. Previews listet den Port mit seinem Link.

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

HTTPS, Websockets und Hot Reload funktionieren durch die Preview. Zwei Terminals können Server auf demselben Port betreiben: Jeder antwortet unter der Adresse seines eigenen Terminals. Die gemeinsame AGENTS.md bringt Agenten die 0.0.0.0-Regel bei, also geben sie dir den Link, sobald ein Server läuft.

Dein Dev-Server braucht keine Host-Einstellungen

Dein Server sieht jede Anfrage so, als käme sie von einem Browser auf demselben Rechner: Der Host ist localhost:<port>, und Origin und Referrer passen dazu. allowedHosts von Vite, config.hosts von Rails, ALLOWED_HOSTS von Django und die Dev-Origins von Next.js nehmen sie an, wie sie ist.

Server-Sent Events und andere gestreamte Antworten gehen so durch, wie sie kommen, und eine Anfrage darf bis zu 100 MiB groß sein, genug für Datei-Uploads in deine App.

Sehen, was ein Terminal ausliefert

Das Panel Previews auf der Seite Dateien und Vorschauen eines Terminals listet jeden lauschenden Port mit dem Programm dahinter, seinem Link, einem Kopier-Button, einem Öffnen-Button und einem QR-Code. Es prüft die Ports alle 10 Sekunden.

• Ein Server auf localhost oder 127.0.0.1 bekommt eine Warnung und einen durchgestrichenen Link: Die Preview erreicht ihn nicht, also starte ihn auf 0.0.0.0 neu.
• Ein öffentlicher Port, auf dem nichts läuft, bleibt in der Liste: Sein Link antwortet, sobald wieder ein Server auf diesem Port startet.
• Lauscht noch nichts, zeigt das Panel Befehle, die einen Server auf 0.0.0.0 starten, jeden mit einem Kopier-Button.

Den Link aus dem Terminal holen

detachbox-preview 3000 gibt die Preview-Adresse von Port 3000 aus, und detachbox-preview 3000 /admin hängt einen Pfad an. Es warnt, wenn der Server nur auf localhost lauscht oder noch nichts lauscht. detachbox-open http://localhost:3000 öffnet dieselbe Adresse in deinem Browser.

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 hat seinen eigenen Pass. Ein geöffneter Port öffnet nie einen anderen.
• Eine private Preview antwortet nur ihren eigenen Seiten. Eine fremde Website kann sie nicht abrufen, nicht ihren Websocket öffnen und sie nicht in einen Frame packen, um deine Klicks umzulenken.
• detachbox weist Suchmaschinen an, keine Preview zu indexieren, ob öffentlich oder privat.

Eine Preview auf dem Handy öffnen

Scann den QR-Code des Ports unter Dateien und Vorschauen mit der Kamera des Handys. Bei einem privaten Port meldet sich das Handy zuerst bei detachbox an und öffnet dann die Seite. Ein öffentlicher Port öffnet sich für jeden, der den Code scannt.

Eine Preview mit einem Kunden teilen

1. Such auf der Seite Dateien und Vorschauen des Terminals den Port unter Previews.
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 ab, oder lass deinen Kunden den QR-Code scannen.

Jeder mit dem Link sieht jetzt, was der Port ausliefert, ohne Anmeldung, auch wer ihn aus einem Chat, einem Screenshot oder dem Browserverlauf kopiert. Mach den Port jederzeit wieder privat, und der Link ist sofort für alle anderen zu. Eine Seite, die schon bei jemandem offen ist, behält ihre Live-Verbindung, bis sie neu lädt.

Ein Terminal kann bis zu 20 öffentliche Ports haben. Ein öffentlicher Port bleibt über einen Neustart des Terminals hinweg öffentlich.

Wenn sich eine Preview nicht öffnet

Ein Link, der sich öffnet, aber einen Fehler deines Servers zeigt, ist die Antwort deines Servers: Lies sein Log im Terminal.

Eine Datenbank oder einen anderen TCP-Port erreichen

Preview-URLs transportieren HTTP. Starte Datenbank-Clients im Terminal neben der Datenbank: psql, redis-cli, sqlite3 und der MariaDB-Client sind installiert. Leg die Daten der Datenbank per Bind-Mount in deinen Projektordner, dann überdauern sie das Terminal.