İçeriğe geç

Başlarken

Önkoşulları yükleyin

Varsayılan yerel tünel kurulumu için bu araçları bilgisayarınıza yükleyin:

Node.js 20+

nodejs.org adresinden indirin veya paket yöneticinizi kullanın.

Kabuk
# Check if installed
node --version

tmux

Termbridge oturumlarına güç veren terminal çoklayıcısı.

Kabuk
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

cloudflared

Terminalinize güvenli tünel oluşturur (korumalı alan doğrudan modunda gerekmez).

Kabuk
# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads

İndirme cloudflared

Termbridge aracını çalıştırın

Kabuk
npx termbridge

Şuna benzer bir çıktı görürsünüz:

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

Not trycloudflare.com URL hızlı, hesapsız bir tüneldir. Termbridge aracını sık kullanıyorsanız, hız sınırlarından kaçınmak için adlandırılmış bir Cloudflare tünel belirteci ayarlayın.

Telefonunuzdan bağlanın

  1. Telefonunuzun kamerasını açın
  2. QR koduna tutun
  3. Görünen bağlantıya dokunun
  4. Terminaliniz tarayıcıda açılır

Hepsi bu; bağlandınız!

Az önce ne oldu?

  1. Termbridge makinenizde yerel bir sunucu başlattı
  2. Terminaliniz için bir tmux oturumu oluşturdu
  3. Cloudflare güvenli bir tünel oluşturdu (trycloudflare.com URL)
  4. QR kodu, güvenli erişim için tek kullanımlık bir belirteç içerir. Yalnızca bir kez çalışır ve başlangıçtan 90 saniye sonra süresi dolar; bu yüzden hemen tarayın. Süresi dolduysa yeni bir kod için Termbridge aracını yeniden başlatın
  5. Kodu taradığınızda bir oturum çerezi aldınız ve bağlandınız

Deneyin

Bağlandıktan sonra birkaç komut deneyin:

Kabuk
# See system info
htop

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

# Run any CLI tool

Terminal; tam renkleri, TUI'leri ve beklediğiniz tüm tuşları destekler.

Çalışır durumda tutun

Bağlantının çalışması için Termbridge çalışmaya devam etmelidir. İşiniz bittiğinde:

  • Termbridge çalışırken terminalde Ctrl+C tuşuna basın
  • Tünel kapanır ve bağlantı sonlanır
  • tmux oturumunuz açık kalır (--kill-on-exit kullandıysanız bu durum geçerli değildir)

İlk oturum davranışı

  • Termbridge bir tmux oturumu oluşturur (varsayılan ad, bağlantı noktasından türetilir)
  • Listedeki ilk terminal otomatik olarak açılır
  • TERMBRIDGE_SESSIONS=2 ayarını yaparak başlangıçta birden fazla oturum oluşturabilirsiniz

Mevcut bir tmux oturumunu kullanma

--session <name> değerini iletir ve bu oturum zaten varsa, Termbridge yeni bir oturum oluşturmak yerine ona bağlanır. Bu, daha önce başlattığınız uzun süreli işlemleri izlemek için kullanışlıdır.

Sonraki adımlar

Mobil Denetimler

Telefonlarda ve tabletlerde Termbridge kullanma ipuçları

Birden Fazla Terminal

Birden fazla oturum çalıştırın ve aralarında geçiş yapın

Geliştirme Sunucusu Önizlemesi

Terminalin yanında Vite uygulamanızın önizlemesini görün

CLI Referansı

Kullanılabilir tüm bayrakları ve seçenekleri görün