# トラブルシューティング

## "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)）。

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セッションが実行されていない可能性があります:

```bash
# Check if sessions exist
tmux ls
```

セッションが表示されているのにターミナルが空白の場合は、次を試してください:
- ページを再読み込みする
- シェルが`TERM=xterm-256color`に対応していることを確認する

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

QRコードには一度だけ使えるトークンが含まれています。Termbridgeの起動から90秒以内に限り、一度だけ使用できます。使用済みまたは期限切れのリンクには`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)で問題を報告してください:
- OSとNode.jsのバージョン
- エラーメッセージ
- 再現手順