Перейти до вмісту

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

Переглянути як 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>.

«429 Забагато запитів» від trycloudflare

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