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

## Установлення потрібних компонентів

Для стандартного налаштування локального тунелю встановіть на комп’ютер такі інструменти:

### Node.js 20+

Завантажте з [nodejs.org](https://nodejs.org) або скористайтеся менеджером пакетів.

```bash
# Check if installed
node --version
```

### tmux

Мультиплексор термінала, на якому працюють сеанси Termbridge.

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

### cloudflared

Створює захищений тунель до вашого термінала (не потрібен у прямому режимі пісочниці).

```bash
# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads
```

[Завантажити cloudflared](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/)


## Запуск Termbridge

```bash
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 сеансу та підключилися

## Спробуйте

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

```bash
# 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 підключиться до нього замість створення нового. Це зручно для спостереження за вже запущеними тривалими процесами.

## Наступні кроки

### [Керування на мобільних пристроях](https://termbridge.inline0.dev/uk/docs/usage/mobile-controls)

Поради щодо використання Termbridge на телефонах і планшетах

### [Кілька терміналів](https://termbridge.inline0.dev/uk/docs/usage/multiple-terminals)

Запускайте кілька сеансів і перемикайтеся між ними

### [Попередній перегляд сервера розробки](https://termbridge.inline0.dev/uk/docs/usage/dev-server-preview)

Переглядайте свій застосунок Vite поруч із терміналом

### [ДовідкаCLI ](https://termbridge.inline0.dev/uk/docs/cli)

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