Ugrás a tartalomhoz

Hibaelhárítás

"spawn tmux ENOENT"

A tmux nincs telepítve, vagy nem szerepel a PATH-ban. A Termbridge kiírja ezt a hibát, de jelenleg tovább fut terminál kiszolgálása nélkül (#4); nyomja meg a Ctrl+C billentyűt, telepítse a tmux eszközt, majd indítsa újra.

Shell
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

"spawn cloudflared ENOENT"

A Cloudflare alagútkliens nincs telepítve, vagy nem szerepel a PATH-ban. Erre csak alagút módban van szükség; a --no-tunnel és a Daytona közvetlen módhoz nem szükséges a cloudflared.

Shell
# macOS
brew install cloudflared

A Linux esetében töltse le innen: cloudflare.com/downloads.

Nem indul el az alagút

Ellenőrizzen néhány dolgot (ha közvetlen sandboxmódot használ, ezt kihagyhatja):

  1. Ellenőrizze, hogy működik-e a cloudflared: cloudflared --version
  2. Győződjön meg róla, hogy eléri a https://trycloudflare.com címet
  3. Ellenőrizze, nem blokkolja-e tűzfal a kimenő kapcsolatokat

Ha az alagút nem indul el, a Termbridge kiírja a hibát, leállítja a szerverét, és 1-es állapotkóddal kilép. Nem vált át csak helyi módra, és a szerver alapértelmezés szerint csak a 127.0.0.1 címen figyel, így a hálózat más eszközei sem érik el. Az adott futtatás során létrehozott tmux munkamenetek tovább futnak (#4).

A Cloudflare alagút nélkül a Termbridge saját fordított proxy vagy alagút mögött futtatható a --no-tunnel --public-url <url> használatával.

„429 Too Many Requests” hiba a trycloudflare szolgáltatástól

A Cloudflare korlátozza a fiók nélküli alagutak sebességét. Ha ilyen hibákat lát: 429 Too Many Requests, próbálja meg a következőket:

  1. Várjon néhány percet, majd próbálja újra
  2. Ellenőrizze, hogy nem fut-e még régi cloudflared folyamat
  3. Használjon névvel ellátott alagúttokent (gyakori használat esetén ajánlott)

Üres képernyő vagy „Unable to load terminals” hiba

Ez általában azt jelenti, hogy a böngészőben nincs érvényes munkamenet-süti, például mert a megosztási hivatkozás beváltása nélkül nyitották meg az oldalt, vagy megváltozott az alagút URL értéke:

  1. Ellenőrizze, hogy a helyi szerver még fut-e
  2. Keresse meg a böngésző konzoljában a 401/403 hibákat
  3. Indítsa újra a Termbridge eszközt új URL és QR kód létrehozásához

Nincs kimenet a terminálban

Lehet, hogy a tmux munkamenet nem fut:

Shell
# Check if sessions exist
tmux ls

Ha a munkamenetek megjelennek, de a terminál üres, próbálja meg:

  • Az oldal újratöltését
  • Annak ellenőrzését, hogy a parancsértelmező támogatja-e a TERM=xterm-256color értéket

A QR kód beolvasása után üres az oldal

A QR kód egyszer használható tokent tartalmaz. Csak egyszer működik, és csak a Termbridge indulását követő 90 másodpercen belül. A felhasznált vagy lejárt hivatkozás invalid token választ ad.

Megoldás: Indítsa újra a Termbridge eszközt új QR kód létrehozásához, majd azonnal olvassa be.

node-pty hibák a spawn-helperrel kapcsolatban

A Termbridge megpróbálja automatikusan kijavítani ezt, de ha jogosultsági hibát lát:

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

Még mindig elakadt?

Nyisson hibajegyet itt: github.com/inline0/termbridge, és adja meg a következőket:

  • Az operációs rendszer és a Node.js verziója
  • A hibaüzenet
  • A hiba előidézésének lépései