# Усунення несправностей

## "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 Забагато запитів» від trycloudflare

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
- Текст помилки
- Кроки для відтворення проблеми