Hoppa till innehåll

Kom igång

Visa som Markdown Redigera på GitHub Dokumentation på 1675df8

Installera förutsättningarna

För standardkonfigurationen med lokal tunnel installerar du dessa verktyg på datorn:

Node.js 20+

Ladda ner från nodejs.org eller använd pakethanteraren.

Shell
# Check if installed
node --version

tmux

Terminalmultiplexern som driver Termbridge-sessioner.

Shell
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

cloudflared

Skapar den säkra tunneln till terminalen (behövs inte för direkt sandboxläge).

Shell
# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads

Ladda nercloudflared

Kör Termbridge

Shell
npx termbridge

Du bör se utdata som den här:

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

Obs! trycloudflare.com URL är en snabb tunnel som inte kräver konto. Om du använder Termbridge ofta, kan du konfigurera en namngiven Cloudflare-tunnel med en token för att undvika hastighetsbegränsningar.

Anslut från telefonen

  1. Öppna kameran på telefonen
  2. Rikta den mot QR-koden
  3. Tryck på länken som visas
  4. Terminalen öppnas i webbläsaren

Klart – du är ansluten!

Vad hände nyss?

  1. Termbridge startade en lokal server på datorn
  2. Den skapade en tmux-session för terminalen
  3. Cloudflare skapade en säker tunnel (trycloudflare.com URL)
  4. QR-koden innehåller en engångstoken för säker åtkomst. Den fungerar en gång och går ut 90 sekunder efter start, så skanna den snabbt. Om den har gått ut startar du om Termbridge för att få en ny
  5. När du skannade koden fick du en sessionscookie och anslöts

Prova själv

När du har anslutit kan du prova några kommandon:

Shell
# See system info
htop

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

# Run any CLI tool

Terminalen har fullt färgstöd, TUI:er och alla tangenter du förväntar dig.

Håll det igång

Termbridge måste fortsätta köras för att anslutningen ska fungera. När du är klar:

  • Tryck på Ctrl+C i terminalen där Termbridge körs
  • Tunneln stängs och anslutningen avslutas
  • Din tmux-session fortsätter att köras (om du inte använde --kill-on-exit)

Så fungerar den första sessionen

  • Termbridge skapar en tmux-session (standardnamnet härleds från porten)
  • Den första terminalen i listan läses in automatiskt
  • Du kan skapa flera sessioner vid start genom att ange TERMBRIDGE_SESSIONS=2

Använda en befintlig tmux-session

Om du anger --session <name> och sessionen redan finns ansluter Termbridge till den i stället för att skapa en ny. Det här är användbart när du vill övervaka processer som kör länge och som du redan har startat.

Nästa steg

Mobilkontroller

Tips för att använda Termbridge på telefoner och surfplattor

Flera terminaler

Kör flera sessioner och växla mellan dem

Förhandsgranskning av utvecklingsserver

Förhandsgranska din Vite-app bredvid terminalen

CLI Referens

Se alla tillgängliga flaggor och alternativ