# 複雑なリモートシナリオ

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

この記事では、リモートシステムで [CMake](quick-cmake-tutorial.html) または [Makefile](makefiles-support.html) アプリケーションを構築してから、別のリモートシステムでデバッグする必要がある場合の一般的な推奨事項を示します。

* CLion はローカルで実行されています（以下、 ローカルマシン と呼びます）

* ビルドは、Docker コンテナーまたは別のシステム内でリモートで実行されます ( ビルドマシン )

* アプリケーションは、組み込みデバイスまたはさらに別のシステムで起動されます ( ターゲットマシン )

> **Note:**
> このシナリオは、現時点では完全にはサポートされていません（ [CPP-22148(英語)](https://youtrack.jetbrains.com/issue/CPP-22148)）。 以下の手順では、考えられる回避策について説明します。

Procedure: 1。 ビルドツールチェーンを設定する

1. リモートマシン上、または Docker コンテナー内で、アプリケーションが構築されている場所に対応するタブを選択します。

リモートビルドマシン:

`設定 | ビルド、実行、デプロイ | ツールチェーン`  で、 [リモートツールチェーンを作成し](remote-projects-support.html#remote-toolchain)、ビルドマシンにアクセスするための資格情報を提供します。

![ビルド用のリモートツールチェーン](https://resources.jetbrains.com/help/img/idea/2026.3/cl_complicated_remote_buildtoolchain.png)

Docker:

`設定 | ビルド、実行、デプロイ | ツールチェーン`  で、Docker ツールチェーンを [作成](clion-toolchains-in-docker.html#create-docker-toolchain)します。

![ビルド用の Docker ツールチェーン](https://resources.jetbrains.com/help/img/idea/2026.3/cl_complicated_remote_dockertoolchain.png)

> **Tip:**
> Docker コンテナーでの開発の詳細については、 [Docker ツールチェーン](clion-toolchains-in-docker.html)を参照してください。

2. 作成したツールチェーンを [CMake プロファイル](remote-projects-support.html#CMakeProfile)に接続するか（  デバッグ プロファイルであることを確認してください）、 [Makefile の設定](remote-projects-support.html#Makefile-toolchain)で選択します。

![CMake プロファイルでビルドツールチェーンを設定する](https://resources.jetbrains.com/help/img/idea/2026.3/cl_complicated_remote_cmakeprofile.png)

3. [プロジェクトをビルド](build-actions.html)してバイナリを取得します。

リモートビルドマシン:

リモートツールチェーンの場合、バイナリはビルドマシンで作成され、ローカルマシンに自動的にダウンロードされません。 後で、必要なコピーを実行するための外部ツールを追加します。

Docker:

Docker の場合、バイナリは自動的にローカルマシンに同期されます。 ビルド後すぐに、マップされたディレクトリのバイナリを確認できます。

Procedure: 2。 デバッガーを準備する

1. ビルドマシン   に [マルチアーチ GDB(英語)](https://aur.archlinux.org/packages/gdb-multiarch/) 実行可能ファイルがあることを確認してください。

例: Ubuntu でビルドする場合は、実行することでマルチアーチ GDB をインストールできます

```CONSOLE
sudo apt install gdb-multiarch
```

2. ツールチェーン設定で、   デバッガー​   フィールドでマルチアーチ GDB が選択されていることを確認します。 パスが自動的に検出されなかった場合は、パスを手動で指定してください。

Procedure: 3。 バイナリをダウンロードするための外部ツールを作成する (Docker はスキップ)

> **Note:**
> Docker の場合、バイナリは自動的にダウンロードされるため、追加のコピーは必要ありません。 [4。 リモート GDB サーバー構成をセットアップする](#remote-config)に移動します。

1. ビルドマシンからローカルシステムにバイナリをダウンロードする [外部ツールを作成](configuring-third-party-tools.html#local-ext-tools)します。

例: その   ために scp   を使用できます:

![バイナリをダウンロードするための外部ツール](https://resources.jetbrains.com/help/img/idea/2026.3/cl_complicated_remote_externaltool.png)

> **Tip:**
> ツールが呼び出されるたびにパスワードの入力を求められないように、SSH 公開鍵認証の使用を検討してください。 [この命令(英語)](https://kb.iu.edu/d/aews)を参照してください。

2. パス マッピング​​‍​‍​​‍​‍​​​​​‍​‍​​‍​‍​​​​​​‍​‍​‍​​​​​‍​‍​​​‍​‍​​‍​‍​​​​​​‍​‍​‍​​​​​‍​‍​​‍​‍​​​​​​‍​‍​‍​​パス マッピング​‍​‍​​​‍​‍​​​‍​‍​​​‍​‍​​​‍​‍​​​​​‍​‍​​​‍​‍​​​‍​‍​パス マッピング​‍​‍​​​‍​‍​​​‍​‍​​​‍​‍​​​‍​‍​​​‍​‍​​​‍​‍​​​‍​‍​​​‍​‍​​パス マッピング  を確認してください。ビルドマシンからバイナリをダウンロードするディレクトリは、プロジェクトルートからの相対パスが同じである必要があります。

3. ツールを構成した後、  `ツール | 外部ツール`  を使用して手動で呼び出し、初めてダウンロードを実行します。 ローカルシステムのバイナリを確認してください。

> **Tip:**
> ターゲットマシンが組み込みデバイスの場合は、リモート GDB サーバーの代わりに [Embedded GDB Server](embedded-gdb-server.html)構成を使用して、下記と同様のセットアップを試すことができます。 ただし、このケースはテストされていないことに注意してください。

Procedure: 4。 リモート GDB サーバー構成をセットアップする

> **Note:**
> この時点で、バイナリはローカルに配置されている必要があります。

[リモート GDB サーバー構成を作成](remote-gdb-server.html#remote-config)し、次の設定を入力してください：

* 実行可能ファイル - ダウンロードした（ローカル）バイナリを選択します

* GDB - ビルドマシンから GDB を選択します (ツールチェーンで指定されたもの)

* 資格情報 - ターゲットマシンにアクセスするためのクレデンシャルを提供します

* 起動前 エリア（Docker のスキップ）- ビルドステップの後に、ダウンロード用の外部ツールを追加します

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

これで、そのリモート GDB サーバー構成を起動すると、次の一連の手順が実行されます。

1.  プロジェクトは、リモート /Docker ツールチェーンを使用してビルドマシン上にビルドされます。

2.  Docker の場合、バイナリはローカルにコピーされます。 それ以外の場合は、外部ツールによってローカルシステムにダウンロードされます。

3.  次に、バイナリがターゲットマシンにアップロードされ、  gdbserver  で起動されます。

4.  CLion デバッガー（ビルドマシンの GDB として構成したもの）は、ターゲットマシンの  gdbserver  に接続します。

## See also

### ハウツー

[クイック CMake チュートリアル](quick-cmake-tutorial.html) [Makefile プロジェクト](makefiles-support.html) [ツールチェーン](how-to-create-toolchain-in-clion.html) [Docker ツールチェーン](clion-toolchains-in-docker.html)

### プロシージャ

[ローカルソースを使用したリモート](remote-projects-support.html) [リモート GDB サーバーの構成](remote-gdb-server.html) [外部ツール](configuring-third-party-tools.html)

