Перейти до вмісту

Початок роботи

Переглянути як 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. Після сканування ви отримали cookie сеансу та підключилися

Спробуйте

Після підключення спробуйте виконати кілька команд:

Командна оболонка
# 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

Перегляньте всі доступні прапорці й параметри