Primii pași

Instalați cerințele preliminare

Pentru configurarea implicită cu tunel local, instalați aceste instrumente pe computer:

Node.js 20+

Descărcați de la nodejs.org sau folosiți managerul de pachete.

# Check if installed
node --version

tmux

Multiplexorul de terminale care stă la baza sesiunilor Termbridge.

# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

cloudflared

Creează tunelul securizat către terminalul dumneavoastră (nu este necesar în modul sandbox direct).

# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads

Descărcați cloudflared

Rulați Termbridge

npx termbridge

Veți vedea o ieșire de acest fel:

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

Notă trycloudflare.com URL este un tunel rapid, fără cont. Dacă folosiți frecvent Termbridge, configurați un token pentru tunelul Cloudflare, cu nume, pentru a evita limitele de rată.

Conectați-vă de pe telefon

1. Deschideți camera telefonului
2. Îndreptați-o spre codul QR
3. Atingeți linkul care apare
4. Terminalul se încarcă în browser

Gata - sunteți conectat!

Ce s-a întâmplat?

1. Termbridge a pornit un server local pe computerul dumneavoastră
2. A creat o sesiune tmux pentru terminal
3. Cloudflare a creat un tunel securizat (trycloudflare.com URL)
4. Codul QR conține un token cu o singură utilizare pentru acces securizat. Funcționează o dată și expiră la 90 de secunde după pornire, așa că scanați-l prompt; dacă a expirat, reporniți Termbridge pentru a obține unul nou
5. După scanare, ați primit un cookie de sesiune și v-ați conectat

Încercați

După conectare, încercați câteva comenzi:

# See system info
htop

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

# Run any CLI tool

Terminalul acceptă toate culorile, TUI-urile și toate tastele la care v-ați aștepta.

Mențineți-l pornit

Termbridge trebuie să rămână pornit pentru ca conexiunea să funcționeze. Când ați terminat:

• Apăsați Ctrl+C în terminalul în care rulează Termbridge
• Tunelul se închide și conexiunea se termină
• Sesiunea tmux rămâne activă (dacă nu ați folosit --kill-on-exit)

Comportamentul primei sesiuni

• Termbridge creează o sesiune tmux (numele implicit este derivat din port)
• Primul terminal din listă se încarcă automat
• Puteți crea mai multe sesiuni la pornire setând TERMBRIDGE_SESSIONS=2

Folosirea unei sesiuni tmux existente

Dacă specificați --session <name> și sesiunea respectivă există deja, Termbridge se va conecta la ea în loc să creeze una nouă. Acest lucru este util pentru monitorizarea proceselor de lungă durată pe care le-ați pornit deja.

Pașii următori

Comenzi pentru mobil

Sfaturi pentru folosirea Termbridge pe telefoane și tablete

Mai multe terminale

Rulați mai multe sesiuni și comutați între ele

Previzualizarea serverului de dezvoltare

Previzualizați aplicația Vite alături de terminal

ReferințăCLI

Consultați toate opțiunile și indicatoarele disponibile