Ga naar de inhoud

Aan de slag

Bekijken als Markdown Bewerken op GitHub Documentatie op 1675df8

De vereisten installeren

Installeer deze tools op uw computer voor de standaardconfiguratie met lokale tunnel:

Node.js 20+

Download via nodejs.org of gebruik uw pakketbeheerder.

Shell
# Check if installed
node --version

tmux

De terminalmultiplexer die Termbridge-sessies mogelijk maakt.

Shell
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

cloudflared

Maakt de beveiligde tunnel naar uw terminal aan (niet nodig voor de directe sandboxmodus).

Shell
# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads

Downloaden cloudflared

Termbridge uitvoeren

Shell
npx termbridge

U ziet uitvoer zoals deze:

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

Opmerking De trycloudflare.com URL is een snelle tunnel waarvoor geen account nodig is. Als u Termbridge vaak gebruikt, stel dan een benoemd Cloudflare-tunneltoken in om snelheidslimieten te voorkomen.

Verbinding maken vanaf uw telefoon

  1. Open de camera van uw telefoon
  2. Richt deze op de QR-code
  3. Tik op de link die verschijnt
  4. Uw terminal wordt in de browser geladen

Dat is alles: u bent verbonden!

Wat is er zojuist gebeurd?

  1. Termbridge heeft een lokale server op uw computer gestart
  2. Er is een tmux-sessie voor uw terminal aangemaakt
  3. Cloudflare heeft een beveiligde tunnel aangemaakt (de trycloudflare.com URL)
  4. De QR-code bevat een eenmalig token voor beveiligde toegang. Het werkt één keer en verloopt 90 seconden na het opstarten, dus scan de code snel; als deze is verlopen, start Termbridge opnieuw voor een nieuwe code
  5. Nadat u de code hebt gescand, kreeg u een sessiecookie en maakte u verbinding

Probeer het uit

Probeer na het verbinden enkele opdrachten uit:

Shell
# See system info
htop

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

# Run any CLI tool

De terminal ondersteunt volledige kleuren, TUI's en alle toetsen die u verwacht.

Actief houden

Termbridge moet actief blijven om de verbinding te laten werken. Wanneer u klaar bent:

  • Druk op Ctrl+C in de terminal waarin Termbridge actief is
  • De tunnel wordt gesloten en de verbinding verbroken
  • Uw tmux-sessie blijft actief (tenzij u --kill-on-exit hebt gebruikt)

Gedrag van de eerste sessie

  • Termbridge maakt een tmux-sessie aan (de standaardnaam is afgeleid van de poort)
  • De eerste terminal in de lijst wordt automatisch geladen
  • U kunt bij het opstarten meerdere sessies aanmaken door TERMBRIDGE_SESSIONS=2 in te stellen

Een bestaande tmux-sessie gebruiken

Als u --session <name> opgeeft en die sessie al bestaat, koppelt Termbridge zich eraan in plaats van een nieuwe aan te maken. Dit is handig om langlopende processen te volgen die u al hebt gestart.

Volgende stappen

Mobiele bediening

Tips voor het gebruik van Termbridge op telefoons en tablets

Meerdere terminals

Meerdere sessies uitvoeren en ertussen wisselen

Preview van ontwikkelserver

Bekijk uw Vite-app naast de terminal

CLI-referentie

Bekijk alle beschikbare vlaggen en opties