# SSH 経由の Node.js

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

> **TL;DR**
> 必須プラグイン  ：
>
>
>
> `JavaScript and TypeScript` 、  `JavaScript Debugger` 、  `Node.js` 、  `Node.js Remote Interpreter` 、  `FTP/SFTP/WebDAV 接続`  -  プラグインは CLion にバンドルされており、デフォルトで有効化されています。
>
>
>
> 下記の [Before you start](#ws_node_ssh_before_you_start)を参照してください。

## 始める前に

Procedure:

1. JavaScript と TypeScript 、  JavaScript デバッガー 、  Node.js 、  Node.js リモートインタープリター 、および  FTP/SFTP/WebDAV 接続  の必須プラグインが   設定 | プラグイン   ページで有効化されていることを確認してください。 詳細については、 [プラグインの管理](managing-plugins.html)を参照してください。

2. [Create SSH configurations](create-ssh-configurations.html) の説明に従い、ターゲットリモートホスト上の  SSH  サーバーへのアクセスを構成し、このサーバーが実行されていることを確認してください。

3. プロジェクトソースがターゲットリモートホスト上にあることを確認してください。 これは次の 2 つの方法で実行できます。

* [ファイルのアップロードとダウンロード](uploading-and-downloading-files.html) の説明に従い、プロジェクトソースをターゲットリモートホストにアップロードしてください。

* ローカルマシンでネットワーク共有を有効化し、リモートホストのターゲットディレクトリにプロジェクトフォルダーをマウントします。 ファイルとフォルダーを共有する方法は、使用しているオペレーティングシステムによって異なります。 詳細については、OS の説明書を参照してください。

## SSH 経由でアクセス可能なリモートホスト上で Node.js ランタイムを構成する

SSH 経由の Node.js ランタイムは、   Node.js リモートランタイムを構成する   ダイアログで設定します。 このダイアログは、   設定   ダイアログの [JavaScript ランタイム](javascript-runtime.html)ページから、またはそれ以降にアプリケーションの実行またはデバッグのために [Node.js の実行 / デバッグ構成を作成または編集する](#ws_node_ssh_create_run_debug_configuration)を実行する際に開くことができます。

推奨される方法は、   設定   ダイアログでリモート Node.js ランタイムを設定することです。 この場合、ランタイムと関連するパッケージマネージャーをプロジェクトのデフォルトとして設定できます。

Node.js 実行 / デバッグ構成で直接構成したリモート Node.js ランタイムは、この実行 / デバッグ構成でのみ使用できます。

Procedure:

1. 設定   ダイアログ（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ）を開き、  `言語 & フレームワーク | JavaScript ランタイム`  に進みます。

2. 「   ノードランタイム   」フィールドの横にある「 ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) 」をクリックします。

![ランタイムを追加 - 参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_interpreter_from_settings_browse_button.png)

3. 現在構成されているすべてのランタイムのリストが表示されている [Node.js ランタイム](node-js-interpreters.html)ダイアログで、ツールバーの ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックし、コンテキストメニューから   リモートの追加   を選択します。

![SSH 経由で Node.js ランタイムを構成する: リモートの追加](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_interpreter_from_settings_docker_add_remote.png)

4. 開いた [Node.js リモートランタイムを構成するダイアログ](null)で、   SSH   を選択します。

5. 使用する SSH 構成を選択してください。

![SSH 経由でリモート Node.js ランタイムを構成する: SSH 構成を選択する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_configure_remote_node_interpreter_ssh_select_ssh_configuration.png)

または、 ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) をクリックし、 [SSH 構成の作成](create-ssh-configurations.html) の説明に従って新しい SSH 構成を作成してください。

6. OK   をクリックすると、新しいランタイムがリストに追加される   Node.js ランタイム   ダイアログに戻ります。

![リモートランタイムダイアログ: SSH 経由の新しい Node.js ランタイムがリストに追加されました](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_node_configure_interpreter_remote_interpreters_dialog_ssh_node_added.png)

7. 新しく構成したランタイムをプロジェクトのデフォルトとして設定するには、リストで選択し、   OK   をクリックして   JavaScript ランタイム   ダイアログに戻ります。

CLion は、   ノードランタイム   リストから  `プロジェクト`  エイリアスを選択するたびに、このインタープリターを自動的に使用します。たとえば、実行／デバッグ構成の作成時などです。

新しいランタイムに関連付けられたパッケージマネージャーをプロジェクトの依存関係の管理に使用するには、このパッケージマネージャーをプロジェクトのデフォルトとして設定します。 そのためには、   パッケージマネージャー   フィールドにパッケージマネージャーの場所を指定します。

npm 実行可能ファイルのデフォルトの場所は  `/usr/local/lib/node_modules/npm`  です。

![SSH 経由で Node.js ランタイムを構成する: デフォルトのプロジェクトインタープリターとして設定](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_interpreter_from_settings_ssh_default_project_interpreter_and_package_manager.png)

## Node.js 実行 / デバッグ構成を作成する

Procedure:

1. `実行 | 実行構成の編集​`  に進みます。 開いた   構成の編集   ダイアログで、ツールバーの ![the Add New Configuration button](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックし、コンテキストメニューから   Node.js   を選択します。 「 [実行 / デバッグ構成](run-debug-configuration-node-js.html)」ダイアログが開きます。

2. ファイル   フィールドで、それを開始するアプリケーションのメインファイルへのパスを指定します（たとえば、 [Express(英語)](http://expressjs.com/) アプリケーションの場合は  `bin/www`  ）。

![Node.js の実行 / デバッグ構成: JavaScript ファイルが指定されました](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_ssh_configure_interpreter_run_configuration.png)

3. 必要に応じて、 [Node.js アプリケーションの実行とデバッグ](running-and-debugging-node-js.html#ws_node_run_config_optionally)で説明されているいくつかのオプション設定を指定します。

4. ノードランタイム   リストから、SSH 経由でアクセス可能な関連するリモート Node.js ランタイムを選択します。

![Node.js 実行構成を作成する: SSH インタープリターを介してリモート Node.js を選択する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_ssh_run_configuration_select_interpreter.png)

または、   ノードランタイム   フィールドの横にある ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) をクリックし、 [上記のよう](#ws_node_ssh_configure_remote_interpreter_preferences_remote_interpreters_dialog)にリモート Node.js ランタイムを構成します。

5. ローカルフォルダーをリモートホスト上のフォルダーにマップしてください。

1.

パスマッピング   フィールドの横にある ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.menu-open.svg) をクリックするか、 `Shift+Enter` (Windows), `Shift+Enter` (macOS), `Shift+Enter` (IntelliJ IDEA Classic (macOS)), `Shift+Enter` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `Shift+Enter` (Sublime Text (macOS)), `Shift+Enter` (Xcode), `Shift+Enter` (Visual Studio), `Shift+Enter` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `Shift+Enter` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `Shift+Enter` (Eclipse (macOS)) を押します。

2.

開いた [プロジェクトパスマッピングの編集ダイアログ](null) で、ツールバーの ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックしてください。

![Node.js 実行構成を作成する: マッピングの追加](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_ssh_run_configuration_add_mapping.png)

3.

リモートホスト上のローカルフォルダーと対応するフォルダーへのパスを指定します。 例: プロジェクトフォルダーを  `/home/opc`  にマップできます。

![Node.js 実行構成を作成する: マッピングが追加されました](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_ssh_run_configuration_mapping_added.png)

4.

OK   をクリックすると、   実行 / デバッグ構成   ダイアログに戻り、   パスマッピング   フィールドに新しいマッピングが表示されます。

![Node.js 実行構成を作成する: 追加されたマッピングが表示されます](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_ssh_run_configuration_mapping_specified_final.png)

## アプリケーションを実行する

Procedure:

* ツールバーの   実行 / デバッグ構成   ウィジェットリストから、新しく作成された   Node.js   構成を選択し、その横にある ![the Run button](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg) をクリックします。

* あるいは、 [上記の説明に従って](#ws_node_ssh_create_run_debug_configuration)   Node.js   実行 / デバッグ構成を作成するか、既存の構成を変更して、ダイアログで   実行   をクリックします。

## アプリケーションをデバッグする

Procedure:

1. 必要に応じて Node.js コードに [ブレークポイント](using-breakpoints.html)を設定します。

2. Node.js   構成を [上記の説明](#ws_node_ssh_create_run_debug_configuration)に従って作成し、ツールバーの   実行/デバッグ構成を選択   リストから選択し、リストの横にある ![the Debug button](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.debug.svg) をクリックします。

3. [Node.js アプリケーションと一緒にローカルでデバッガーを起動する](running-and-debugging-node-js.html#debugLocal)場合に進みます。

