Pierwsze kroki

Instalacja wymaganych narzędzi

Aby skonfigurować domyślny tunel lokalny, zainstaluj na komputerze te narzędzia:

Node.js 20+

Pobierz z nodejs.org lub użyj menedżera pakietów.

# Check if installed
node --version

tmux

Multiplekser terminala, który obsługuje sesje Termbridge.

# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

cloudflared

Tworzy bezpieczny tunel do Twojego terminala (nie jest potrzebne w trybie bezpośrednim sandboxa).

# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads

Pobierz cloudflared

Uruchom Termbridge

npx termbridge

Zobaczysz podobne dane wyjściowe:

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

Uwaga trycloudflare.com URL to szybki tunel bez konta. Jeśli często korzystasz z Termbridge, skonfiguruj token nazwanego tunelu Cloudflare, aby uniknąć limitów szybkości.

Połącz się z telefonu

1. Otwórz aparat w telefonie
2. Skieruj go na kod QR
3. Kliknij wyświetlony link
4. Terminal otworzy się w przeglądarce

To wszystko — połączenie gotowe!

Co się właśnie stało?

1. Termbridge uruchomił lokalny serwer na Twoim komputerze
2. Utworzył sesję tmux dla Twojego terminala
3. Cloudflare utworzył bezpieczny tunel (trycloudflare.com URL)
4. Kod QR zawiera jednorazowy token zapewniający bezpieczny dostęp. Działa tylko raz i wygasa 90 sekund po uruchomieniu, więc zeskanuj go szybko; jeśli stracił ważność, uruchom ponownie Termbridge, aby wygenerować nowy
5. Po zeskanowaniu otrzymasz plik cookie sesji i połączysz się

Wypróbuj

Po połączeniu wypróbuj kilka poleceń:

# See system info
htop

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

# Run any CLI tool

Terminal obsługuje pełną paletę kolorów, TUI i wszystkie standardowe klawisze.

Nie zamykaj programu

Termbridge musi działać, aby połączenie było aktywne. Gdy skończysz:

• Naciśnij Ctrl+C w terminalu, w którym działa Termbridge
• Tunel zostanie zamknięty, a połączenie zakończone
• Twoja sesja tmux pozostanie aktywna (chyba że użyto --kill-on-exit)

Działanie pierwszej sesji

• Termbridge tworzy sesję tmux (domyślna nazwa jest wyznaczana na podstawie portu)
• Pierwszy terminal na liście jest wczytywany automatycznie
• Przy uruchamianiu możesz utworzyć wiele sesji, ustawiając TERMBRIDGE_SESSIONS=2

Korzystanie z istniejącej sesji tmux

Jeśli przekażesz --session <name>, a ta sesja już istnieje, Termbridge dołączy do niej zamiast tworzyć nową. Przydaje się to do monitorowania długo działających procesów, które zostały już uruchomione.

Następne kroki

Sterowanie na urządzeniach mobilnych

Wskazówki dotyczące korzystania z Termbridge na telefonach i tabletach

Wiele terminali

Uruchamiaj wiele sesji i przełączaj się między nimi

Podgląd serwera deweloperskiego

Wyświetl podgląd aplikacji Vite obok terminala

CLI Dokumentacja

Zobacz wszystkie dostępne flagi i opcje