Vai al contenuto

Guida introduttiva

Visualizza come Markdown Modifica su GitHub Documentazione di 1675df8

Installa i prerequisiti

Per la configurazione predefinita con tunnel locale, installa questi strumenti sul computer:

Node.js 20+

Scaricalo da nodejs.org oppure usa il gestore di pacchetti.

Shell
# Check if installed
node --version

tmux

Il multiplexer di terminale alla base delle sessioni Termbridge.

Shell
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

cloudflared

Crea il tunnel sicuro verso il terminale (non necessario per la modalità diretta sandbox).

Shell
# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads

Scarica cloudflared

Esegui Termbridge

Shell
npx termbridge

Vedrai un output simile a questo:

Codice
┌─────────────────────────────────────────┐
│  Termbridge                             │
│                                         │
│  Local:   http://127.0.0.1:51234        │
│  Public:  https://abc123.trycloudflare.com │
│                                         │
│  ██████████████                         │
│  ██          ██  <- Scan this QR code   │
│  ██████████████                         │
│                                         │
└─────────────────────────────────────────┘

Nota Il trycloudflare.com URL è un tunnel rapido che non richiede un account. Se usi spesso Termbridge, configura un token per un tunnel denominato Cloudflare per evitare limiti di frequenza.

Collegati dal telefono

  1. Apri la fotocamera del telefono
  2. Inquadra il codice QR
  3. Tocca il link visualizzato
  4. Il terminale si apre nel browser

Ecco fatto: sei connesso!

Che cosa è successo?

  1. Termbridge ha avviato un server locale sulla tua macchina
  2. Ha creato una sessione tmux per il terminale
  3. Cloudflare ha creato un tunnel sicuro (il trycloudflare.com URL)
  4. Il codice QR contiene un token monouso per l'accesso sicuro. È valido una sola volta e scade 90 secondi dopo l'avvio: scansionalo subito; se è scaduto, riavvia Termbridge per generarne uno nuovo
  5. Dopo la scansione, hai ricevuto un cookie di sessione e ti sei collegato

Provalo

Una volta collegato, prova alcuni comandi:

Shell
# See system info
htop

# Check a git repo
cd ~/your-project && git status

# Run any CLI tool

Il terminale supporta tutti i colori, le TUI e i tasti che ti aspetti.

Lascialo in esecuzione

Termbridge deve restare in esecuzione perché la connessione funzioni. Quando hai finito:

  • Premi Ctrl+C nel terminale in cui è in esecuzione Termbridge
  • Il tunnel si chiude e la connessione termina
  • La sessione tmux resta attiva (a meno che tu non abbia usato --kill-on-exit)

Comportamento della prima sessione

  • Termbridge crea una sessione tmux (il nome predefinito deriva dalla porta)
  • Il primo terminale nell'elenco viene caricato automaticamente
  • Puoi creare più sessioni all'avvio impostando TERMBRIDGE_SESSIONS=2

Usare una sessione tmux esistente

Se passi --session <name> e la sessione esiste già, Termbridge vi si collegherà invece di crearne una nuova. È utile per monitorare processi di lunga durata che hai già avviato.

Passaggi successivi

Controlli per dispositivi mobili

Suggerimenti per usare Termbridge su telefoni e tablet

Terminali multipli

Esegui più sessioni e passa dall'una all'altra

Anteprima del server di sviluppo

Visualizza l'anteprima della tua app Vite accanto al terminale

CLI Riferimento

Consulta tutti i flag e le opzioni disponibili