# SSH 経由の Node.js

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

> **TL;DR**
> 必須プラグイン   :
>
>
>
> `JavaScript and TypeScript`  -  プラグインは IntelliJ IDEA にバンドルされており、デフォルトで有効化されています。
>
>
>
> `Node.js` ,  `Node.js Remote Interpreter` ,  `JavaScript Debugger` ,  `FTP/SFTP/WebDAV 接続`  -    設定 | プラグイン  ページでプラグインをインストールします。 プラグインは Ultimate サブスクリプション付きの IntelliJ IDEA でのみ利用できます。

## 始める前に

Procedure:

1. 設定で  JavaScript and TypeScript  バンドルプラグインが有効になっていることを確認します。 `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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) を押して設定を開き、  `プラグイン`  を選択します。 検索フィールドに  JavaScript と TypeScript  と入力します。 プラグインに関する詳細は、 [プラグインの管理](managing-plugins.html)を参照してください。

2. Node.js 、  Node.js リモートインタープリター 、  JavaScript デバッガー 、  FTP/SFTP/WebDAV 接続 プラグインを   設定 | プラグイン  ページで、 [JetBrains Marketplace からプラグインをインストールする](managing-plugins.html#install_plugin_from_repo)の説明に従ってインストールします。 プラグインは Ultimate サブスクリプション付きの IntelliJ IDEA でのみ利用できます。

3. ターゲットリモートホスト上の  SSH  サーバーへのアクセスを、 [SSH 構成の作成](create-ssh-configurations.html)の説明に従って構成し、このサーバーが実行中であることを確認します。

4. プロジェクトソースがターゲットリモートホスト上にあることを確認してください。 これは次の 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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (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 リモートランタイムの構成ダイアログ](configure-node-js-remote-interpreter.html)で、   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 ランタイム   ダイアログに戻ります。

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

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

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. `実行 | 実行構成の編集`  に移動します。 開いた   構成の編集   ダイアログで、ツールバーの ![新規構成の追加ボタン](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` (Visual Studio), `Shift+Enter` (Visual Studio (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `Shift+Enter` (Eclipse (macOS)) を押します。

2.

表示された [プロジェクトパスマッピングの編集ダイアログ](edit-project-path-mappings-dialog.html)で、ツールバーの ![追加ボタン](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   構成を選択し、その横にある ![実行ボタン](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)場合に進みます。

