Gå til indhold

Kom godt i gang

Vis som Markdown Rediger på GitHub Dokumentation hos 1675df8

Installer forudsætningerne

Til standardopsætningen med lokal tunnel skal du installere disse værktøjer på din computer:

Node.js 20+

Download fra nodejs.org eller brug din pakkehåndtering.

Shell
# Check if installed
node --version

tmux

Terminalmultiplexeren, der driver Termbridge-sessioner.

Shell
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

cloudflared

Opretter den sikre tunnel til din terminal (ikke nødvendig ved direkte sandbox-tilstand).

Shell
# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads

Download cloudflared

Kør Termbridge

Shell
npx termbridge

Du får vist output i denne stil:

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

Bemærk trycloudflare.com URL er en hurtig tunnel uden konto. Hvis du bruger Termbridge ofte, skal du konfigurere et token til en navngiven Cloudflare-tunnel for at undgå hastighedsbegrænsninger.

Opret forbindelse fra din telefon

  1. Åbn kameraet på din telefon
  2. Ret det mod QR-koden
  3. Tryk på linket, der vises
  4. Din terminal indlæses i browseren

Sådan – du har forbindelse!

Hvad skete der lige?

  1. Termbridge startede en lokal server på din maskine
  2. Den oprettede en tmux-session til din terminal
  3. Cloudflare oprettede en sikker tunnel (trycloudflare.com URL)
  4. QR-koden indeholder et engangstoken til sikker adgang. Det virker én gang og udløber 90 sekunder efter opstart, så scan det hurtigt; hvis det er udløbet, skal du genstarte Termbridge for at få et nyt
  5. Da du scannede koden, fik du en sessionscookie og oprettede forbindelse

Prøv det

Når du har oprettet forbindelse, kan du prøve nogle kommandoer:

Shell
# See system info
htop

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

# Run any CLI tool

Terminalen understøtter fulde farver, TUI'er og alle de taster, du forventer.

Hold det kørende

Termbridge skal blive ved med at køre, for at forbindelsen fungerer. Når du er færdig:

  • Tryk på Ctrl+C i terminalen, hvor Termbridge kører
  • Tunnelen lukkes, og forbindelsen afsluttes
  • Din tmux-session forbliver aktiv (medmindre du brugte --kill-on-exit)

Sådan fungerer den første session

  • Termbridge opretter en tmux-session (standardnavnet er baseret på porten)
  • Den første terminal på listen indlæses automatisk
  • Du kan oprette flere sessioner ved opstart ved at angive TERMBRIDGE_SESSIONS=2

Brug en eksisterende tmux-session

Hvis du angiver --session <name>, og sessionen allerede findes, tilslutter Termbridge sig den i stedet for at oprette en ny. Det er nyttigt, når du vil overvåge processer, du allerede har startet, og som kører længe.

Næste trin

Mobilstyring

Tips til brug af Termbridge på telefoner og tablets

Flere terminaler

Kør flere sessioner, og skift mellem dem

Forhåndsvisning af udviklingsserver

Se en forhåndsvisning af din Vite-app ved siden af terminalen

CLI Reference

Se alle tilgængelige flag og indstillinger