# ローカルソースを使用したリモート

> 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  ：Linux
>
>
>
> ソースの場所  ：自動同期付きでローカルでリモートホストに接続
>
>
>
> リモートホストに必要なツール  ：macOS/Linux/Windows クライアント向けには [rsync](https://rsync.samba.org/)、Windows クライアント向けには [tar](https://www.gnu.org/software/tar/)
>
>
>
> プロジェクトモデル  ： [CMake](quick-cmake-tutorial.html) / [Makefile](makefiles-support.html)
>
>
>
> 必須プラグイン  （  バンドル、デフォルトで有効化 ）：FTP/SFTP/WebDAV 接続

このリモートモードを有効化すると、macOS、Linux、Windows デスクトップ上の CLion で、 [SSH](https://en.wikipedia.org/wiki/Secure_Shell) 経由で接続されたリモート Linux マシンをターゲットに作業できます。 [Raspberry Pi(英語)](https://www.raspberrypi.org/) などのシングルボードコンピューター上の組み込みシステムを含む   Linux ベースのターゲット   を選択できます。 また、プログラムはクラウドプラットフォーム上や、たとえば [Docker](clion-toolchains-in-docker.html) コンテナー内で起動することもできます。

このモードでは、IDE インスタンスがローカルで実行され、ソースファイルもローカルクライアントに配置され、リモートホストへの自動同期が行われます。 リモートホスト側では、CLion がホストコンパイラーと CMake/make を使用してコンパイルとビルドを実行し、デバッグにホスト GDB を使用して、リモートターゲットでアプリケーションを実行します。

## ワークフローの手順

CMake:

1.

[リモートツールチェーンを作成する](#remote-toolchain) :

* 資格情報を提供し、接続を確認

* ツールの検出を待ち、必要に応じて手動でパスを指定します。

2.

リモートツールチェーンを   デフォルト   か、 [関連する CMake プロファイルを作成します](#CMakeProfile)。

3.  [必要に応じて、デプロイエントリ](#deployment-entry)のパスマッピングを調整します。

4.

デフォルトプロファイル   を使用するか、ビルド、実行、デバッグ用に   ステップ 2 からのプロファイル   を選択します。

Makefile:

1.

[リモートツールチェーンを作成する](#remote-toolchain) :

* 資格情報を提供し、接続を確認

* ツールの検出を待ち、必要に応じて手動でパスを指定します。

2.

`設定 | ビルド、実行、デプロイ | Makefile`  でリモートツールチェーンに切り替えます。

3.  [必要に応じて、デプロイエントリ](#deployment-entry)のパスマッピングを調整します。

4.

`ツール | Makefile | Makefile プロジェクトのクリーンと再ロード`  を呼び出します。

構成設定で、   実行可能ファイル   をリモートバイナリに指定します。

Procedure: Windows クライアントの仕様

Windows クライアント   で作業するときは、次の点に注意してください。

* IntelliJ プラットフォームの [問題](https://youtrack.jetbrains.com/issue/IDEA-135546) のため、  `idea.properties`  ファイルで [プロパティ](tuning-the-ide.html#configure-platform-properties)値  `idea.case.sensitive.fs=true`  を設定する必要があります（プロパティファイルにアクセスするには、メインメニューから  `ヘルプ | カスタムプロパティの編集 ...`  を選択）、その後、キャッシングリセット付きで CLion を再起動してください（  `ファイル | キャッシュの破棄 / 再起動 ...` ）。

* Windows でのファイル同期の場合、デフォルトでは、CLion は独自の   リモートホストアクセス   と、   tar   ユーティリティを使用したホスト側の圧縮に依存します。 このメカニズムは、macOS および Linux での   Rsync   ツールによる同期よりも遅く動作します。 Windows で   Rsync   同期を有効にするには、 [デプロイ設定](deployment-connection-tab.html#sftp-settings)で   ダウンロード / アップロード / 同期に rsync を使用する。   チェックボックスをオンにします。

Procedure: リモート認証情報を使用してツールチェーンを作成する

1. `設定 | ビルド、実行、デプロイ | ツールチェーン`  に進みます。

2. ![plus icon](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックし、   リモートホスト   を選択します。

![リモートツールチェーンの追加](https://resources.jetbrains.com/help/img/idea/2026.3/cl_toolchains_addremote.png)

3. すでに [SSH 構成](create-ssh-configurations.html)をお持ちの場合は、   資格情報   リストからそれを選択します。

![SSH 構成の選択](https://resources.jetbrains.com/help/img/idea/2026.3/cl_toolchains_remote_sshconfigslist.png)

それ以外の場合は、「   資格情報   」フィールドの横にある「 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg) 」をクリックします。 開いたダイアログで、SSH 構成を作成し、リモートマシンにアクセスするための資格情報を入力します。

![新しい SSH 構成の作成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_toolchaincredentials.png)

4. 接続を確立した後、CLion はデフォルトのリモートの場所  `/usr/bin/cmake`  と  `/usr/bin/gdb`  にあるツールを検出しようとします（または手動で指定した場合はフルパスを使用します）。 チェックが正常に終了すると、ツールチェーンは使用可能になります：

![リモートツールチェーンが正しく設定されました](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_toolchainsuccess.png)

5. 新しく作成したツールチェーンを   デフォルト   のツールチェーンにすることができます（このために、 ![move up](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveUp.svg) ![move down](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveDown.svg) をクリックしてツールチェーンリストの一番上に移動します）。 デフォルトとして設定すると、リモートツールチェーンは、CLion で作成して開くすべてのプロジェクトに使用されます。

CMake プロジェクトの場合、リモートツールチェーンをデフォルトとして設定すると、   デフォルトの CMake プロファイル   が自動的に接続されるため、個別の CMake プロファイルを構成する必要はありません。

Procedure: （CMake）対応する CMake プロファイルを作成する

* `設定 | ビルド、実行、デプロイ | CMake`  に進みます。

* ![plus icon](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして新しい [CMake プロファイル](cmake-profile.html)を作成し、   ツールチェーン   フィールドを使用してリモートツールチェーンに接続します：

![リモートツールチェーンの CMake プロファイル](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_cmakeprofile.png)

または、リモートツールチェーンを [デフォルトとして](#RemoteAsDefault)設定し、   デフォルトを使用する   を選択します。

* 変更を適用   します。

Procedure: （Makefile）Makefile 設定でリモートツールチェーンを選択する

1. `設定 | ビルド、実行、デプロイ | Makefile`  に進みます。

2. ツールチェーン   フィールドでリモートツールチェーンを選択します。

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

または、リモートツールチェーンを [デフォルトとして](#RemoteAsDefault)設定し、   デフォルトを使用する   を選択します。

3. 変更を適用   します。

4. ファイル転送   ツールウィンドウ（  `表示 | ツールウィンドウ | ファイル転送`  ）を使用して、ファイル同期の進行状況を監視します。

![アップロード通知](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefile_upload_remote.png)

Procedure: デプロイ構成を確認して調整する

リモートツールチェーンの接続エンティティを作成すると、CLion はそれを  `設定 | ビルド、実行、デプロイ | デプロイ` の [サーバーアクセス構成](settings-deployment.html)リストに追加します。

* CLion は、プロジェクトコード同期のパスを自動的に構成します。   マッピング   タブを使用して、デフォルトのマッピングを変更します（たとえば、デフォルトの  `tmp`  フォルダーではなく、コピーされたソースの特定のリモートディレクトリを設定します）。

![ファイル同期のためのパスマッピング](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_pathmappings.png)

* CMake:

CMake プロジェクトの場合、デプロイ設定を変更すると、CLion が自動的に同期をトリガーします。   ファイル転送   ツールウィンドウ（  `表示 | ツールウィンドウ | ファイル転送`  ）でプロセスを監視できます。

![ファイル転送ツールウィンドウ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_filetransfer.png)

プロジェクトをリモートマシンにアップロードする際、CLion は最上位の  `CMakeLists.txt`  を含むディレクトリをプロジェクトルート（ [CPP-23995](https://youtrack.jetbrains.com/issue/CPP-23995)）として使用します。 最上位の  `CMakeLists.txt`  が別のサブディレクトリにある場合は、   マッピング   タブでローカルパスを変更します。

Makefile:

Makefile プロジェクトをリモートマシンにアップロードする場合、CLion は Makefile を含むディレクトリをプロジェクトルートとして使用します（一般チケット [CPP-23995](https://youtrack.jetbrains.com/issue/CPP-23995) 参照）。 Makefile が別のサブディレクトリにある場合は、   マッピング   タブでローカルパスを変更します。

* ローカルマシンとリモートマシンがマウントされたボリュームを共有している場合（例えば [Docker](docker.html) コンテナを利用する場合）、あるいは CLion の外部で 3rd-party 同期が設定されている場合、   ソース同期なし   でリモート開発をセットアップして不要なファイル重複を回避できます。

このためには、   接続   タブを開き、接続タイプを   ローカルまたはマウント済みフォルダー​​   に変更してから、パスマッピングをセットアップします（Docker の場合、マップされたボリュームを指定します）。

![ソース同期なし](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_deploy_nosync_docker.png)

CLion は CMake の再読み込み時に常に CMake ビルドフォルダーをダウンロードします。 ただし、   ローカルまたはマウント済みフォルダー​​   デプロイタイプが選択されていて、CMake ビルドフォルダーが既存のパスマッピングのいずれかに格納されている場合は、これをスキップできます。

* SFTP 接続のデプロイプロセスは、Rsync ツールを使用して高速化できます。 macOS および Linux では、Rsync サポートはデフォルトで有効になっていますが、Windows では、 [デプロイ設定](deployment-connection-tab.html#sftp-settings)で   ダウンロード / アップロード / 同期に rsync を使用する。   チェックボックスを選択して有効にする必要があります。

Procedure: 除外対象パス

デフォルトでは、CLion は  `CMakeLists.txt`  にリストされているすべてのディレクトリを解析して同期します。 ただし、   ディレクトリをマーク | 除外   アクションを使用してディレクトリを [除外する](project-analysis.html#exclude_directory_from_project_analysis)と、リモート（デプロイ）では   除外されたパス   としてマークされ、リモートマシンとは同期されません。 これは、リモートツールチェーンを設定する前にフォルダーを除外すると自動的に実行されます。

[デプロイエントリ](#deployment-entry)設定の専用タブで、除外されたパスを確認および調整できます。

![除外対象パス](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_excluded_paths.png)

* リモートツールチェーンが構成されていてすでにプロジェクトが同期されている状態でディレクトリを除外にマークすると、CLion は除外パスの更新を提案します。 更新後、除外されたフォルダーも同期されます。

![デプロイ除外パスを更新するための提案](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_mark_as_excluded.png)

* 以前に除外されていたディレクトリの除外を解除すると、CLion から除外パスの更新と、フォルダーのリモートホストへの再アップロードが提案されます。

![デプロイの除外パスを更新し、フォルダーを再アップロードすることをお勧めする](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_unmark_excluded.png)

Procedure: ヘッダー検索パスの再同期

* コードを正しく解決するために、CLion は、   ヘッダー検索パス   をリモートマシンからローカルクライアントへのすべてのコンテンツと同期します。  たとえば 、標準ライブラリヘッダーはターゲットから取得されますが、CLion エディターでローカルに作業しているかのようにそれらに移動できます。

ただし、ヘッダー検索パスの同期には時間がかかる可能性があるため、CLion は最初のファイル転送時にのみ自動的に同期を実行します。 その後、CMake または Makefile の再ロードによってトリガーされません。 コンパイラーを切り替えたり、プロジェクトの依存関係を変更したりするたびに、  `ツール | リモートホストと再同期`  を呼び出してヘッダー検索パスを手動で更新してください。

> **Note:**
> プロジェクトの依存関係またはコンパイラーを変更するたびに、   リモートホストと再同期   を手動で呼び出す必要があることに注意してください。

自動同期に切り替えることもできます：Registry で  clion.remote.resync.system.cache  キーを設定してください（  `ヘルプ | アクションの検索`  または `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `⌘ ⇧ A` (Xcode), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+Shift+A` (ReSharper), `⌘ ⇧ A` (ReSharper (macOS)), `Ctrl+Shift+A` (QtCreator), `⌘ ⇧ A` (QtCreator (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS)) を押し、  Registry  と入力して、キー名で検索）。

バージョン 2022.3 以降、CLion はリモートホストでの圧縮に [pigz](https://zlib.net/pigz/) を使い、  gzip  の代わりにヘッダー検索パスをローカルホストへ同期します。 このマルチスレッド化された  gzip  の実装により、作業が高速化されます。

Procedure: ビルド、実行、デバッグ

CMake:

リモートツールチェーンと対応する CMake プロファイルが設定されたため、Run/Debug 設定スイッチャーで   適切な CMake プロファイルを選択する   とで、完全にリモートの方法でアプリケーションとテストを構築、実行、デバッグできます。

![リモートの cmake プロファイル](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_profile.png)

以下では、実行される OS に応じてアプリケーションの出力がどのように変化するかを示すデモを見つけることができます。 macOS をローカルシステムとして、Ubuntu ターゲットにリモートで接続し、OS 名を確認します。 この例では、コードハイライトは OS 識別子に依存しているため、CMake プロファイルや [リゾルブコンテキスト](switching-resolve-context.html)を切り替えると、CLion が対応するコードブランチをハイライトします：

![choose build configuration for remote run](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_runapp.animated.gif)

Makefile:

1.  新しい [ネイティブアプリケーション](makefiles-support.html#create-makefile-config)構成を作成するか、既存の構成を編集します。

2.

実行可能ファイル   フィールドで、CLion が  リモート  バイナリを指すように指定してください。

> **Tip:**
> リモートホスト上のプロジェクトディレクトリへのパスをすばやく見つけるには、  `ツール | リモートホストターミナルを開きます`  を呼び出します。

![構成設定で実行可能なリモート](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefile_remote_config.png)

3.  構成を保存し、それを使用して Makefile アプリケーションをリモートで実行またはデバッグします。

> **Tip:**
> CMake 構成と Makefile 構成の両方で、 [リモート外部ツール](settings-tools-remote-ssh-external-tools.html)を   起動前   ステップとして設定できます。

Procedure: 環境変数を設定する

1. リモート OS の環境変数を構成するには、  `.bashrc`  ファイルの先頭の  `# If not running interactively, don't do anything`  行の前に指定します。

プライマリシェルが  bash  でない場合は、その特定のシェルの指示に従うか、  `PermitUserEnvironment yes`  を  `sshd_config`  ファイルに追加し、  sshd  サービスを再起動してから、  `~/.ssh/environment`  で変数を構成します。

Procedure: IPv6 サポートを有効にする

* [IPv6(英語)](https://en.wikipedia.org/wiki/IPv6) ネットワークに接続するには、CLion [JVM オプション](tuning-the-ide.html#configure-jvm-options)で調整する必要があります。

1.

メインメニューから  `ヘルプ | カスタム VM オプションの編集`  を実行します。 開いた  `*.vmoptions`  ファイルで、  `-Djava.net.preferIPv4Stack=true`  行を削除して次の行を追加します。

```CONSOLE
-Djava.net.preferIPv4Stack=false
-Djava.net.preferIPv6Stack=true
-Djava.net.preferIPv6Addresses=true
                    
```

2.  CLion を再起動してください。

* 生のアドレスの代わりに   ホスト名   を使用するには、Windows で管理者として  `C:\Windows\System32\Drivers\etc\hosts`  を開くか、macOS/Linux でスーパーユーザーとして  `/etc/hosts`  を開き、必要なアドレスを対応するホスト名にマップします。

各アドレスは別々の行に配置し、その後に少なくとも 1 つの空白と、空白で区切ったホスト名リストを記述してください。例えば：

```CONSOLE
f381::171d:c61c:c7f3:3a56      my.dev.host1 my.dev.host2
f381::171d:c61c:c7f3:3a26%en0  my.dev.host3
        
```

* macOS   では、禁止されているネットワークインターフェースのリストも指定する必要があります。

1.  `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `⌘ ⇧ A` (Xcode), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+Shift+A` (ReSharper), `⌘ ⇧ A` (ReSharper (macOS)), `Ctrl+Shift+A` (QtCreator), `⌘ ⇧ A` (QtCreator (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS)) を押すか、メインメニューから  `ヘルプ | アクションの検索`  を選択します。 開いたポップアップで、  `Registry`  の入力を開始し、対応する項目を選択して `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS)) を押します。

2.    deployment.macOs.bannedInterfaces   キーを見つけて、禁止するインターフェースのコンマ区切りリストを設定します（例:  `awdl0,bridge0,en1,en2,lo0,p2p0,utun0,utun1`  ）。

## See also

### ハウツー

[Remote development overview](remote-development.html)

### コンセプト

[Run/Debug Configurations](run-debug-configuration.html) [CMake プロファイル](cmake-profile.html)

### プロシージャ

[Building](build-actions.html) [Deploying](deploying-applications.html) [Debugging](debugging-code.html)

### ハウツー

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

### 外部リンク

[CLion Blog: Using Docker with CLion](https://blog.jetbrains.com/clion/2020/01/using-docker-with-clion/) [Webinar Recording: Remote Development with CLion](https://blog.jetbrains.com/clion/2019/03/webinar-recording-remote-development-with-clion) [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)

