Lewati ke konten

Memulai

Instal prasyarat

Untuk menyiapkan tunnel lokal default, instal alat berikut di komputer Anda:

Node.js 20+

Unduh dari nodejs.org atau gunakan pengelola paket Anda.

Shell
# Check if installed
node --version

tmux

Multiplexer terminal yang mendukung sesi Termbridge.

Shell
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

cloudflared

Membuat tunnel aman ke terminal Anda (tidak diperlukan untuk mode langsung sandbox).

Shell
# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads

Unduh cloudflared

Jalankan Termbridge

Shell
npx termbridge

Anda akan melihat keluaran seperti ini:

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

Catatan trycloudflare.com URL adalah tunnel cepat tanpa akun. Jika Anda sering menggunakan Termbridge, siapkan token tunnel Cloudflare bernama agar terhindar dari batas laju.

Sambungkan dari ponsel

  1. Buka kamera ponsel Anda
  2. Arahkan ke kode QR
  3. Ketuk tautan yang muncul
  4. Terminal Anda akan dimuat di browser

Selesai - Anda sudah terhubung!

Apa yang baru saja terjadi?

  1. Termbridge memulai server lokal di komputer Anda
  2. tmux membuat sesi untuk terminal Anda
  3. Cloudflare membuat tunnel aman (trycloudflare.com URL)
  4. Kode QR berisi token sekali pakai untuk akses aman. Token ini hanya berlaku sekali dan kedaluwarsa 90 detik setelah mulai, jadi segera pindai; jika sudah kedaluwarsa, mulai ulang Termbridge untuk mendapat kode baru
  5. Setelah memindainya, Anda mendapatkan cookie sesi dan terhubung

Coba sekarang

Setelah terhubung, coba beberapa perintah:

Shell
# See system info
htop

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

# Run any CLI tool

Terminal mendukung warna penuh, TUI, dan semua tombol yang Anda harapkan.

Biarkan tetap berjalan

Termbridge harus tetap berjalan agar koneksi berfungsi. Setelah selesai:

  • Tekan Ctrl+C di terminal tempat Termbridge berjalan
  • Tunnel ditutup dan koneksi berakhir
  • Sesi tmux Anda tetap aktif (kecuali jika Anda menggunakan --kill-on-exit)

Perilaku sesi pertama

  • Termbridge membuat sesi tmux (nama default diambil dari port)
  • Terminal pertama dalam daftar dimuat secara otomatis
  • Anda dapat membuat beberapa sesi saat mulai dengan menetapkan TERMBRIDGE_SESSIONS=2

Menggunakan sesi tmux yang sudah ada

Jika Anda memberikan --session <name> dan sesi tersebut sudah ada, Termbridge akan menyambungkannya alih-alih membuat sesi baru. Ini berguna untuk memantau proses berjalan lama yang telah Anda mulai.

Langkah berikutnya

Kontrol Seluler

Tips menggunakan Termbridge di ponsel dan tablet

Beberapa Terminal

Jalankan beberapa sesi dan berpindah di antaranya

Pratinjau Server Dev

Pratinjau aplikasi Vite Anda di samping terminal

ReferensiCLI

Lihat semua tanda dan opsi yang tersedia