# Guida introduttiva

## Installa i prerequisiti

Per la configurazione predefinita con tunnel locale, installa questi strumenti sul computer:

### Node.js 20+

Scaricalo da [nodejs.org](https://nodejs.org) oppure usa il gestore di pacchetti.

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

### tmux

Il multiplexer di terminale alla base delle sessioni Termbridge.

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

### cloudflared

Crea il tunnel sicuro verso il terminale (non necessario per la modalità diretta sandbox).

```bash
# macOS
brew install cloudflared

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

[Scarica cloudflared](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/)


## Esegui Termbridge

```bash
npx termbridge
```

Vedrai un output simile a questo:

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

> **Nota**
> Il `trycloudflare.com` URL è un tunnel rapido che non richiede un account. Se usi spesso Termbridge,
> configura un token per un tunnel denominato Cloudflare per evitare limiti di frequenza.


## Collegati dal telefono

1. Apri la fotocamera del telefono
2. Inquadra il codice QR
3. Tocca il link visualizzato
4. Il terminale si apre nel browser

Ecco fatto: sei connesso!

## Che cosa è successo?

1. Termbridge ha avviato un server locale sulla tua macchina
2. Ha creato una sessione tmux per il terminale
3. Cloudflare ha creato un tunnel sicuro (il `trycloudflare.com` URL)
4. Il codice QR contiene un token monouso per l'accesso sicuro. È valido una sola volta e scade 90 secondi dopo l'avvio: scansionalo subito; se è scaduto, riavvia Termbridge per generarne uno nuovo
5. Dopo la scansione, hai ricevuto un cookie di sessione e ti sei collegato

## Provalo

Una volta collegato, prova alcuni comandi:

```bash
# See system info
htop

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

# Run any CLI tool
```

Il terminale supporta tutti i colori, le TUI e i tasti che ti aspetti.

## Lascialo in esecuzione

Termbridge deve restare in esecuzione perché la connessione funzioni. Quando hai finito:

- Premi `Ctrl+C` nel terminale in cui è in esecuzione Termbridge
- Il tunnel si chiude e la connessione termina
- La sessione tmux resta attiva (a meno che tu non abbia usato `--kill-on-exit`)

## Comportamento della prima sessione

- Termbridge crea una sessione tmux (il nome predefinito deriva dalla porta)
- Il primo terminale nell'elenco viene caricato automaticamente
- Puoi creare più sessioni all'avvio impostando `TERMBRIDGE_SESSIONS=2`

## Usare una sessione tmux esistente

Se passi `--session <name>` e la sessione esiste già, Termbridge vi si collegherà invece di crearne una nuova. È utile per monitorare processi di lunga durata che hai già avviato.

## Passaggi successivi

### [Controlli per dispositivi mobili](https://termbridge.inline0.dev/it/docs/usage/mobile-controls)

Suggerimenti per usare Termbridge su telefoni e tablet

### [Terminali multipli](https://termbridge.inline0.dev/it/docs/usage/multiple-terminals)

Esegui più sessioni e passa dall'una all'altra

### [Anteprima del server di sviluppo](https://termbridge.inline0.dev/it/docs/usage/dev-server-preview)

Visualizza l'anteprima della tua app Vite accanto al terminale

### [CLI Riferimento](https://termbridge.inline0.dev/it/docs/cli)

Consulta tutti i flag e le opzioni disponibili