Portate il vostro terminale su qualsiasi dispositivo
Termbridge avvia un server locale, lo collega tramite tunnel a Cloudflare e trasmette la vostra sessione tmux a qualsiasi browser.
npx termbridgeUltima versione 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 claudeNella pratica
Avviatelo sul computer, poi aprite il terminale su un altro dispositivo.
Dal portatile al telefono
npx termbridge avvia un server locale, una sessione tmux e un tunnel Cloudflare, poi stampa un codice QR con un link di accesso monouso.
Scansionando il codice, il token viene riscattato e convertito in una sessione cookie. Aggiungete --proxy 5173 per mostrare il vostro server di sviluppo in una vista Anteprima accanto al terminale.
npx termbridge# Start your Vite app first
cd my-app && npm run dev # runs on port 5173
# Then start Termbridge with proxy
termbridge --proxy 5173Pronto per il mobile
Scansionate il codice QR e aprite il terminale nel browser del telefono.
Un vero terminale
tmux + node-pty collegano una vera PTY a xterm.js, con colori e TUI.
Tunnel Cloudflare
Quick Tunnel espone il vostro server locale senza inoltro di porte.
Accesso con token
Il link QR contiene un token monouso valido per 90 secondi. Il suo riscatto imposta un cookie di sessione HttpOnly e Secure, con controlli CSRF e un massimo di 5 riscatti al minuto. Le sessioni non scadono.
Sessioni multiple
Un server può ospitare più sessioni tmux, tra cui passare nell'app.
Un solo comando
npx termbridge avvia il server, il tunnel Cloudflare e il codice QR. Richiede Node 20+, tmux e cloudflared su macOS o Linux; Windows non è supportato.
CLI Primo
Progettato come strumento che mette il terminale al primo posto, con stato TTY e output QR.
Accesso da QR
A ogni avvio viene stampato un codice QR con un link di accesso monouso. Scansionatelo sul dispositivo che volete usare.
Anteprima del server di sviluppo
Fate da proxy alla vostra app locale Vite e visualizzatela in anteprima accanto al terminale.
Passaggio HMR
Il proxy WebSocket mantiene attivo l'Hot Module Replacement di Vite.
Cambio visualizzazione
Passate da Terminale ad Anteprima dal pannello Viste nella barra in basso.
Flusso di lavoro full-stack
Eseguite comandi nel terminale e guardate l'app aggiornarsi in tempo reale.
Perché Termbridge
Senza inoltro di porte o VPN
Un Quick Tunnel Cloudflare senza account assegna al vostro server locale un HTTPS pubblico URL. Il dispositivo da cui vi collegate ha bisogno solo di un browser.
I programmi a schermo intero funzionano
node-pty si collega a tmux e segnala un terminale a 256 colori, così TUI come htop e vim funzionano come in locale.
Le sessioni sopravvivono al bridge
Ctrl+C chiude il tunnel e il server, ma lascia attive le vostre sessioni tmux. Riavviate con --session per collegarvi a una sessione già esistente.
Funziona sul vostro computer
Il server, il WebSocket e il registro del terminale si trovano sul vostro computer e, per impostazione predefinita, sono in ascolto su 127.0.0.1. Termbridge non gestisce un backend proprio.
A confronto con
Altri modi per accedere a un terminale da un altro dispositivo e differenze di Termbridge.
| Strumento | Ideale per | Differenze rispetto a Termbridge |
|---|---|---|
| ttyd | Ideale perttyd condivide sul web qualsiasi comando, supporta input CJK e IME, trasferimento di file ZMODEM e trzsz, immagini Sixel, SSL e autenticazione di base, e funziona su macOS, Linux, BSD, OpenWrt e Windows. | Differenze rispetto a TermbridgeTermbridge aggiunge il tunnel, un link di accesso monouso QR e una barra di controllo per il telefono, e mantiene la shell in tmux così sopravvive a un riavvio. È progettato per macOS e Linux. |
| sshx | Ideale persshx condivide un terminale con chiunque tramite un solo comando, su una tela infinita dove i collaboratori vedono i cursori degli altri, con crittografia end-to-end e binari per Linux, macOS e Windows. | Differenze rispetto a TermbridgeTermbridge consente di accedere al proprio terminale: a ogni avvio genera un link di accesso utilizzabile una sola volta e il traffico passa attraverso un tunnel Cloudflare verso il server sul vostro computer. |
| Tailscale SSH | Ideale perTailscale SSH affida a Tailscale l'autenticazione e l'autorizzazione delle connessioni SSH nella vostra tailnet, crittografate con WireGuard e chiavi dei nodi, da qualsiasi dispositivo con Tailscale. | Differenze rispetto a TermbridgeTermbridge non richiede un client né una rete privata sull'altro dispositivo. Vi fornisce un URL pubblico e un codice QR, e il terminale si apre nel browser. |
Fonti, selezionato
Domande e risposte
Risposte brevi dalla documentazione di Termbridge.
Nella modalità predefinita passa attraverso un Quick Tunnel Cloudflare prima di raggiungere il server Termbridge sul vostro computer. Termbridge non gestisce un backend proprio. Nella modalità sandbox Daytona, il terminale viene eseguito in una sandbox nel vostro account Daytona; nella modalità diretta, anche il server viene eseguito lì e vi collegate tramite il link di anteprima Daytona.
Il link QR contiene un token monouso, valido per 90 secondi. Il suo riscatto imposta un cookie di sessione HttpOnly e le connessioni WebSocket del terminale richiedono anche un token CSRF. Non condividete il codice QR né URL con persone di cui non vi fidate.
Sì. Impostate TERMBRIDGE_SESSIONS=3 per avviare tre sessioni tmux, poi passate dall'una all'altra con il selettore del terminale nell'app.
Non ufficialmente. Termbridge è progettato per macOS e Linux. Potrebbe funzionare con WSL, ma non è stato testato.
Non ancora. Cloudflare è l'unico provider di tunnel. Potete usare un tunnel Cloudflare con nome sul vostro hostname, disattivare il tunnel e fornire un vostro URL pubblico oppure usare la modalità diretta Daytona.
In modalità locale, la connessione dura finché Termbridge è in esecuzione e si chiude quando il computer va in sospensione o Termbridge termina. Le vostre sessioni tmux restano attive; potete quindi riavviare Termbridge, scansionare il nuovo codice QR e collegarvi con --session. In modalità diretta Daytona, il server viene eseguito all'interno della sandbox.
Installate Node 20+, tmux e cloudflared, eseguite npx termbridge e scansionate il codice QR per aprire il terminale nel browser del telefono.