WebStorm 2026.1 Help

リモート Node.js ランタイムの構成

WebStorm では、リモートホストまたは仮想環境にインストールされた Node.js 上でアプリケーションを開発、テスト、リント、実行、デバッグする場合、リモート Node.js ランタイムを構成する必要があります。

リモート Node.js ランタイムは、 Node.js リモートランタイムの構成 ダイアログで設定します。 このダイアログは、 設定 ダイアログの JavaScript ランタイムページから、またはそれ以降に、リモート環境でアプリケーションを実行またはデバッグするための Node.js 実行 / デバッグ構成を作成または編集するときに開くことができます。

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

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

SSH 接続経由でアクセス可能なホスト上のリモート Node.js ランタイム

始める前に

  1. Node.js、 Node.js リモートインタープリター、 FTP/SFTP/WebDAV 接続に必要なプラグインが 設定 | プラグイン ページ、タブ インストール済み で有効になっていることを確認します。 詳細については、 プラグイン管理を参照してください。

  2. SSH 構成を作成する の説明に従って、ターゲットリモートホスト上の SSH サーバーへのアクセスを構成し、そのサーバーが実行中であることを確認してください。

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

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

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

設定で SSH 経由でリモート Node.js ランタイムを構成するダイアログ

  1. 設定 ダイアログ（Ctrl+Alt+S ）を開き、 言語 & フレームワーク | JavaScript ランタイム に進みます。

  2. ノードランタイム フィールドの横にある 参照ボタン をクリックします。

    ランタイムを追加 - 参照ボタン

  3. 現在構成されているすべてのランタイムのリストが表示されている Node.js ランタイムダイアログで、ツールバーの 追加ボタン をクリックし、コンテキストメニューから リモートの追加 を選択します。

    SSH 経由で Node.js ランタイムを構成する: リモートの追加

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

  5. 使用する SSH 構成を選択します。

    SSH 経由でリモート Node.js ランタイムを構成する: SSH 構成を選択する

    または、 参照ボタン をクリックし、 SSH 構成を作成する の説明に従って新しい SSH 構成を作成します。

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

    リモートランタイムダイアログ: SSH 経由の新しい Node.js ランタイムがリストに追加されました

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

    WebStorm は、たとえば実行/デバッグ構成作成時など ノードランタイム リストから Project エイリアスを選択するたびに、このインタープリターを自動的に利用します。

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

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

    SSH 経由で Node.js ランタイムを構成する: デフォルトのプロジェクトインタープリターとして設定

実行 / デバッグ構成で SSH 経由でリモート Node.js ランタイムを構成する

  1. 実行 | 実行構成の編集 に進みます。 開いた 構成の編集 ダイアログで、ツールバーの 「新しい構成を追加」ボタン をクリックし、コンテキストメニューから Node.js を選択します。 「実行 / デバッグ構成: Node.js 」ダイアログが開きます。

  2. ノードランタイム フィールドの横にある 参照ボタン をクリックします。

    Node.js の実行 / デバッグ構成: 指定されたファイル

    Node.js ランタイムダイアログが開きます。

  3. ツールバーの 追加ボタン をクリックし、コンテキストメニューから リモートの追加 を選択します。

    SSH 経由の Node.js: 実行 / デバッグ構成、ランタイムの構成、リモートの追加を選択

  4. 上記の説明に従って、 SSH 経由でリモート Node.js ランタイムを構成します。

Docker コンテナー内のリモート Node.js ランタイム

始める前に

  1. Node.js、 Node.js リモートインタープリター、 Dockerに必要なプラグインが 設定 | プラグイン ページ・タブ インストール済み で有効になっていることを確認してください。 詳細については、 プラグイン管理を参照してください。

  2. Docker をダウンロード、インストール、設定し、 Docker の説明に従ってください。

Docker の Node.js ランタイムは、 Node.js リモートランタイムの構成 ダイアログで設定します。 このダイアログは、 設定 ダイアログの JavaScript Runtime ページから、または Docker でアプリケーションを実行またはデバッグするために Node.js の実行/デバッグ構成を作成または編集する際に開くことができます。

推奨される方法は、 設定 ダイアログでリモート Node.js ランタイムを設定することです。 この場合、ランタイムと関連するパッケージマネージャーをプロジェクトのデフォルトとして設定できます。 これにより、Docker で設定された Node.js ランタイムを使用してアプリを実行およびデバッグできるだけでなく、プロジェクトの依存関係の管理、テストの実行、コードのリンティングも実行できるようになります。

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

設定で Node.js ランタイムを構成するダイアログ

  1. 実行 | 実行構成の編集 に進みます。 開いた 構成の編集 ダイアログで、ツールバーの 「新しい構成を追加」ボタン をクリックし、コンテキストメニューから Node.js を選択します。

    開いた Run/Debug 構成: Node.jsダイアログで、 ノードランタイム フィールドの横にある 参照ボタン をクリックします。

  2. 現在構成されているすべてのランタイムのリストが表示されている Node.js ランタイムダイアログで、ツールバーの 追加ボタン をクリックし、コンテキストメニューから リモートの追加 を選択します。

  3. 開いた Node.js リモートランタイムを構成するダイアログで、 Docker オプションを選択します。

    1. サーバー フィールドに、使用する Docker の設定を指定します。 詳細については、 Docker デーモンの接続設定を構成するを参照してください。 リストから構成を選択するか、 新規… をクリックして、開いた Docker ページ上に新しい構成を作成します。

    2. イメージ名 フィールドで、使用するベース Docker イメージを指定します。 リストから以前にダウンロードしたイメージまたはカスタムイメージのいずれかを選択するか、 node:argon や mhart/alpine-node などのイメージ名を手動で入力します。 後で実行構成を起動すると、Docker はマシン上で指定されたイメージを検索します。 検索が失敗した場合、イメージは Docker レジストリページのリポジトリからダウンロードされます。 公式 Node.js Docker イメージ(英語)を使用することをお勧めします。

    3. Node.js ランタイムパス フィールドには、指定されたイメージのデフォルトの Node.js ランタイムの場所が表示されます。

    4. OK をクリックすると、WebStorm は Node.js リモートインタープリターの構成 ダイアログを閉じ、 Node.js ランタイムダイアログに移動します。ここで、新しいランタイム構成がリストに追加されます。 OK をクリックして、実行構成に戻ります。

Node.js 実行 / デバッグ構成で Node.js ランタイムを構成する

  1. 実行 | 実行構成の編集 に進みます。 開いた 構成の編集 ダイアログで、ツールバーの 「新しい構成を追加」ボタン をクリックし、コンテキストメニューから Node.js を選択します。 「実行 / デバッグ構成: Node.js 」ダイアログが開きます。

  2. ノードランタイム フィールドの横にある 参照ボタン をクリックします。 Node.js ランタイムダイアログが開きます。

  3. ツールバーの 追加ボタン をクリックし、コンテキストメニューから リモートの追加 を選択します。

    Node.js と Docker: 実行 / デバッグ構成、ランタイムの構成、リモートの追加を選択

  4. 上記の説明に従って、リモート Node.js ランタイムを構成します。

Docker Compose 定義を持つ Docker コンテナーでリモート Node.js ランタイムを使用する

Docker Compose(英語) を使用すると、Node.js サーバーとアプリケーションコードを別々のサービスとして実行できます。 必要に応じてコンテナーを追加することで各サービスを拡張できます。 これにより、実稼働環境に似た動的環境で効率的な開発とテストを実行できます。

始める前に

  1. Node.js、 Node.js リモートインタープリター、 Dockerに必要なプラグインが 設定 | プラグイン ページ・タブ インストール済み で有効になっていることを確認してください。 詳細については、 プラグイン管理を参照してください。

  2. Docker をダウンロード、インストール、設定し、 Docker の説明に従ってください。

マルチコンテナー Docker アプリケーションの Node.js ランタイムは、 Node.js リモートランタイムの構成 ダイアログで設定します。 このダイアログは、 JavaScript ランタイムページ内の 設定 ダイアログ、または Vagrant 環境でアプリケーションを実行・デバッグする際に Node.js の実行/デバッグ構成を作成または編集する時にも開くことができます。

推奨される方法は、 設定 ダイアログでリモート Node.js ランタイムを設定することです。 この場合、ランタイムと関連するパッケージマネージャーをプロジェクトのデフォルトとして設定できます。 これにより、Docker で設定された Node.js ランタイムを使用してアプリを実行およびデバッグできるだけでなく、プロジェクトの依存関係の管理、テストの実行、コードのリンティングも実行できるようになります。 以下の npm、pnpm、yarn と Docker、 アプリケーションをテストする、 Docker を使用した ESLint を参照してください。

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

  1. 設定 ダイアログ（Ctrl+Alt+S ）を開き、 言語 & フレームワーク | JavaScript ランタイム に進みます。

  2. ノードランタイム フィールドの横にある 参照ボタン をクリックします。

    ランタイムを追加 - 参照ボタン

  3. 現在構成されているすべてのランタイムのリストが表示されている Node.js ランタイムダイアログで、ツールバーの 追加ボタン をクリックし、コンテキストメニューから リモートの追加 を選択します。

    Docker コンテナーで Node.js ランタイムを構成する: リモートの追加

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

  5. サーバー リストから、使用する Docker 構成を選択します。

    Docker Compose 経由で Node.js ランタイムを構成する: Docker サーバーを選択する

    または、フィールドの横にある 新規 をクリックし、 Docker サポートを有効にする説明に従って Docker サーバーを構成します。

  6. 構成ファイル フィールドで使用する docker-compose 設定ファイルを指定します。 閲覧する をクリックし、表示される Docker Compose 構成ファイル ダイアログで設定ファイルのリストを作成します。

    Docker Compose 経由で Node.js ランタイムを構成する: 構成ファイル

  7. サービス リストから、使用するサービスを選択します。

    Docker Compose 経由で Node.js ランタイムを構成する: サービスの選択

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

    リモートランタイムダイアログ: Docker の新しい Node.js ランタイムがリストに追加されました

WebStorm は、たとえば実行/デバッグ構成作成時など ノードランタイム リストから Project エイリアスを選択するたびに、このインタープリターを自動的に利用します。

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

プロジェクト内のデフォルトの Node.js ランタイムとパッケージマネージャーを指定する

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

デフォルトのプロジェクトパッケージマネージャーは、依存関係を管理するために自動的に使用されます。たとえば、 package.json ファイルから <package manager> install を実行したり、ESLint、Prettier などのサードパーティ製ツールをインストールしたりします。

  1. 設定 ダイアログ（Ctrl+Alt+S ）を開き、 言語 & フレームワーク | JavaScript ランタイム に進みます。

  2. 推奨ランタイム リストで Node.js が選択されていることを確認します。

    優先ランタイムを選択

  3. ノードランタイム リストから、現在のプロジェクトでデフォルトで使用する構成を選択します。

    デフォルトの Node.js 構成を選択する

  4. パッケージマネージャー リストから、使用するパッケージマネージャーに関連付けられているエイリアスを選択します。 WebStorm はその場所を自動的に検出します。

    設定: 新しく構成されたリモート Node.js ランタイムがデフォルトで選択されました

    あるいは、必要なパッケージマネージャーの場所を手動で指定してください。

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

    • pnpm のデフォルトの場所はインストール方法によって異なります：

      1. npm を介してインストールするための /usr/local/lib/node_modules/pnpm 。

      2. カールを介してインストールするための /usr/local/pnpm-global/<version>/node_modules/pnpm （curl -f https://get.pnpm.io/<version>.js | node - add --global pnpm）。

      詳細については、 pnpm 公式 Web サイト(英語)を参照してください。

    • ヤーンのデフォルトの場所は /opt/yarn-<version>5 で、たとえば /opt/yarn-v1.22.5 です。

Node.js 実行 / デバッグ構成で Docker Compose 定義を使用して Node.js ランタイムを構成する

  1. 実行 | 実行構成の編集 に進みます。 開いた 構成の編集 ダイアログで、ツールバーの 「新しい構成を追加」ボタン をクリックし、コンテキストメニューから Node.js を選択します。 「実行 / デバッグ構成: Node.js 」ダイアログが開きます。

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

    Node.js の実行 / デバッグ構成: JavaScript ファイルが指定されました

  3. 必要に応じて、 Node.js アプリケーションの実行とデバッグで説明されているいくつかのオプション設定を指定します。

  4. ノードランタイム リストから、Docker Compose 経由で関連するリモート Node.js ランタイムを選択します。

    Node.js と Docker Compose: 構成の実行 / デバッグ、インタープリターの選択

    または、 ノードランタイム フィールドの横にある 参照ボタン をクリックします。 そして、 上記のようにリモート Node.js ランタイムを構成します。

    Node.js と Docker: 実行 / デバッグ構成、ランタイムの構成、リモートの追加を選択

  5. Docker Compose エリアで、Docker Compose に渡すコマンドとオプションを指定します。 デフォルト設定を受け入れるか、「展開ボタン 」をクリックしてカスタム設定 (たとえば、 --rm や --service-ports などのカスタム Docker Compose フラグ) を指定します。 詳細については、 Docker オフィシャル Web サイト(英語)を参照してください。

    コマンドプレビュー​ を確認してください。

    Docker Compose エリアのプレビュー

Vagrant インスタンスの Node.js ランタイム

Vagrant を利用すると、Node.js アプリケーションをすばやくブートストラップして、WebStorm から実行・デバッグ・プロファイリングできます。 Node.js と Vagrant の詳細をご覧ください。

始める前に

  1. Node.js、 Node.js リモートインタープリター、 Vagrantに必要なプラグインが 設定 | プラグイン ページ、タブ インストール済み で有効になっていることを確認します。 詳細については、 プラグイン管理を参照してください。

  2. Vagrant(英語) と Oracle の VirtualBox(英語) がコンピューターにダウンロード、インストール、構成されていることを確認してください。 詳細については Vagrant を参照してください。

  3. 次の実行可能ファイルの親フォルダーがシステム PATH 変数に追加されていることを確認します。

    • Vagrant から vagrant.bat または vagrant を選択してください。 これは、Vagrant インストーラによって自動的に実行されます。

    • Oracle VirtualBox インストールからの VBoxManage.exe または VBoxManage 。

Vagrant 環境の Node.js ランタイムは、 Node.js リモートランタイムの構成 ダイアログで設定します。 このダイアログは、 JavaScript ランタイムページ内の 設定 ダイアログ、または Vagrant 環境でアプリケーションを実行・デバッグする際に Node.js の実行/デバッグ構成を作成または編集する時にも開くことができます。

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

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

設定で Node.js ランタイムを構成するダイアログ

  1. 設定 ダイアログ（Ctrl+Alt+S ）を開き、 言語 & フレームワーク | JavaScript ランタイム に進みます。

  2. ノードランタイム フィールドの横にある 参照ボタン をクリックします。

    ランタイムを追加 - 参照ボタン

  3. 現在構成されているすべてのランタイムのリストが表示されている Node.js ランタイムダイアログで、ツールバーの 追加ボタン をクリックし、コンテキストメニューから リモートの追加 を選択します。

    Vagrant インスタンスで Node.js リモートランタイムを構成する: リモートの追加

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

  5. 使用する環境を指す Vagrant インスタンスフォルダー を指定してください。

    技術的には、目的の環境の VagrantFile 構成ファイルが配置されているフォルダーです。 この設定に基づき、WebStorm は Vagrant ホスト を検出し、 Vagrant ホスト URL の読み取り専用フィールドにリンクとして表示します。

    デフォルトでは、フィールドには現在のプロジェクトフォルダーが表示されます。

  6. Node.js ランタイムパス フィールドで、Node.js 実行可能ファイルの場所を指定します。

    Vagrant 環境でリモート Node.js ランタイムを構成する: ノード実行可能ファイルのインスタンスフォルダーと場所を指定する

    Node.js 実行可能ファイルを見つけるには、埋め込み ターミナル （Alt+F12 ）を開いて次のように入力します。

    vagrant ssh whereis node exit
    Vagrant 環境で Node.js 実行可能ファイルを見つける

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

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

    リモートランタイムダイアログ: Vagrant 環境の新しい Node.js ランタイムがリストに追加されました

    WebStorm は、たとえば実行/デバッグ構成作成時など ノードランタイム リストから Project エイリアスを選択するたびに、このインタープリターを自動的に利用します。

  9. 使用するパッケージマネージャーへのパスを指定します。

    リモート Node.js ランタイムを構成する: パッケージマネージャーが指定されました

    パッケージマネージャーを見つけるには、組み込み ターミナル （Alt+F12 ）を開いて次のように入力します。

    vagrant ssh whereis <package manager> exit
    Vagrant 環境でパッケージマネージャーを探す

Node.js 実行 / デバッグ構成で Node.js ランタイムを構成する

  1. 実行 | 実行構成の編集 に進みます。 開いた 構成の編集 ダイアログで、ツールバーの 「新しい構成を追加」ボタン をクリックし、コンテキストメニューから Node.js を選択します。 「実行 / デバッグ構成: Node.js 」ダイアログが開きます。

  2. ノードランタイム フィールドの横にある 参照ボタン をクリックします。 Node.js ランタイムダイアログが開きます。

  3. ツールバーの 追加ボタン をクリックし、コンテキストメニューから リモートの追加 を選択します。

    リモートランタイムダイアログ

  4. 上記の説明に従って、 Vagrant 環境でリモート Node.js ランタイムを構成します。

2026 年 6 月 8 日
サポートされている Node.js バージョンNode.js の実行とデバッグ