
# FAQ

## I miei dati passano dai server di qualcun altro?

Il server Termbridge e il tuo terminale vengono eseguiti sulla tua macchina e non esiste un backend gestito da Termbridge. Nella configurazione predefinita, il traffico del terminale passa comunque attraverso Cloudflare: il browser si collega tramite HTTPS a un Quick Tunnel Cloudflare, che inoltra il traffico al processo `cloudflared` sul tuo computer (vedi [Architettura](https://termbridge.inline0.dev/it/docs/architecture)). Con un tunnel denominato passa attraverso il tuo account Cloudflare; con `--no-tunnel` passa attraverso il servizio che ospita il tuo URL pubblico.

In modalità sandbox Daytona, il terminale viene eseguito in un sandbox nel tuo account Daytona. In modalità diretta, il browser si collega tramite il link di anteprima Daytona anziché tramite Cloudflare.

## Quanto è sicura la connessione?

- URL include un token monouso, valido una sola volta e con scadenza 90 secondi dopo l'avvio
- Le sessioni sono protette da cookie HttpOnly
- Gli URL dei tunnel (Cloudflare o un link di anteprima Daytona) usano HTTPS; con `--no-tunnel`, la crittografia dipende dal URL pubblico che fornisci

Le sessioni non scadono da sole. Sono archiviate in `termbridge/sessions.json` nella directory temporanea del sistema, quindi un browser che ha riscattato un link mantiene l'accesso finché riesce a raggiungere lo stesso URL. Elimina quel file e riavvia Termbridge per disconnettere tutti i browser. Non condividere il codice QR o URL con persone di cui non ti fidi.

## Posso eseguire più terminali contemporaneamente?

Sì. Avvia Termbridge con `TERMBRIDGE_SESSIONS=3` (oppure collegati a sessioni esistenti con `--session`) e usa il selettore di terminale in UI per passare da una all'altra. Consulta la guida [Terminali multipli](https://termbridge.inline0.dev/it/docs/usage/multiple-terminals).

## Funziona con Claude Code, Codex o altri strumenti di IA?

Certamente. Se funziona in un terminale, Termbridge può trasmetterlo. Avvia il tuo strumento di programmazione IA nella sessione tmux e potrai monitorarlo dal telefono.

## Funziona su Windows?

Non ufficialmente. Termbridge è progettato per macOS e Linux. Potrebbe funzionare con WSL, ma non è stato testato.

## Posso usare un altro provider di tunnel?

Non ancora: Cloudflare è al momento l'unico provider di tunnel. Puoi anche disabilitare del tutto il tunnel o usare la modalità diretta Daytona.

## Cosa succede se chiudo il portatile?

In modalità locale, il tunnel resta attivo finché Termbridge è in esecuzione. Se il computer entra in sospensione o Termbridge si chiude, la connessione termina. Le sessioni tmux restano comunque attive, quindi puoi riavviare Termbridge e riconnetterti. In modalità diretta Daytona, il server viene eseguito all'interno del sandbox, quindi puoi chiudere il portatile e riconnetterti in seguito.

## Più persone possono collegarsi contemporaneamente?

Non dallo stesso link. Ogni avvio genera un link di condivisione, valido una sola volta: chi lo apre per primo accede alla sessione, mentre chiunque altro riceve `invalid token`. Non è possibile generare un secondo link senza riavviare Termbridge.

Se riavvii mantenendo lo stesso URL pubblico (un tunnel denominato o `--public-url`), i browser che si erano collegati in precedenza mantengono le sessioni, quindi una seconda persona può scansionare il nuovo codice. Tutti i collegati allo stesso terminale vedono lo stesso output e possono digitare. Un Quick Tunnel riceve un nuovo URL a ogni avvio, quindi i browser già collegati devono eseguire di nuovo la scansione.
