コンテンツへスキップ

トラブルシューティング

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）。

Cloudflareトンネルを使わずにTermbridgeを使用するには、--no-tunnel --public-url <url>を指定して実行し、自分のリバースプロキシまたはトンネルの背後に配置してください。

trycloudflareからの「429 Too Many Requests」

Cloudflareはアカウントなしのトンネルにレート制限を設けています。429 Too Many Requestsのようなエラーが表示された場合は、次を試してください:

  1. 数分待ってから再試行する
  2. 古いcloudflaredプロセスが実行中でないことを確認する
  3. 頻繁に使う場合は、名前付きトンネルトークンを使用する（推奨）

画面が空白、または「Unable to load terminals」と表示される

ブラウザーに有効なセッションCookieがない場合に発生します。たとえば、共有リンクを使用せずに開いた場合や、トンネルのURLが変更された場合です:

  1. ローカルサーバーがまだ実行中か確認する
  2. ブラウザーのコンソールで401/403エラーを確認する
  3. Termbridgeを再起動し、新しいURLとQRコードを取得する

ターミナルに出力が表示されない

tmuxセッションが実行されていない可能性があります:

シェル
# Check if sessions exist
tmux ls

セッションが表示されているのにターミナルが空白の場合は、次を試してください:

  • ページを再読み込みする
  • シェルがTERM=xterm-256colorに対応していることを確認する

QRコードをスキャンしてもページが空白になる

QRコードには一度だけ使えるトークンが含まれています。Termbridgeの起動から90秒以内に限り、一度だけ使用できます。使用済みまたは期限切れのリンクにはinvalid tokenが返されます。

解決方法: Termbridgeを再起動して新しいQRコードを生成し、すぐにスキャンしてください。

node-ptyのspawn-helperに関するエラー

Termbridgeはこの問題を自動的に修正しようとしますが、権限エラーが表示される場合:

シェル
chmod +x node_modules/node-pty/prebuilds/**/spawn-helper

まだ解決しませんか?

次の情報を添えてgithub.com/inline0/termbridgeで問題を報告してください:

  • OSとNode.jsのバージョン
  • エラーメッセージ
  • 再現手順