# Първи стъпки

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

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

### 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. При сканирането получихте бисквитка за сесия и се свързахте

## Изпробвайте

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

```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/bg/docs/usage/mobile-controls)

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

### [Няколко терминала](https://termbridge.inline0.dev/bg/docs/usage/multiple-terminals)

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

### [Преглед на сървъра за разработка](https://termbridge.inline0.dev/bg/docs/usage/dev-server-preview)

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

### [Справочник CLI](https://termbridge.inline0.dev/bg/docs/cli)

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