# リモート GDB サーバーの構成

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

> **TL;DR**
> ローカル OS  ：macOS / Linux / Windows
>
>
>
> リモート OS  ：gdbserver、SSH、SFTP をサポートするものすべて
>
>
>
> 必要なツール  ：ターゲット上の [gdbserver](https://sourceware.org/gdb/onlinedocs/gdb/Server.html)
>
>
>
> バイナリファイル同期  ：自動
>
>
>
> クライアントデバッガー  : バンドルされた GDB / ツールチェーンの GDB / カスタム GDB
>
>
>
> ビルドターゲット  : CMake / Makefile / カスタムビルドターゲット

リモート GDB サーバー   構成は、ローカルにあなたのターゲットをビルドする  gdbserver  を下、リモートマシンにバイナリをアップロード起動して、CLion デバッガーを接続しています。

Procedure: リモート GDB サーバー構成を作成する

1. メインメニューで、   実行 | 実行構成の編集​   に移動し、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして、テンプレートのリストから   リモート GDB サーバー   を選択します。

2. 次の設定を指定します。

![リモート GDB サーバーの構成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_gdbserver_config.png)

* ターゲット​ と 実行可能ファイル ビルドするターゲット（ [CMake](quick-cmake-tutorial.html)、 [Makefile](makefiles-support.html)、 [カスタムターゲット](custom-build-targets.html)）とリモートでアップロードする実行可能ファイルを選択します。 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg) ボタンをクリックして、 `設定 | ビルド、実行、デプロイ | カスタムビルドターゲット` ダイアログで [カスタムターゲットを設定](custom-build-targets.html#customtarget-compdb)します。

* GDB クライアントデバッガーを選択します: バンドルされたマルチアーチ GDB（デフォルト）、ツールチェーンデバッガーの 1 つ、カスタム GDB バイナリ。

* 資格情報 ドロップダウンリストから既存の SSH 構成の 1 つを選択するか、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg) をクリックして新しい構成を作成します。 リモートマシンにアクセスするための資格情報を提供します。 ![リモートクレデンシャル](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_gdbserver_credentials.png) > **Tip:** > `設定 | ツール | SSH 構成` で SSH 構成を管理することもできます。

* 実行可能ファイルをアップロードする デバッグセッションを開始するたびに（ 常に ）、またはバイナリの変更時に（ 更新のみ ）実行可能ファイルをアップロードできます。 アップロードをスキップすることもできます（ なし ）。

* アップロードパス 実行可能ファイルが配置されるリモートフォルダーを指定します。

* 'target remote' 引数 デバッグパケットを伝送するメディアを提供します（シリアル回線または TCP または UDP を使用する IP ネットワーク）。 リモートターゲットへの接続の詳細については、 [gdb のドキュメント(英語)](https://sourceware.org/gdb/onlinedocs/gdb/Connecting.html#Connecting)を参照してください。

* GDB サーバー リモートマシン上で gdbserver の位置を設定します。 デフォルトのパスは自動的に埋められます。

* GDB サーバーの引数 gdbserver に渡す引数を指定してください：接続ポート、実行可能ファイルのパス、および必要であれば追加の引数。 デフォルトでは、このフィールドには、 'target remote' 引数 で指定したポートと、 アップロードパス からのパスとそれに続くバイナリ名が含まれます。

> **Note:**
> CMake プロジェクトのデフォルトでは、この構成は現在選択されている [CMake プロファイル](cmake-profile.html)を使用してターゲットをビルドし、   ビルドディレクトリ   フォルダーからバイナリを取得します。
>
>
>
> セットアップにクロスコンパイラーツールチェーンが必要な場合は、セッションを開始する前に、クロスコンパイラーツールチェーンを [作成](how-to-create-toolchain-in-clion.html)し、対応する  デバッグ プロファイルを構成し、このプロファイルに切り替えてください。

Procedure: リモートデバッグセッションを開始する

1. ツールチェーンデバッガーとして   GDB   を選択してください。

* macOS および Linux では、 `設定 | ビルド、実行、デプロイ | ツールチェーン` に移動し、現在のツールチェーンの デバッガー​ フィールドで使用可能な GDB オプションの 1 つを選択します。

* Windows では、 リモート GDB サーバー 構成は [Visual Studio ツールチェーン](quick-tutorial-on-configuring-clion-on-windows.html)と一緒には使用できません。利用される [デバッガー](quick-tutorial-on-configuring-clion-on-windows.html#msvc-debugger)が LLDB に基づいているためです。

> **Tip:**
> システムのファイアウォールがリモート GDB サーバーへの接続を許可していることを確認してください。

2. コードにブレークポイントを配置した後、新しく作成されたリモート GDB サーバー構成を選択し、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.startDebugger.svg) （ `Shift+F9` (Windows), `⌃ D` (macOS), `⇧ F9` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ D` (macOS System Shortcuts), `Shift+F9` (XWin), `Shift+F9` (GNOME), `Shift+F9` (KDE), `Shift+F9` (Emacs), `Shift+F9` (Sublime Text), `⌃ D` (Sublime Text (macOS)), `⌘ R` (Xcode), `Alt+F5` (Visual Studio), `⌥ F5` (Visual Studio (macOS)), `Alt+F5` (ReSharper), `⌥ F5` (ReSharper (macOS)), `F5` (QtCreator), `⌘ Y` (QtCreator (macOS)), `Ctrl+F5` (NetBeans), `Alt+Shift+D` (Eclipse), `⌘ F11` (Eclipse (macOS)) ）を押します。

* ビルドログは メッセージ ツールウィンドウで確認できます： ![ビルドログ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_gdbserver_buildlog.png)

* アップロードのプロセスを監視するには、 ファイル転送 ウィンドウに切り替えます： ![ファイル転送](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_gdbserver_filetransfer.png)

* デバッグ ツールウィンドウの コンソール タブに、GDB/gdbserver 接続のステータスが表示されます： ![リモートデバッグコンソール](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_gdbserver_console.png)

3. プログラムは通常通りデバッグできます。変数の確認、ステップ実行、式の評価、その他すべてのデバッグ機能が利用できます。

![リモート GDB サーバーを使用したデバッグ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_gdbserver_debugging.png)

## See also

### 外部リンク

[CLion Debugging Beyond the Basics - Part 3 - Beyond Local](https://blog.jetbrains.com/clion/2021/05/clion-debugging-beyond-the-basics-part-3-beyond-local) [Webinar Recording: Remote Development with CLion](https://blog.jetbrains.com/clion/2019/03/webinar-recording-remote-development-with-clion)

### ハウツー

[複雑なリモートシナリオ](complicated-remote-scenarios.html)

