Preskočiť na obsah

Začíname

Zobraziť ako Markdown Upraviť na GitHub Dokumentácia na 1675df8

Inštalácia potrebných nástrojov

Pre predvolené nastavenie lokálneho tunela nainštalujte do počítača tieto nástroje:

Node.js 20+

Stiahnite si z nodejs.org alebo použite správcu balíkov.

Shell
# Check if installed
node --version

tmux

Multiplexor terminálu, ktorý zabezpečuje fungovanie relácií Termbridge.

Shell
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

cloudflared

Vytvára zabezpečený tunel k vášmu terminálu (v priamom režime sandboxu nie je potrebný).

Shell
# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads

Stiahnuť cloudflared

Spustenie Termbridge

Shell
npx termbridge

Zobrazí sa výstup podobný tomuto:

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

Poznámka trycloudflare.com URL je rýchly tunel, ktorý nevyžaduje účet. Ak Termbridge používate často, nastavte token pomenovaného tunela Cloudflare, aby ste sa vyhli limitom požiadaviek.

Pripojenie z telefónu

  1. Otvorte fotoaparát v telefóne
  2. Namierte ho na kód QR
  3. Ťuknite na zobrazený odkaz
  4. Terminál sa načíta v prehliadači

To je všetko – ste pripojení!

Čo sa práve stalo?

  1. Termbridge spustil lokálny server vo vašom počítači
  2. Vytvoril reláciu tmux pre váš terminál
  3. Cloudflare vytvoril zabezpečený tunel (trycloudflare.com URL)
  4. Kód QR obsahuje jednorazový token na zabezpečený prístup. Funguje len raz a jeho platnosť vyprší 90 sekúnd po spustení, preto ho naskenujte čo najskôr; ak jeho platnosť vypršala, reštartujte Termbridge a vytvorte nový
  5. Po naskenovaní ste získali súbor cookie relácie a pripojili sa

Vyskúšajte si to

Po pripojení vyskúšajte niekoľko príkazov:

Shell
# See system info
htop

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

# Run any CLI tool

Terminál podporuje plnofarebné zobrazenie, TUI aj všetky klávesy, ktoré by ste očakávali.

Nechajte ho bežať

Aby pripojenie fungovalo, Termbridge musí zostať spustený. Keď skončíte:

  • Stlačte Ctrl+C v termináli, v ktorom beží Termbridge
  • Tunel sa zatvorí a spojenie sa ukončí
  • Relácia tmux zostane aktívna (pokiaľ ste nepoužili --kill-on-exit)

Správanie pri prvej relácii

  • Termbridge vytvorí reláciu tmux (predvolený názov sa odvodí od portu)
  • Automaticky sa načíta prvý terminál v zozname
  • Pri spustení môžete vytvoriť viacero relácií nastavením TERMBRIDGE_SESSIONS=2

Použitie existujúcej relácie tmux

Ak zadáte --session <name> a táto relácia už existuje, Termbridge sa k nej pripojí namiesto vytvorenia novej. To sa hodí na sledovanie dlho bežiacich procesov, ktoré ste už spustili.

Ďalšie kroky

Ovládanie v mobile

Tipy na používanie Termbridge v telefónoch a tabletoch

Viacero terminálov

Spúšťajte viacero relácií a prepínajte medzi nimi

Ukážka vývojového servera

Zobrazte si ukážku aplikácie Vite vedľa terminálu

CLI Referencia

Pozrite si všetky dostupné príznaky a možnosti