PhpStorm 2026.1 Help

Node.js リモートランタイムを構成するダイアログ

以下の Node.js バージョンは、PhpStorm 2023.3 以降でサポートされています:

  • Node.js 22 - アクティブな長期サポート(LTS)バージョン

  • Node.js 24 - 現在のバージョン

詳細については サポートされている Node.js バージョン を参照してください。

Node.js ランタイムダイアログで 追加 追加ボタン をクリックし、ドロップダウンメニューから リモート… を選択すると、ダイアログが開きます。

このダイアログを使用して、リモートホスト上または Vagrant インスタンスに設定された開発環境内の Node.js インストールへのアクセスを構成します。

Configuring a remote Node.js runtime on Docker

項目

説明

SSH

SSH 認証情報でアクセスできるリモートホストまたは環境上の Node.js ランタイムへのアクセスを設定するには、このオプションを選択します。 該当する SSH 設定を選択し、リモートホストまたは環境からデフォルトの Node.js ランタイムへのパスを確認してください。

SSH 構成を作成の詳細を参照してください。

Docker

このオプションは、 リポジトリからプラグインをインストールする説明に従って Node.jsNode.js リモートインタープリターDocker 統合プラグインがインストールされ、有効になっている場合にのみ使用可能です。

Docker コンテナーで Node.js ランタイムを使用するには、このオプションを選択します。

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

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

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

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

Docker Compose

このオプションは、 リポジトリからプラグインをインストールする説明に従って Node.jsNode.js リモートインタープリターDocker 統合プラグインがインストールされ、有効になっている場合にのみ使用可能です。

Docker Compose ファイル docker-compose.yml で定義された Node.js ランタイム設定を使用する場合は、このオプションを選択してください。 このファイルの コマンド フィールドに node または npm が含まれている必要があります(例: command: node ./src/app.js)。 詳細については、 Docker オフィシャル Web サイト(英語)を参照してください。

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

  2. 構成ファイル(複数可) フィールドで、アプリケーションのサービスを定義する docker-compose.yml ファイル(英語)を指定します。

  3. サービス リストから、実行したいサービスを選択します。

  4. 必要に応じて、 環境変数 フィールドで環境変数を定義します。 詳細については、 Docker Compose 実行構成設定を参照してください。

Vagrant​

このオプションは、 Vagrant プラグインがインストールされ、有効になっている場合にのみ利用可能です。 Vagrant プラグインは PhpStorm にはバンドルされていませんが、 設定 | プラグイン ページのタブ  Marketplace で、 JetBrains Marketplace からプラグインをインストールするに従ってインストールできます。

このオプションを選択すると、 Vagrant の認証情報を使用して Vagrant インスタンス内の Node.js ランタイムへのアクセスを設定できます。 技術的には、 VagrantFile の環境設定ファイルが置かれているフォルダーです。 この設定に基づき、PhpStorm は Vagrant ホスト を検出し、それを Vagrant ホスト URL の読み取り専用フィールドにリンクとして表示します。

インタープリター構成を使用するには、プロジェクトフォルダー、プロジェクトファイルのコピー先となるサーバー上のフォルダー、およびサーバー上のコピーされたデータにアクセスするための URL アドレス間の対応を設定する パスマッピングが必要です。 PhpStorm は VagrantFile 構成ファイルからパスマッピングを評価します。

Node.js ランタイムパス

このフィールドには、選択したリモート開発環境の構成に従って、 Node.js 実行ファイルの場所を指定します。

  • Vagrant インスタンスの場合、デフォルトで PhpStorm は /usr/bin/node の場所を提案します。

  • Docker コンテナーの場合、デフォルトで PhpStorm は node の場所を提案します。

別のフォルダーを指定するには、 Open をクリックし、表示されるダイアログで関連するフォルダーを選択します。 Node.js ホームディレクトリは、編集用に開いている必要があります。

OK をクリックすると、PhpStorm は Node.js 実行可能ファイルが指定されたフォルダーに実際に保存されているかどうかを確認します。

  • Node.js 実行可能ファイルが見つからない場合、PhpStorm は検索を続行するかインタープリター構成を保存するかを確認するエラーメッセージを表示します。

    PHP 実行ファイルが見つかりません
  • Node.js 実行可能ファイルが見つかった場合は、 Node.js ランタイム ダイアログに戻り、インストールフォルダーと検出されたバージョンの Node.js インタープリターが表示されます。

2026 年 5 月 22 日