Към съдържанието

Първи стъпки

Преглед като Markdown Редактиране в GitHub Документация за 1675df8

Инсталиране на необходимите компоненти

За настройката с локален тунел по подразбиране инсталирайте тези инструменти на компютъра си:

Node.js 20+

Изтеглете от nodejs.org или използвайте пакетния си мениджър.

Обвивка
# Check if installed
node --version

tmux

Терминален мултиплексор, който захранва сесиите на Termbridge.

Обвивка
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

cloudflared

Създава защитения тунел към терминала ви (не е необходим за директен режим в пясъчна среда).

Обвивка
# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads

Изтеглете cloudflared

Стартиране на Termbridge

Обвивка
npx termbridge

Ще видите изход подобен на този:

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

Забележка trycloudflare.com URL е бърз тунел без акаунт. Ако използвате често Termbridge, настройте токен за именуван тунел Cloudflare, за да избегнете ограниченията на честотата.

Свързване от телефона

  1. Отворете камерата на телефона си
  2. Насочете я към кода QR
  3. Докоснете появилия се линк
  4. Терминалът ви се зарежда в браузъра

Това е всичко — свързани сте!

Какво се случи?

  1. Termbridge стартира локален сървър на компютъра ви
  2. Създаде сесия tmux за терминала ви
  3. Cloudflare създаде защитен тунел (trycloudflare.com URL)
  4. Кодът QR съдържа еднократен токен за защитен достъп. Той работи само веднъж и изтича 90 секунди след стартиране, затова го сканирайте веднага; ако е изтекъл, рестартирайте Termbridge за нов
  5. При сканирането получихте бисквитка за сесия и се свързахте

Изпробвайте

След като се свържете, изпробвайте някои команди:

Обвивка
# See system info
htop

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

# Run any CLI tool

Терминалът поддържа пълноцветен режим, TUI и всички очаквани клавиши.

Оставете го да работи

Termbridge трябва да продължи да работи, за да функционира връзката. Когато приключите:

  • Натиснете Ctrl+C в терминала, в който работи Termbridge
  • Тунелът се затваря и връзката прекъсва
  • Сесията ви tmux остава активна (освен ако не сте използвали --kill-on-exit)

Поведение при първата сесия

  • Termbridge създава сесия tmux (името по подразбиране се извежда от порта)
  • Първият терминал в списъка се зарежда автоматично
  • Можете да създадете няколко сесии при стартиране, като зададете TERMBRIDGE_SESSIONS=2

Използване на съществуваща сесия tmux

Ако подадете --session <name> и тази сесия вече съществува, Termbridge ще се свърже с нея, вместо да създаде нова. Това е полезно за наблюдение на вече стартирани процеси с продължително изпълнение.

Следващи стъпки

Управление от мобилно устройство

Съвети за използване на Termbridge на телефони и таблети

Няколко терминала

Стартирайте няколко сесии и превключвайте между тях

Преглед на сървъра за разработка

Преглеждайте приложението си Vite заедно с терминала

Справочник CLI

Вижте всички налични флагове и опции