トラブルシューティング

CC-Remoteでよくあるトラブルと、その解決方法をまとめました。

セットアップ時のトラブル

セットアップ中にエラーが出る

ネットワーク接続を確認してください。依存ファイルのダウンロードにインターネット接続が必要です。

Node.jsのバージョンが古い場合もエラーが出ます。以下で確認してください：

node --version

18以上が必要です。古い場合は nodejs.org から最新版をインストールしてください。

ビルドでエラーが出る

設定ファイル（.env）の内容が正しくない可能性があります。特にFirebase関連の設定が空になっていないか確認してください。

接続のトラブル

スマホから接続できない

以下を順番に確認してください：

1. PCでサーバーが動いているか？ — ターミナルにURLが表示されていればOK
2. 正しいURLを使っているか？ — https://xxxx.trycloudflare.com の形式のURL
3. 同じWi-Fiに接続しているか？ — 外部URLが使えない場合、PCとスマホが同じWi-Fiにいれば http://PCのIPアドレス:3737 でもアクセスできます

接続がよく切れる

CC-Remoteは自動で再接続を試みるので、通常はそのまま待てば復旧します。

頻繁に切れる場合は、Wi-Fiの電波状態を確認してください。

起動のトラブル

サーバーが起動しない

前回のサーバーがまだ動いている可能性があります。以下で再起動してください：

node scripts/restart.js

暗証番号を忘れた

以下のコマンドで新しい暗証番号を設定できます：

node reset-pin.js

外部接続ツール（cloudflared）が見つからない

外出先からアクセスするために必要なツールです。以下でインストールしてください：

winget install Cloudflare.cloudflared

詳しくはセットアップガイドをご覧ください。

それでも解決しない場合

GitHubのIssuesに問い合わせてください。