CLion 2026.2 Help

複雑なリモートシナリオ

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

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

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

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

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

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

    設定 | ビルド、実行、デプロイ | ツールチェーン で、 リモートツールチェーンを作成し 、ビルドマシンにアクセスするための資格情報を提供します。

    ビルド用のリモートツールチェーン

    設定 | ビルド、実行、デプロイ | ツールチェーン で、Docker ツールチェーンを 作成します。

    ビルド用の Docker ツールチェーン
  2. 作成したツールチェーンを CMake プロファイルに接続するか(デバッグプロファイルであることを確認してください)、 Makefile の設定で選択します。

    CMake プロファイルでビルドツールチェーンを設定する
  3. プロジェクトをビルドしてバイナリを取得します。

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

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

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

  1. ビルドマシンマルチアーチ GDB(英語) 実行可能ファイルがあることを確認してください。

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

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

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

  1. ビルドマシンからローカルシステムにバイナリをダウンロードする 外部ツールを作成します。

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

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

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

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

リモート GDB サーバー構成を作成し、次の設定を入力してください:

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

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

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

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

リモート GDB サーバー構成

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

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

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

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

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

    2026 年 7 月 15 日