Перейти к содержимому

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

Просмотреть как Markdown Редактировать на GitHub Документация по 1675df8

"spawn tmux ENOENT"

tmux не установлен или отсутствует в PATH. Termbridge выводит эту ошибку, но пока продолжает работу без терминала (#4); нажмите Ctrl+C, установите tmux и запустите снова.

Командная оболочка
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

"spawn cloudflared ENOENT"

Клиент туннеля Cloudflare не установлен или отсутствует в PATH. Он нужен только для режима туннеля; прямые режимы --no-tunnel и Daytona не требуют cloudflared.

Командная оболочка
# macOS
brew install cloudflared

Для Linux скачайте файл с сайта cloudflare.com/downloads.

Не удаётся запустить туннель

Проверьте несколько моментов (пропустите этот раздел, если используете прямой режим песочницы):

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

Если туннель не запускается, Termbridge выводит ошибку, останавливает сервер и завершает работу со статусом 1. Перехода в режим только для локальной сети не происходит, а сервер по умолчанию прослушивает только 127.0.0.1, поэтому другие устройства в вашей сети также не смогут подключиться. Сеансы tmux, созданные для этого запуска, продолжают работать (#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 не запущен:

Командная оболочка
# Check if sessions exist
tmux ls

Если сеансы отображаются, но окно терминала пустое, попробуйте:

  • Перезагрузить страницу
  • Убедиться, что ваша оболочка поддерживает TERM=xterm-256color

Код QR сканируется, но страница пуста

Код QR содержит одноразовый токен. Он действует один раз и только в течение 90 секунд после запуска Termbridge. При повторном использовании или истечении срока действия ссылка возвращает invalid token.

Решение: перезапустите Termbridge, чтобы создать новый код QR, и сразу отсканируйте его.

Ошибки node-pty о spawn-helper

Termbridge пытается исправить это автоматически, но при появлении ошибок разрешений:

Командная оболочка
chmod +x node_modules/node-pty/prebuilds/**/spawn-helper

Всё ещё не получается?

Создайте обращение на github.com/inline0/termbridge и укажите:

  • ОС и версию Node.js
  • Текст ошибки
  • Шаги для воспроизведения