Začínáme

Instalace předpokladů

Pro výchozí nastavení místního tunelu nainstalujte do počítače tyto nástroje:

Node.js 20+

Stáhněte z nodejs.org nebo použijte správce balíčků.

# Check if installed
node --version

tmux

Multiplexor terminálu, který zajišťuje relace Termbridge.

# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

cloudflared

Vytvoří zabezpečený tunel k terminálu (není potřeba pro přímý režim sandboxu).

# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads

Stáhnout cloudflared

Spuštění Termbridge

npx termbridge

Zobrazí se výstup podobný tomuto:

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

Poznámka trycloudflare.com URL je rychlý tunel bez účtu. Pokud Termbridge používáte často, nastavte token pojmenovaného tunelu Cloudflare, abyste předešli omezení počtu požadavků.

Připojení z telefonu

1. Otevřete fotoaparát telefonu
2. Namiřte ho na kód QR
3. Klepněte na zobrazený odkaz
4. V prohlížeči se načte váš terminál

A je to – jste připojeni!

Co se právě stalo?

1. Termbridge spustil na vašem počítači místní server
2. Vytvořil relaci tmux pro váš terminál
3. Cloudflare vytvořil zabezpečený tunel (trycloudflare.com URL)
4. Kód QR obsahuje jednorázový token pro zabezpečený přístup. Funguje pouze jednou a jeho platnost vyprší 90 sekund po spuštění, proto ho naskenujte co nejdříve; pokud jeho platnost vypršela, restartujte Termbridge a získáte nový
5. Po naskenování jste získali soubor cookie relace a připojili se

Vyzkoušejte to

Po připojení zkuste několik příkazů:

# See system info
htop

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

# Run any CLI tool

Terminál podporuje plné barvy, TUI i všechny klávesy, které byste očekávali.

Nechte ho spuštěný

Aby připojení fungovalo, musí Termbridge zůstat spuštěný. Až skončíte:

• V terminálu, ve kterém běží Termbridge, stiskněte Ctrl+C
• Tunel se uzavře a připojení skončí
• Vaše relace tmux zůstane aktivní (pokud jste nepoužili --kill-on-exit)

Chování při první relaci

• Termbridge vytvoří relaci tmux (výchozí název se odvozuje od portu)
• Automaticky se načte první terminál v seznamu
• Při spuštění můžete vytvořit více relací nastavením TERMBRIDGE_SESSIONS=2

Použití existující relace tmux

Pokud zadáte --session <name> a daná relace už existuje, Termbridge se k ní připojí místo vytvoření nové. To se hodí ke sledování dlouho běžících procesů, které jste už spustili.

Další kroky

Ovládání na mobilu

Tipy k používání Termbridge na telefonech a tabletech

Více terminálů

Spouštějte více relací a přepínejte mezi nimi

Náhled vývojového serveru

Zobrazte náhled aplikace Vite vedle terminálu

CLI Reference

Zobrazit všechny dostupné příznaky a možnosti