トラブルシューティング

JetBrains IDE のリモート開発機能はまだ開発段階にあるため、問題が発生する可能性があります。このページは、セットアップ中またはその後の作業中の最初のトラブルシューティングに役立つことを目的としています。

セットアップ

質問	回答
JetBrains Gateway と Toolbox、個別にダウンロードしたもの、IDE からのものの間に違いはありますか ?	スタンドアロン JetBrains Gateway は、 Space ベースのプロジェクトを「IDE で開く」オプションをサポートしています。これを使用しない場合、インストーラーとワークフローにその他の違いはありません。インストールシナリオを確認してください。
リモート開発をリモートサーバー上の既存の IDE に向けることはできますか ? IDE を手動でインストールすることは可能ですか ?	バージョン 221.5481 以降、既存のバックエンド IDE をリモートサーバーに手動で登録し、JetBrains Gateway で表示できるようになりました。インストールされた IDE が利用可能なビルドのリストに表示されます。 SSH でリモートサーバーに入ります。解凍された IDE があるフォルダーを見つけて、 `bin` フォルダーに入ります。コマンドラインで、次のコマンドを実行します。 remote-dev-server.sh registerBackendLocationForGateway 以下に例を示します。 sh IDEA-221.5591.52/bin/remote-dev-server.sh registerBackendLocationForGateway
JetBrains Gateway のインストール自体が正常に完了しない	システムユーザーにソフトウェアをインストールする権限があることを確認するか、組織のシステム管理者に連絡してください。
セットアップ中にリモートサーバーへの SSH 接続が失敗するのはなぜですか ?	リモートサーバー側のファイアウォールまたは仮想マシンプロバイダーが受信接続を禁止しています。 AWS の場合は「セキュリティグループ」の調整も忘れずにリモート側では、SSH は非標準ポートをリッスンします。パスワードまたはキーファイルが正しくないか、いくつかのエラーにより接続がブロックされました
JetBrains Gateway が IDE バージョンを取得ステップでハングし、利用可能な IDE をロードしない	JetBrains Gateway は JetBrains のサイト(英語)に接続して既存のビルドのリストを取得できません
JetBrains Gateway は接続を試行しますが、失敗します。資格情報は 100% が正しいです。	リモート IDE プロセスのトラフィックをローカルマシンにリダイレクトするために必要なため、リモートサーバーの `sshd_config` で `AllowТcpForwarding` が有効になっていることを確認します。
ローカルマシンから IDE インストーラーを選択しましたが、アップロードプロセスが失敗します	リモートサーバーのディスクに十分な空き容量がありません。リモートサーバーの使用可能なスペースは、サイズが少なくとも 4xIDE.tar.gz でなければなりません。バージョン 2022.1.1 以降、リモートサーバー上のカスタムパスをデプロイターゲットの場所として選択できます。アップロードしたのは .tar.gz インストーラーアーカイブではないため、リモート側で展開できません。 Community バージョンのアーカイブをアップロードしました。リモート開発は有料版で利用できます。
リモート -dev-worker のアップロードが「終了コード」で失敗する: 139 (SIGSEGV)」	リモートマシンの OS が RHEL、CentOS、RockyLinux の場合 - syslog で SELinux の警告を確認するか、SELinux を無効にしてインストールを再試行します。
ローカルマシンでプロセスが失敗し、「JetBrains Client のダウンロードに失敗しました」というエラーが表示される	ローカルコンピューターには、次の JetBrains URL へのネットワーク接続が必要です。 https://code-with-me.jetbrains.com https://download.jetbrains.com https://download-cf.jetbrains.com https://download-cdn.jetbrains.com https://cache-redirector.jetbrains.com または、完全オフラインモードを構成することもできます。

リモートプロジェクトの操作

質問	回答
60 秒以内に IDE ステータスを取得できませんでした。おそらく IDE バックエンドがスタックしています	バックエンドサーバーのシェルが対話型であるか、構成エラーがあるため、デプロイコマンドが正しく終了しません。デフォルトの構成または単純な bash に置き換えてみてくださいリソース不足のためにバックエンド IDE がハングし、応答しません。 1. ssh でリモートサーバーに入り、手動で IDE プロセスを終了する 2. JVM オプションファイルを編集して、リモート IDE にメモリを追加します。デフォルトのデプロイ設定は、平均的なプロジェクトや大規模なプロジェクトには適していない場合があります。 3. リモート IDE JVM 設定ファイルを見つける `$IDE_BIN_DIR/${IDE_PRODUCT_VM_OPTIONS}.vmoptions` 次の例を確認してください。 `./.cache/JetBrains/RemoteDev/dist/a17ad99f7faf8_ideaIU-2021.3.1/bin/idea64.vmoptions` 4.`-Xmx` 値を編集し、新しい設定でデプロイ / 接続を繰り返する一般に、バックエンド IDE はプロジェクトを処理できません (リソースの不足、構成の誤り、依存関係の破損)。 ssh でリモートサーバーに入り、このページの説明に従って手動でプロジェクトを起動し、出力を確認します。プロジェクトが正常に開始された場合は、生成されたリンクをコピーし、ローカルゲートウェイからの接続を試行します (この記事でも説明されています)。
CPU またはリソースの使用率が異常に見える	パフォーマンスの問題を診断するには、ログ (ヘルプ -> ホストとクライアントのログを収集) 、サーバー (ヘルプ -> 診断ツール -> CPU 使用率プロファイリングの開始)からの CPU スナップショット、およびヒープダンプ（`java_error_in_idea*.hprof` のようなファイル）パフォーマンスの問題の診断について詳しくは、パフォーマンス問題の報告を参照してください。
IDE がハングして応答しない	IDE がハングして応答しないため、メニューを使用してスナップショットをキャプチャーできない場合は、スレッドダンプを提供してください。
リモート IDE は機能しましたが、応答を停止しました	リモートサーバーに入り、IDE プロセスを終了するか、サーバーを再起動して再テストします。

ログの収集とレポートの送信

上記の解決策が役に立たず、サポートが必要な場合は、詳細な説明を提供してください。必須の IDE バージョン、ログ、スレッドダンプに加えて、問題を説明するコード / プロジェクトサンプル、スクリーンショット、スクリーンキャスト /GIF を提供していただければ幸いです。

レポートを送信する際に、問題にアタッチしてください(英語)。

問題を JetBrains チームだけに見えるようにするには、その可視性を jetbrains-team グループに設定します。イメージを除いて、すべての添付ファイルはデフォルトで JetBrains チームのみに表示されます。

UI からログを収集する

JetBrains Gateway から: ようこそ (スタート) 画面 - 左下隅 - 歯車アイコン - 「ログと診断データの収集」。
リモート開発の開始点として使用するメイン IDE から: トップメニュー - 「ヘルプ」 - 「ログと診断データの収集」。
開始された JetBrains Client セッションから (リモートサーバーに接続されている): トップメニュー - " ヘルプ " - 「ホストとクライアントのログを収集する」

ログを手動で収集する

ローカルワークステーション側: 場所は、ローカルコンピューターの OS によって異なります。
IDE で使用されるディレクトリからログのフォルダー全体を収集して送信することをお勧めします。
リモートサーバー上: ログは IDE ごとにインストールフォルダーに保存されます。
デフォルトのインストールパスは ~/.cache/JetBrains/<product><versions>/log/ です
例: ~/.cache/JetBrains/IntelliJIdea2024.1/log/

2026 年 3 月 30 日