# GitHub Codespaces への接続のトラブルシューティング

GitHub Codespacesに接続するためのトラブルシューティングのヘルプ。

## 503 codespace サービスを使用できない

codespace は、30 分間アクティビティがないと停止するように設定されています。 停止した後で codespace を操作しようとすると、`503 service unavailable` エラーが表示されることがあります。

* \*\*\*\*またはブラウザー ウィンドウに Visual Studio Code] ボタンが表示されている場合は、\[**開始**] をクリックしてコードスペースに再接続します。
* ウィンドウを再度読み込んで、codespace をリセットします。
  [
  ](/ja/codespaces/reference/using-the-vs-code-command-palette-in-codespaces#accessing-the-vs-code-command-palette)のVisual Studio Codeで、\[**開発者: ウィンドウの再読み込み**]をクリックします。

## ブラウザーが接続できない

ブラウザーから codespace にアクセスできないことがあります。 その場合は、 <https://github.com/codespaces> にアクセスし、そのページから codespace に接続してみてください。

* そのページに codespace が表示されない場合は、自分が接続しようとしている codespace の所有者であることを確認します。 開くことができるのは、自分で作成した codespace だけです。
* codespace は表示されるのに、そのページから接続できない場合は、別のブラウザーを使って接続できるかどうかを調べます。

### エラー メッセージによる診断

#### "おっと! オフラインのようです"

安定したインターネット接続があり、企業ネットワークによって接続がブロックされていないことを確認します。 可能であれば、デバイスで拒否された接続をログで確認します。

拒否された接続が表示される場合は、`/meta` REST API エンドポイントによって文書化されたドメイン がファイアウォールによってブロックされていないことを確認します。 詳しくは、「[メタデータ用 REST API エンドポイント](/ja/rest/meta/meta#get-github-meta-information)」をご覧ください。

GitHub Codespacesで必要なドメインの一覧を取得するには、GitHub CLIを使用して次のコマンドを実行します。

`gh api meta --jq .domains.codespaces`

### "codespace 情報の取得に問題があります"

これは切り替えエラーです。 数分置いてからもう一度お試しください。

### "接続を認証できませんでした"

これは、認証に問題が発生したことを示します。 ローカル記憶域とクッキーをクリアして、もう一度やり直してください。

それでも接続できない場合、表示されているメッセージがこの一覧にない場合は、Codespaces で[](https://www.githubstatus.com/)のサービスの可用性を確認してください。
Codespaces サービスが使用可能な場合は、サポートにお問い合わせください。 詳しくは、「[GitHub Codespacesのサポートと連携する](/ja/codespaces/troubleshooting/working-with-support-for-github-codespaces)」をご覧ください。

## JupyterLab で codespace に接続できない

JupyterLab で codespace を使用できるようにするには、codespace にそれがインストールされていることを確認する必要があります。
GitHub Codespacesによって使用される既定の開発コンテナー イメージには JupyterLab が含まれていますが、開発コンテナー構成をカスタマイズした場合は、JupyterLab を手動でインストールする必要があります。

codespace で Debian ベースのイメージが使用されている場合は、`python` オプションを `devcontainer.json` に設定して `installJupyterlab` 機能を `true` ファイルに追加することで、開発コンテナーに JupyterLab をインストールできます。 それ以外の場合は、Dockerfile に直接インストールします。 インストール手順については、JupyterLab のドキュメントの「[インストール](https://jupyterlab.readthedocs.io/en/stable/getting_started/installation.html)」を参照してください。

`python` 機能の詳細については、[`devcontainers/features` リポジトリ](https://github.com/devcontainers/features/tree/main/src/python)の README ページを参照してください。
`devcontainer.json` ファイルと Dockerfile について詳しくは、「[開発コンテナーの概要](/ja/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers#devcontainerjson)」をご覧ください。

それでも接続できない場合は、 サポートにお問い合わせください。 詳しくは、「[GitHub Codespacesのサポートと連携する](/ja/codespaces/troubleshooting/working-with-support-for-github-codespaces)」をご覧ください。

## GitHub CodespacesVisual Studio Code 用の拡張機能は接続できません

Visual Studio Codeデスクトップからコードスペースに接続できない場合は、次のトラブルシューティング手順を使用します。

1. 最新バージョンの GitHub Codespaces 拡張機能がインストールされていることを確認します。 拡張機能はプレビュー リリースであり、頻繁に更新プログラムがリリースされます。
   1. Visual Studio Codeで、\[拡張機能] タブを表示します。
   2. GitHub Codespaces拡張機能を選択して、拡張機能の概要ページを表示します。
   3. 更新プログラムが利用可能な場合は、ボタンが表示されたら、 **\[X.X.X に更新する]** をクリックして最新バージョンにアップグレードします。
2. Visual Studio Codeの安定したビルドを使用しているか、[Visual Studio Code Insider](https://code.visualstudio.com/insiders/) リリース (夜間更新) を使用しているかを確認します。 Insiders リリースを使っている場合は、[安定したビルド](https://code.visualstudio.com/)をインストールしてみます。
3. 企業ネットワークで接続がブロックされていないことを確認します。
   1. `connect EACCES`、`connect ECONNREFUSED`、`getaddrinfo ENOTFOUND`、またはその他のなどの類似したエラーを受信した場合、ファイアウォールが接続サービスへの接続をブロックしている可能性があります。 これを検証するには、[この URL](https://global.rel.tunnels.api.visualstudio.com/api/version) にアクセスしてください。 要求が失敗した場合、またはデータが表示されない場合は、システム管理者がファイアウォールの IP 許可一覧に追加 `*.visualstudio.com` する作業が必要な場合があります。
   2. `Tunnel service HTTPS certificate is invalid. This may be caused by the use of a self-signed certificate or a firewall intercepting the connection`エラーが表示された場合は、ファイアウォールが TLS 検査を実行し、GitHubが検証できない自己署名証明書を挿入している可能性があります。 これを解決するには、システム管理者が `*.visualstudio.com` に検査のバイパスを許可するか、ファイアウォールがローカル コンピューターに挿入しているルート CA をインストールする必要があります。

それでも接続できない場合は、 サポートにお問い合わせください。 詳しくは、「[GitHub Codespacesのサポートと連携する](/ja/codespaces/troubleshooting/working-with-support-for-github-codespaces)」をご覧ください。

### codespace に待ち時間の問題がある

codespace が特に遅いと思われる場合、または待ち時間の問題がある場合は、遠いリージョンに作成されている可能性があります。 これを解決するには、[GitHub Codespacesリージョンを手動で設定します](/ja/codespaces/setting-your-user-preferences/setting-your-default-region-for-github-codespaces)。