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.
# Check if installed
node --version
tmux
Multiplexer terminal yang mendukung sesi Termbridge.
# macOS
brew install tmux
# Ubuntu/Debian
sudo apt install tmux
cloudflared
Membuat tunnel aman ke terminal Anda (tidak diperlukan untuk mode langsung sandbox).
# macOS
brew install cloudflared
# Linux - see cloudflare.com/downloads
Jalankan Termbridge
npx termbridge
Anda akan melihat keluaran seperti ini:
┌─────────────────────────────────────────┐
│ Termbridge │
│ │
│ Local: http://127.0.0.1:51234 │
│ Public: https://abc123.trycloudflare.com │
│ │
│ ██████████████ │
│ ██ ██ <- Scan this QR code │
│ ██████████████ │
│ │
└─────────────────────────────────────────┘
Catatan
trycloudflare.comURL adalah tunnel cepat tanpa akun. Jika Anda sering menggunakan Termbridge, siapkan token tunnel Cloudflare bernama agar terhindar dari batas laju.
Sambungkan dari ponsel
- Buka kamera ponsel Anda
- Arahkan ke kode QR
- Ketuk tautan yang muncul
- Terminal Anda akan dimuat di browser
Selesai - Anda sudah terhubung!
Apa yang baru saja terjadi?
- Termbridge memulai server lokal di komputer Anda
- tmux membuat sesi untuk terminal Anda
- Cloudflare membuat tunnel aman (
trycloudflare.comURL) - 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
- Setelah memindainya, Anda mendapatkan cookie sesi dan terhubung
Coba sekarang
Setelah terhubung, coba beberapa perintah:
# 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+Cdi 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