Към съдържанието

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

Преглед като 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 Too Many Requests“ от trycloudflare

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

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

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

Обикновено това означава, че браузърът няма валидна сесийна бисквитка, например защото е отворен без използване на връзка за споделяне или тунелът 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
  • Съобщението за грешка
  • Стъпките за възпроизвеждане