Projetez votre terminal
Termbridge lance un serveur local, le rend accessible via Cloudflare et diffuse votre session tmux dans n’importe quel navigateur.
npx termbridgeDernière version 0.3.13 MIT Node 20+, tmux, cloudflared
# Create a tmux session and start the agent
tmux new-session -d -s claude "claude"
# Then attach Termbridge to it
termbridge --session claudeEn pratique
Lancez-le sur votre ordinateur, puis ouvrez le terminal sur un autre appareil.
De votre ordinateur portable à votre téléphone
npx termbridge lance un serveur local, une session tmux et un tunnel Cloudflare, puis affiche un code QR accompagné d’un lien de connexion à usage unique.
Le scan du code échange le jeton contre une session par cookie. Ajoutez --proxy 5173 pour afficher votre serveur de développement dans une vue d’aperçu à côté du terminal.
npx termbridge# Start your Vite app first
cd my-app && npm run dev # runs on port 5173
# Then start Termbridge with proxy
termbridge --proxy 5173Prêt pour mobile
Scannez le code QR et ouvrez votre terminal dans le navigateur de votre téléphone.
Un vrai terminal
tmux et node-pty connectent un vrai PTY à xterm.js, avec couleurs et interfaces en mode texte.
Tunnel Cloudflare
Quick Tunnel expose votre serveur local sans redirection de port.
Connexion par jeton
Le lien QR contient un jeton à usage unique valable 90 secondes. Son utilisation crée un cookie de session HttpOnly et Secure, avec des vérifications CSRF et une limite de 5 utilisations par minute. Les sessions n’expirent pas.
Sessions multiples
Un serveur peut héberger plusieurs sessions tmux et permettre de passer de l’une à l’autre dans l’application.
Une seule commande
npx termbridge lance le serveur, le tunnel Cloudflare et le code QR. Nécessite Node 20+, tmux et cloudflared sur macOS ou Linux ; Windows n’est pas pris en charge.
Priorité au CLI
Conçu d’abord comme un outil de terminal, avec l’état TTY et une sortie QR.
Connexion par QR
Chaque exécution affiche un code QR et un lien de connexion à usage unique. Scannez-le avec l’appareil que vous souhaitez utiliser.
Aperçu du serveur de développement
Faites passer votre application Vite locale par un proxy et affichez-la à côté du terminal.
Relais HMR
Le proxy WebSocket assure le bon fonctionnement du Hot Module Replacement de Vite.
Changement de vue
Passez du terminal à l’aperçu depuis la feuille Views de la barre du bas.
Flux de travail full-stack
Exécutez des commandes dans le terminal et observez votre application se mettre à jour en temps réel.
Pourquoi Termbridge
Sans redirection de port ni VPN
Un tunnel Quick Tunnel Cloudflare sans compte attribue à votre serveur local un HTTPS URL public. L’appareil utilisé pour vous connecter a seulement besoin d’un navigateur.
Les programmes en plein écran fonctionnent
node-pty se connecte à tmux et annonce un terminal couleur 256, afin que les interfaces en mode texte comme htop et vim se comportent comme en local.
Les sessions survivent au relais
Ctrl+C ferme le tunnel et le serveur, mais laisse vos sessions tmux en cours d’exécution. Redémarrez avec --session pour vous rattacher à une session existante.
S’exécute sur votre machine
Le serveur, le WebSocket et le registre des terminaux se trouvent sur votre ordinateur et écoutent par défaut sur 127.0.0.1. Termbridge n’exploite aucun backend.
Comparaison avec
D’autres moyens d’accéder à un terminal depuis un autre appareil, et ce qui distingue Termbridge.
| Outil | Idéal pour | Différence avec Termbridge |
|---|---|---|
| ttyd | Idéal pourttyd partage n’importe quelle commande sur le Web avec la saisie CJK et IME, le transfert de fichiers ZMODEM et trzsz, les images Sixel, SSL et l’authentification de base. Il fonctionne sur macOS, Linux, les BSD, OpenWrt et Windows. | Différence avec TermbridgeTermbridge ajoute le tunnel, un lien de connexion QR à usage unique et une barre de commandes pour téléphone, et conserve le shell dans tmux pour qu’il survive à un redémarrage. Il est conçu pour macOS et Linux. |
| sshx | Idéal poursshx partage un terminal avec n’importe qui en une commande, sur un canevas infini où les collaborateurs voient leurs curseurs respectifs, avec chiffrement de bout en bout et des exécutables pour Linux, macOS et Windows. | Différence avec TermbridgeTermbridge permet d’accéder à votre propre terminal : chaque exécution génère un lien de connexion à usage unique, et le trafic passe par un tunnel Cloudflare jusqu’au serveur sur votre machine. |
| Tailscale SSH | Idéal pourTailscale SSH laisse Tailscale gérer l’authentification et l’autorisation des connexions SSH dans votre réseau tailnet, chiffrées via WireGuard avec des clés de nœud, depuis tout appareil exécutant Tailscale. | Différence avec TermbridgeTermbridge ne nécessite ni client ni réseau privé sur l’autre appareil. Il vous fournit un URL public et un code QR ; le terminal s’ouvre dans le navigateur. |
Sources, coché
Questions et réponses
Réponses courtes issues de la documentation de Termbridge.
En mode par défaut, il passe par un Quick Tunnel Cloudflare avant d’atteindre le serveur Termbridge sur votre ordinateur. Termbridge n’exploite aucun backend. En mode bac à sable Daytona, le terminal s’exécute dans un bac à sable de votre compte Daytona ; en mode direct, le serveur s’y exécute également et vous vous y connectez via le lien d’aperçu Daytona.
Le lien QR contient un jeton à usage unique, valable 90 secondes. Son utilisation crée un cookie de session HttpOnly, et les connexions WebSocket du terminal nécessitent également un jeton CSRF. Ne partagez pas le code QR ni le URL avec des personnes en qui vous n’avez pas confiance.
Oui. Définissez TERMBRIDGE_SESSIONS=3 pour démarrer trois sessions tmux, puis passez de l’une à l’autre avec le sélecteur de terminal de l’application.
Pas officiellement. Termbridge est conçu pour macOS et Linux. Cela peut fonctionner avec WSL, mais ce n’est pas testé.
Pas encore. Cloudflare est le seul fournisseur de tunnels. Vous pouvez utiliser un tunnel Cloudflare nommé avec votre propre nom d’hôte, désactiver le tunnel et fournir votre propre URL public, ou utiliser le mode direct Daytona.
En mode local, la connexion dure tant que Termbridge est en cours d’exécution et se ferme lorsque l’ordinateur se met en veille ou que Termbridge se ferme. Vos sessions tmux restent actives : vous pouvez donc relancer Termbridge, scanner le nouveau code QR et vous rattacher avec --session. En mode direct Daytona, le serveur s’exécute dans le bac à sable.
Installez Node 20+, tmux et cloudflared, lancez npx termbridge et scannez le code QR pour ouvrir votre terminal dans le navigateur de votre téléphone.