Skip to main content

GitHub Codespaces のポート フォワーディングのトラブルシューティング

ポートの転送に関する一般的な問題のトラブルシューティング手順。

Codespace 内で実行されているアプリケーションによってポートがコンソールに出力されると、GitHub Codespaces によってローカルホスト URL パターンが検出され、ポートが自動的に転送されます。 詳しくは、「codespace でのポートの転送」をご覧ください。

ポートが自動的に転送されない場合は、手動で転送できます。 詳しくは、「codespace でのポートの転送」をご覧ください。

ポート フォワーディングが設定されている場合は、次を確認してください。

  • VS Code の右下隅にポップアップ表示される通知 "トースト" メッセージのリンクを使うか、ターミナルの URL をクリックして転送されたポートを開きます。 ブラウザー経由で codespace に接続している場合、ローカル マシンに「localhost:8000」 (例) と入力しても、動作しません。
  • アプリケーションが codespace 内から引き続き実行されていることを確認してください。 一定期間にわたって非アクティブになった後で codespace が停止した場合は、codespace が再起動したら、必ずアプリケーションを再起動する必要があります。

通常は、転送されたポートをパブリックに、またはリポジトリを所有する組織内でアクセスできるようにします。 詳しくは、「codespace でのポートの転送」をご覧ください。 パブリックと組織のオプションのいずれか、または両方での可視性を実現できない場合、これは、組織レベルのポリシーが構成されていることを示しています。 詳しくは、「転送されるポートの可視性の制限」をご覧ください。

ポート転送に使われるドメイン GitHub は、随時変更される可能性があります。 テストなどで、コード内で転送されたポートを参照する場合は、URL をハードコーディングする代わりに環境変数を使うことをお勧めします。 詳しくは、「codespace の既定の環境変数」を参照してください。