# Vianmääritys

## "spawn tmux ENOENT"

tmux ei ole asennettu tai sitä ei löydy PATH-muuttujasta. Termbridge tulostaa tämän virheen mutta jatkaa tällä hetkellä toimintaansa tarjoamatta päätelaitetta ([#4](https://github.com/inline0/termbridge/issues/4)); paina `Ctrl+C`, asenna tmux ja käynnistä se uudelleen.

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

## "spawn cloudflared ENOENT"

Cloudflare-tunneliasiakasta ei ole asennettu tai sitä ei löydy PATH-muuttujasta. Sitä tarvitaan vain tunnelitilassa; suora tila ei tarvitse `--no-tunnel`- eikä Daytona-tilassa komponenttia cloudflared.

```bash
# macOS
brew install cloudflared
```

Lataa Linux osoitteesta [cloudflare.com/downloads](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/).

## Tunneli ei käynnisty

Tarkista seuraavat asiat (ohita tämä, jos käytät hiekkalaatikon suoraa tilaa):

1. Varmista, että cloudflared toimii: `cloudflared --version`
2. Varmista, että saat yhteyden kohteeseen `https://trycloudflare.com`
3. Tarkista, estääkö palomuuri lähtevät yhteydet

Jos tunneli ei käynnisty, Termbridge tulostaa virheen, pysäyttää palvelimensa ja päättyy tilaan 1. Se ei siirry paikalliseen tilaan, ja oletusarvoisesti palvelin kuuntelee vain osoitteessa `127.0.0.1`, joten muut laitteet verkossasi eivät myöskään saa siihen yhteyttä. Kyseistä suoritusta varten luodut tmux-istunnot jäävät käyntiin ([#4](https://github.com/inline0/termbridge/issues/4)).

Voit käyttää Termbridge-palvelua ilman Cloudflare-tunnelia suorittamalla sen `--no-tunnel --public-url <url>`-valitsimella oman käänteisen välityspalvelimen tai tunnelin takana.

## trycloudflaren ilmoitus "429 Too Many Requests"

Cloudflare rajoittaa tunnuksettomien tunnelien käyttöä. Jos näet esimerkiksi virheen `429 Too Many Requests`, kokeile seuraavaa:

1. Odota muutama minuutti ja yritä uudelleen
2. Varmista, ettei vanhoja `cloudflared`-prosesseja ole enää käynnissä
3. Käytä nimettyä tunnelitokenia (suositellaan säännölliseen käyttöön)

## Tyhjä näyttö tai "Unable to load terminals"

Tämä tarkoittaa yleensä, ettei selaimessa ole kelvollista istuntoevästettä. Näin voi käydä esimerkiksi, jos sivu avattiin lunastamatta jakolinkkiä tai tunnelin URL muuttui:

1. Tarkista, onko paikallinen palvelin yhä käynnissä
2. Etsi selaimen konsolista 401/403-virheitä
3. Käynnistä Termbridge uudelleen saadaksesi uudet URL- ja QR-koodit

## Päätelaitteessa ei näy tulostetta

tmux-istunto ei ehkä ole käynnissä:

```bash
# Check if sessions exist
tmux ls
```

Jos istunnot näkyvät mutta päätelaite on tyhjä, kokeile seuraavaa:
- Lataa sivu uudelleen
- Tarkista, tukeeko käyttämäsi komentotulkki `TERM=xterm-256color`-toimintoa

## QR-koodin skannaus avaa tyhjän sivun

QR-koodi sisältää kertakäyttöisen tokenin. Se toimii vain kerran ja ainoastaan 90 sekunnin kuluessa siitä, kun Termbridge käynnistyy. Käytetty tai vanhentunut linkki palauttaa arvon `invalid token`.

Ratkaisu: Luo uusi QR-koodi käynnistämällä Termbridge uudelleen ja skannaa se heti.

## node-pty-virheet spawn-helperistä

Termbridge yrittää korjata tämän automaattisesti. Jos näet käyttöoikeusvirheitä:

```bash
chmod +x node_modules/node-pty/prebuilds/**/spawn-helper
```

## Eikö ongelma ratkennut?

Avaa ongelmaraportti osoitteessa [github.com/inline0/termbridge](https://github.com/inline0/termbridge/issues) ja lisää mukaan:
- Käyttöjärjestelmäsi ja sen Node.js-versio
- Virheilmoitus
- Toistamiseen tarvittavat vaiheet