URL d’aperçu et fichiers partagés

Chaque serveur que votre box fait tourner sur 0.0.0.0 reçoit sa propre adresse HTTPS : https://<port>-<box>.detachbox.dev. Les liens sont privés au départ, réservés à vous, et vous rendez un port public quand vous voulez le partager. Les fichiers de la box ont une seconde adresse, avec des liens de partage qui fonctionnent sans connexion.

Ouvrir un serveur de dev dans votre navigateur

1. Lancez le serveur sur 0.0.0.0, sur n’importe quel port de 1024 à 65535.
2. Ouvrez https://<port>-<box>.detachbox.dev. Un serveur de dev sur le port 3000 de la box my-box s’ouvre à https://3000-my-box.detachbox.dev.

Commandes courantes qui écoutent sur 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, rechargement à chaud et server-sent events passent par l’aperçu. L’app voit chaque requête comme venant de localhost:<port>. Vite allowedHosts, Rails config.hosts, Django ALLOWED_HOSTS et Next.js en mode dev ne demandent aucune modification. Le corps d’une requête peut aller jusqu’à 100 MB.

Les agents savent tout cela. Le fichier commun AGENTS.md leur donne l’adresse d’aperçu et la règle du 0.0.0.0 : ils vous remettent le lien dès qu’un serveur tourne. Une page que l’agent ouvre sur localhost:<port> arrive dans votre navigateur sous forme d’URL d’aperçu.

Voir ce que sert la box

Ouvrez la box et choisissez Aperçus. La vue liste chaque port en écoute avec son lien, un bouton de copie et un QR code. Elle vérifie les ports toutes les 10 secondes.

Un serveur sur localhost ou 127.0.0.1 affiche un avertissement : le lien ne peut pas l’atteindre. Relancez-le sur 0.0.0.0.

Un lien qui ne trouve rien affiche une page detachbox au lieu d’une erreur, par exemple « Rien n’écoute sur le port 3000 de my-box ». Une box arrêtée le signale aussi.

Qui peut ouvrir un aperçu

Les liens sont privés au départ. Vous seul, connecté au tableau de bord, pouvez les ouvrir.

• La première visite passe par my.detachbox.com pour vérifier que c’est bien vous. L’aperçu reste ensuite ouvert dans ce navigateur pendant 12 heures.
• Chaque port et chaque box a son propre laissez-passer. Ouvrir un port n’en ouvre jamais un autre.
• Pour ouvrir un aperçu privé sur votre téléphone, scannez son QR code. Le téléphone se connecte d’abord à detachbox, puis ouvre le port.

Partager un aperçu avec un client

1. Dans Aperçus, trouvez le port.
2. Sous Qui peut ouvrir le port 3000, choisissez Public.
3. Lisez l’avertissement de Rendre le port 3000 public ? et choisissez Rendre public.
4. Copiez le lien et envoyez-le.

Toute personne qui a le lien voit désormais ce que sert le port, sans connexion. Le changement prend effet en 5 secondes. Les moteurs de recherche ont consigne de ne pas indexer les pages publiques, mais un lien voyage : discussions, captures d’écran, historique du navigateur.

Repassez-le en privé à tout moment. En 5 secondes, le lien ne s’ouvre plus que pour vous. Une box garde jusqu’à 20 ports publics. Les ports publics gardent leur adresse pendant que la box est arrêtée. Une réinitialisation repasse tous les ports en privé.

Atteindre une base de données ou un autre port TCP

Les URL d’aperçu ne transportent que du HTTP. Pour Postgres, Redis ou tout port TCP brut, redirigez-le via SSH :

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

Connectez-vous ensuite à localhost:5432 sur votre ordinateur.

Ouvrir les fichiers de la box dans le navigateur

Chaque box a aussi une adresse de fichiers : https://files-<box>.detachbox.dev/<absolute path>. Elle sert tout fichier que l’utilisateur dev peut lire, jusqu’à 1 GiB. La connexion fonctionne comme pour les aperçus.

• Ouvrez un rapport de couverture de tests ou un dossier dist comme un site. Pointez l’URL sur le dossier avec un / final : son index.html se charge avec ses ressources relatives.
• Un rapport HTML accompagné de ses ressources, comme report.html plus report_files/, s’ouvre comme un dossier.
• Les ressources sur des chemins absolus, comme /assets/app.js, ne se chargent pas. Pour un build Vite, réglez base: './'.

Le bouton Ouvrir en tant que page de la visionneuse ouvre un fichier HTML à cette adresse. Le guide du terminal présente la visionneuse.

Partager un fichier sans connexion

1. Ouvrez le fichier depuis le terminal : ⌘-clic ou Ctrl-clic sur son chemin, ou touchez-le sur un téléphone.
2. Dans la visionneuse, choisissez Partager un lien.
3. Sous Le lien est valable, choisissez 15 minutes, 1 heure, 1 jour ou 7 jours.
4. Choisissez Créer le lien, puis Copier le lien.

Toute personne qui a le lien peut télécharger ce fichier, et lui seul, sans compte. Le lien cesse de fonctionner une fois le délai écoulé.

Gérer les liens partagés

Aperçus liste vos liens sous Fichiers partagés. Chaque ligne indique quand il expire et combien de fois il a été ouvert.

• Choisissez Révoquer pour mettre fin à un lien. Il cesse de fonctionner en 5 secondes.
• Une box garde jusqu’à 50 liens actifs. Révoquez-en un dont vous n’avez plus besoin pour faire de la place.
• Une réinitialisation révoque tous les liens de la box. Un clone démarre sans aucun lien.

Plus de détails sur l’adresse de fichiers et les aperçus : /features/previews.