# Устранение неполадок

## "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>`.

## Ответ trycloudflare: «429 Too Many Requests»

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

1. Подождите несколько минут и повторите попытку
2. Убедитесь, что старые процессы `cloudflared` не работают
3. Используйте токен именованного туннеля (рекомендуется при частом использовании)

## Пустой экран или «Не удалось загрузить терминалы»

Обычно это означает, что в браузере нет действительного файла cookie сеанса, например потому, что страницу открыли без перехода по ссылке общего доступа или изменился туннель 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
- Текст ошибки
- Шаги для воспроизведения