メインコンテンツまでスキップ
バージョン: 4.6.1-saas

トラブルシューティング

このドキュメントでは、NetFUNNEL Cloudflare Agent使用中に発生する可能性のある一般的な問題と解決方法を提供します。

インストールと初期化​

Workerデプロイ失敗​

症状: Workerコードデプロイが失敗します。

解決方法:

  • Workerコードに構文エラーがないか確認
  • netfunnel-cloudflare-agent.jsファイルが正しくアップロードされているか確認
  • CloudflareアカウントのWorkers権限確認

環境変数設定が適用されない​

症状: 環境変数を設定したがエージェントが動作しません。

解決方法:

  • 環境変数の名前が正確か確認 (CLIENT_IDなど)
  • Workerをデプロイしたか確認
  • Workerデプロイ後、十分な時間(数分)待機

動作問題​

待機列が適用されない​

症状: トリガールールを設定したが待機列が適用されません。

解決方法:

  • NetFUNNELコンソールでセグメントトリガールールが正しく設定されているか確認
  • URLがトリガールールと一致するか確認
  • Workerのドメインとパス設定が正しいか確認
  • Workerがデプロイされているか確認

待機室にリダイレクトされない​

症状: 待機応答を受信したが待機室にリダイレクトされません。

解決方法:

  • Workerのパス設定が正しいか確認 (末尾に /* を含む)
  • 環境変数 VWR_PAGE_DOMAIN 設定確認
  • Workerデプロイ状態確認

ネットワーク問題​

Worker実行失敗​

症状: Workerが実行されない、またはエラーが発生します。

解決方法:

  • Workerコードにエラーがないか確認
  • 環境変数設定が正しいか確認
  • Cloudflare Workersサービス状態確認

設定問題​

ドメイン設定問題​

症状: ドメインでアクセスしたときにWorkerが実行されません。

解決方法:

  • DNS設定でCNAMEが正しく設定されているか確認
  • Proxyタイプに設定されているか確認 (オレンジ色のクラウドアイコン)
  • Workerのドメインとパス設定確認
  • DNS伝播時間待機 (最大24時間)

環境変数値が適用されない​

症状: 環境変数を設定したが値が反映されません。

解決方法:

  • 環境変数名前の大文字小文字確認
  • Workerデプロイの有無確認
  • Workerデプロイ後、キャッシュクリアまたは時間待機

関連ドキュメント​