# リモートデバッグ構成

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

> **TL;DR**
> ローカル OS  : GDB 用の macOS / Linux / Windows、LLDB 用の macOS / Linux
>
>
>
> リモート OS  : GDB をサポートする gdb サーバー、macOS / Linux 用、または LLDB をサポートする他の lldb-サーバー
>
>
>
> 必要なツール  : ターゲット上の [gdb サーバー](https://sourceware.org/gdb/onlinedocs/gdb/Server.html) または [lldb-サーバー](https://lldb.llvm.org/man/lldb-server.html)
>
>
>
> バイナリおよびシンボルファイルの同期  : マニュアル
>
>
>
> クライアントデバッガー  : バンドルされた GDB またはバンドルされた LLDB、ツールチェーンの GDB、カスタム GDB

リモートデバッグ   構成を使用すると、  gdbserver  または  lldb-server  でリモートデバッグできます。 デバッグ情報を含む実行可能ファイルがすでにあり、プロジェクトをビルドするために CLion が必要ない場合は、この構成を使用してください。 この構成は、特定のビルドシステムまたはプロジェクト形式に依存しません。

> **Tip:**
> 以下で使用する用語：  ローカルマシン （  ホスト ）は CLion および GDB/LLDB クライアントを実行する場所、  リモートマシン （  ターゲット ）は gdb サーバー／lldb-サーバー上でアプリケーションを起動する場所。

リモートデバッグ構成を使用すると、  任意のビルドシステムでビルドされた アプリケーションをリモートでデバッグできます。 必要なのは、デバッグシンボルがローカルマシン上に存在していることだけです。

## ターゲットプラットフォーム

GDB/gdbserver:

gdbserver をサポートしている場合、ターゲット環境に制限はありません。

プログラムは、 [Raspbian OS](https://www.raspberrypi.org/software/operating-systems/)（ [Raspberry Pi OS ガイド](https://www.pcwdld.com/raspbian-raspberry-pi-os-guide)を参照）、クラウドプラットフォーム、または [Docker](docker.html) コンテナ内など、Linux ベースの組み込みを含む任意の OS でリモート実行できます。 リモート gdbserver プロトコルに準拠した   GDB スタブ   に接続できます。たとえば、OS カーネルのデバッグには [Qemu](https://en.wikibooks.org/wiki/QEMU/Debugging_with_QEMU)、フラッシュ済みファームウェアのデバッグには [OpenOCD](https://openocd.org) です。

デフォルトでクライアントデバッガーとして使用される CLion にバンドルされた GDB は、   マルチアーキテクチャ   サポートで構築されており、多様な Linux/Windows/macOS や組み込みケースでのリモートクロスプラットフォームデバッグに適しています。 サポートされているターゲットの完全なリストは以下を参照してください。

Procedure: バンドルされた GDB でサポートされているリモートターゲット

```CONSOLE
i686-pc-mingw32
i686-w64-mingw32
x86_64-w64-mingw32
i686-linux-gnu
x86_64-linux-gnu
aarch64-linux-gnu
alpha-linux-gnu
arm-linux-gnu
arm-linux-gnueabi
arm-linux-gnueabihf
hppa-linux-gnu
ia64-linux-gnu
m68k-linux-gnu
m68k-rtems
mips-linux-gnu
mipsel-linux-gnu
mips64-linux-gnu
mips64el-linux-gnu
powerpc-linux-gnu
powerpc-linux-gnuspe

```

LLDB/lldb-サーバー:

macOS、Linux、Android、Apple TV/Apple Watch、および lldb-server をサポートするその他のプラットフォームをターゲットにすることができます。 LLDB ドキュメントの [ローカルシステム(英語)](https://lldb.llvm.org/use/remote.html#local-system)を参照する

## ワークフローの一般的な手順

リモート GDB/LLDB デバッグのために実行する手順の簡単な説明を以下に示します。 各ステップの詳細については、次の章で説明します。

1.

デバッグ情報付きバイナリ   を準備してください。 必要に応じて、クロスプラットフォームツールチェーンを使用します。

リモート LLDB の場合、デバッガーはデバッグシンボルやシステムライブラリを自動的にダウンロードしないため、それらはローカルマシン上に存在している必要があります。 macOS から Linux または Linux から macOS へのクロスプラットフォームデバッグの場合は、必要なライブラリとともに提供される [musl(英語)](https://musl.libc.org/) (または代替手段) によるクロスコンパイルを使用します。

2.

リモートマシン上のバイナリ   を配置   ローカルマシン上のシンボルファイル   を配置してください。

通常、デバッグ実行可能ファイル自体はシンボルファイルとして機能しますが、これは別のファイルでもかまいません。

> **Note:**
> リモートデバッグ構成ではファイルが同期されないため、バイナリとシンボルファイルを追跡し、変更があった場合は手動で同期する必要があります。

3.

CLion で、 [作成](#remote-config)した   リモートデバッグ   構成。 指定する設定は、デバッガーがリモートセッション中にブレークポイントで停止できるようにするために重要であるため、構成の設定を再確認することをお勧めします。

4.    リモートマシン上の gdbserver/lldb-server   でプログラムを [起動](#launch-remote-debug)します。

5.  CLion に戻り、ステップ 3 で作成した [構成のデバッグを開始します](#start-remote-debug)。

Procedure: リモートデバッグ構成を作成する

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

2. ![リモート実行 / デバッグ構成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remoteConfig.png)

クライアントデバッガー (バンドルされた GDB/ バンドルされた LLDB、ツールチェーン GDB デバッガーの 1 つ、またはカスタム GDB バイナリ) を選択し、対応する設定を指定します。

GDB:

* 'target remote' 引数 – リモートシステムのアドレスは次の形式です。 ``` <host>:<port> ``` 例： ``` 127.0.0.1:1234 ``` [代替形式(英語)](https://sourceware.org/gdb/onlinedocs/gdb/Connecting.html#Connecting)を使用することもできます。

* シンボルファイル 。 これはデバッグシンボル付きファイルのローカルマシン上のパスであり、ターゲットで実行されている実行可能ファイルの非ストリップ版や、デバッグ情報のみを含む [ELF](https://en.wikipedia.org/wiki/Executable_and_Linkable_Format) ファイルである場合があります。 > **Tip:** > 共有オブジェクトライブラリ のデバッグ時は、 `.so` ファイルをシンボルファイルとして指定しないでください。 `.so` をシンボルファイルとすると、デバッガーはソースの場所を 2 つ解決します。1 つは実際のメモリアドレス、もう 1 つは `.so` ファイル内のアドレスですが、これは有効なメモリアドレスではありません。 その結果、ステップ実行およびその他のデバッグアクションが正しく動作しません。 最近のバージョンの GDB クライアントは gdbserver からシンボルを自動的に転送できるため、ターゲット上で実行されている実行ファイルがストリップされていないバイナリである場合は、このフィールドを空のままにしておくと、うまく機能する可能性があります。

* Sysroot は、GDB クライアントによって、ローカルシステム上のデバッグシンボルを含むターゲットライブラリのコピーにアクセスするために使用され、ブレークポイントを設定したり、ライブラリコード内のソース行を検索したりできるようになります。 > **Tip:** > 最近の GDB バージョンのほとんどはこれらのファイルを自動的にダウンロードするため、このフィールドはオプションです。 ただし、自動ダウンロードによりデバッグプロセスが大幅に遅くなる可能性があることに注意してください。 > > > > ライブラリをデフォルト以外のローカルディレクトリに手動でコピーすることもできます。 その場合は、このフィールドにパスを入力すると、GDB はそのパスを使用します。

LLDB:

* 「プロセス接続」URL 。 次の表記を使用します。 ``` connect://<host>:<port> ``` 例： ``` connect://127.0.0.1:1234 ```

* シンボルファイル 。 これはデバッグシンボル付きファイルのローカルマシン上のパスであり、ターゲットで実行されている実行可能ファイルの非ストリップ版や、デバッグ情報のみを含む [ELF](https://en.wikipedia.org/wiki/Executable_and_Linkable_Format) ファイルである場合があります。 > **Tip:** > 共有オブジェクトライブラリ のデバッグ時は、 `.so` ファイルをシンボルファイルとして指定しないでください。 `.so` をシンボルファイルとすると、デバッガーはソースの場所を 2 つ解決します。1 つは実際のメモリアドレス、もう 1 つは `.so` ファイル内のアドレスですが、これは有効なメモリアドレスではありません。 その結果、ステップ実行およびその他のデバッグアクションが正しく動作しません。 CLion は [g\[dbserver\]](https://lldb.llvm.org/man/lldb-server.html) モードで lldb-サーバーを使用するため、すべてのファイルを手動で転送する必要があります。

* Sysroot は、LLDB クライアントによって、ローカルシステム上のデバッグシンボルを含むターゲットライブラリのコピーにアクセスするために使用され、ブレークポイントを設定したり、ライブラリコード内のソース行を検索したりできるようになります。 > **Note:** > ホストとは異なるリモートプラットフォームでクロスコンパイルなしでビルドされたバイナリをデバッグするには、sysroot を指定する必要があります (たとえば、macOS ホストからデバッグしていて、リモート Linux マシンが Linux システムライブラリにリンクされたバイナリを実行している場合など)。

*

* パスマッピング 。 このペインを使用して、ホスト上のローカルパス ( ローカル 列) にマップされるターゲットマシン上のパス ( リモート 列) を指定します。

Procedure: gdbserver/lldb-server でプログラムをリモートで起動する

ターゲットでアプリケーションを起動するには、リモートターミナルを利用するか、CLion の組み込み [SSH ターミナル](running-ssh-terminal.html) を呼び出して [ポート転送を実行](security-model.html#port_forwarding)できます。

GDB:

次のコマンドを使用して gdbserver を実行します。

```
gdbserver <TCP hostname>:<port> <program name & args>
```

![リモート ssh ターミナル](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remoteTerminal.png)

あるいは、シリアルポート経由で接続することもできます。

```
gdbserver <device name> <program name & args>
```

シリアルライン接続を確立する場合は、代わりにデバイス名を指定します。

LLDB:

LLDB の場合、  `lldb-server g *:1234 ./binary`  のようなコマンドで lldb-server を起動します。

macOS では、  debugserver  を lldb-server として使用します。

```
debugserver <host>:<port> <program name & args>

```

例：

```
debugserver 192.168.1.226:1234 ./binary
```

> **Tip:**
> デフォルトでは、debugserver は  `/Applications/Xcode.app/Contents/SharedFrameworks/LLDB.framework/Versions/A/Resources/debugserver`  (Xcode ディストリビューションの一部) または  `/Library/Developer/CommandLineTools/Library/PrivateFrameworks/LLDB.framework/Versions/A/Resources/debugserver`  (コマンドラインツールの一部) にあります。

起動すると、gdbserver/lldb-server はエントリポイントでプログラムを一時停止し、クライアントデバッガーが接続されるのを待機します。

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

CLion でコードにブレークポイントを設置したら、   リモートデバッグ   構成を選択し、デバッグ ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.startDebugger.svg) セッションを開始します。

CLion のデバッガーは実行中のリモートプロセスに接続します。 ターミナルには  Remote debugging from host..  メッセージが表示され、デバッガーコンソールでも  Debugger connected to..  メッセージを確認できます。

これで、ローカルで実行されているかのようにコードをインスペクションできます ( [ステップ実行](stepping-through-the-program.html)、 [変数のインスペクション](examining-suspended-program.html)など)。

![gds/gdbserver によるデバッグ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remoteDebugWindow.png)

> **Note:**
> IDE で設定されたブレークポイントでプログラムが停止しない場合は、リモートデバッグ構成設定で   シンボルファイル   と   パス マッピング​​‍​‍​​‍​‍​​​​​‍​‍​​‍​‍​​​​​​‍​‍​‍​​​​​‍​‍​​​‍​‍​​‍​‍​​​​​​‍​‍​‍​​​​​‍​‍​​‍​‍​​​​​​‍​‍​‍​​パス マッピング​‍​‍​​​‍​‍​​​‍​‍​​​‍​‍​​​‍​‍​​​​​‍​‍​​​‍​‍​​​‍​‍​パス マッピング​‍​‍​​​‍​‍​​​‍​‍​​​‍​‍​​​‍​‍​​​‍​‍​​​‍​‍​​​‍​‍​​​‍​‍​​パス マッピング   が正しく指定されていることを再確認してください。

Procedure: 共有ライブラリをデバッグする

共有ライブラリをデバッグするには、ローカルマシンの  `~/.gdbinit`  または  `.lldbinit`  に次のコマンドを追加します。 スクリプトへのアクセスと編集の詳細については、「 [.gdbinit/ .lldbinit 構成ファイルの使用](configuring-debugger-options.html#gdbinit-lldbinit)」を参照してください。

* GDB に [solib-search-paths(英語)](http://visualgdb.com/gdbreference/commands/set_solib-search-path) を設定する

ただし、デフォルトでは、このコマンドは、リモートターゲットに接続する前にデバッガーの起動時に実行されます（対応する [問題(英語)](https://youtrack.jetbrains.com/issue/CPP-7322)を参照）。 これの回避策として、 [GDB フック(英語)](https://sourceware.org/gdb/onlinedocs/gdb/Hooks.html)を使用できます。

```CONSOLE
define target hookpost-remote
set solib-search-path /path/to/my.so:/path/to/sysroot:/path/to/vendorlibs
break main  # if you also need the debug sessions to pause at the beginning
end

```

このように、GDB はリモートターゲットが接続されるたびにフックで指定された  `set solib-search-path`  を実行します。

* LLDB 用の  `settings set target.exec-search-paths /path/to/libs`

## 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) [LLDB Remote Debugging](https://lldb.llvm.org/use/remote.html)

