# Отстраняване на проблеми

## "spawn tmux ENOENT"

tmux не е инсталиран или не е в PATH. Termbridge показва тази грешка, но засега продължава да работи, без да предоставя терминал ([#4](https://github.com/inline0/termbridge/issues/4)); натиснете `Ctrl+C`, инсталирайте tmux и го стартирайте отново.

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

## "spawn cloudflared ENOENT"

Клиентът за тунели на Cloudflare не е инсталиран или не е в PATH. Той е необходим само за режим с тунел; директните режими `--no-tunnel` и Daytona не изискват cloudflared.

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

За Linux изтеглете от [cloudflare.com/downloads](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/).

## Тунелът не се стартира

Ето няколко неща за проверка (пропуснете това, ако използвате директен режим с пясъчна среда):

1. Проверете дали cloudflared работи: `cloudflared --version`
2. Уверете се, че имате достъп до `https://trycloudflare.com`
3. Проверете дали защитна стена блокира изходящите връзки

Ако тунелът не успее да се стартира, Termbridge показва грешката, спира сървъра си и приключва с код за изход 1. Не преминава към режим само с локален достъп, а сървърът по подразбиране слуша само на `127.0.0.1`, така че другите устройства в мрежата ви също не могат да достигнат до него. Сесиите tmux, създадени за това стартиране, продължават да работят ([#4](https://github.com/inline0/termbridge/issues/4)).

За да използвате Termbridge без тунела Cloudflare, стартирайте го с `--no-tunnel --public-url <url>` зад собствен обратен прокси или тунел.

## „429 Too Many Requests“ от trycloudflare

Cloudflare ограничава честотата на тунелите без акаунт. Ако виждате грешки като `429 Too Many Requests`, опитайте:

1. Изчакайте няколко минути и опитайте отново
2. Уверете се, че няма останали активни стари процеси `cloudflared`
3. Използвайте токен за именуван тунел (препоръчително при честа употреба)

## Празен екран или „Неуспешно зареждане на терминалите“

Обикновено това означава, че браузърът няма валидна сесийна бисквитка, например защото е отворен без използване на връзка за споделяне или тунелът URL се е променил:

1. Проверете дали локалният сървър все още работи
2. Проверете конзолата на браузъра за грешки 401/403
3. Рестартирайте Termbridge, за да получите нов URL и код QR

## Няма изход в терминала

Възможно е сесията tmux да не работи:

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

Ако се показват сесии, но терминалът е празен, опитайте:
- Да презаредите страницата
- Да проверите дали вашата обвивка поддържа `TERM=xterm-256color`

## Кодът QR се сканира, но страницата е празна

Кодът QR съдържа еднократен токен. Той работи само веднъж и само в рамките на 90 секунди след стартирането на Termbridge. Използвана или изтекла връзка връща `invalid token`.

Решение: Рестартирайте Termbridge, за да генерирате нов код QR, и го сканирайте веднага.

## Грешки на node-pty относно spawn-helper

Termbridge се опитва да отстрани проблема автоматично, но ако видите грешки за разрешения:

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

## Все още не работи?

Създайте проблем в [github.com/inline0/termbridge](https://github.com/inline0/termbridge/issues) и включете:
- Вашата операционна система и версия на Node.js
- Съобщението за грешка
- Стъпките за възпроизвеждане