WebStorm 2026.1 Help

Node.js と Vagrant

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

始める前に

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

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

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

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

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

  4. Vagrant 環境で Node.js を実行可能にするには、すぐに使用できる Vagrant ボックス(jandir/nodejs(英語) など)から始めることができます。

    埋め込まれた ターミナルAlt+F12 )を開き、次のコマンドを実行します。

    vagrant init jandir/nodejs vagrant up

Vagrant 環境で Node.js ランタイムを構成する

Vagrant 環境の Node.js ランタイムは、 Node.js リモートランタイムの構成 ダイアログで設定します。 このダイアログは、 設定 ダイアログの JavaScript ランタイムページから、または Vagrant でアプリケーションを実行またはデバッグするために 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 実行 / デバッグ構成を作成する

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

    ファイル フィールドで、アプリケーションを開始するファイルへのパスを指定します。

    Node.js の実行 / デバッグ構成: JavaScript ファイルが指定されました
  2. 必要に応じて、 Node.js アプリケーションの実行とデバッグで説明されているいくつかのオプション設定を指定します。

  3. ノードランタイム リストから、Vagrant 環境内の関連するリモート Node.js ランタイムを選択します。

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

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

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

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

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

  4. 実行 / デバッグ構成を保存するには、 OK をクリックします。

Vagrant 環境で Node.js アプリケーションを実行する

  • ツールバーの 実行 / デバッグ構成 ウィジェットリストから、新しく作成した Node.js 構成を選択し、その横にある Run ボタン をクリックします。

    Run an app in a Vagrant environment
  • または、 上記のように Vagrant 環境で Node.js ランタイムを使用して Node.js 実行 / デバッグ構成を作成するか、既存の構成を変更して、ダイアログで 実行 をクリックします。

アプリケーションの出力を確認する

アプリケーションが期待通りに動作するか確認するには、WebStorm の 組み込み HTTP クライアントから HTTP リクエストを実行できます。

Node.js with Vagrant: connect to a running app with a HTTP Request
  1. HTTP リクエストファイルを作成します。

  2. 次のリクエストを書いてください:

    GET http://<host IP>:<application port>/

    デフォルトでは、ホスト IP は 192.168.33.10 です。 例:

    GET http://192.168.33.10:3000/
  3. ガターの 実行 HTTP リクエスト ボタン をクリックし、 Run http://<host IP>:<application port>/ の横にある 実行 HTTP リクエスト ボタン をクリックします。

    HTTP リクエストを起動する

    アプリケーションの出力は、 実行 ツールウィンドウの別のタブに表示されます。

Vagrant 環境で Node.js アプリケーションをデバッグする

  1. 必要に応じて、コードにブレークポイントを設定します。

  2. 上記のように、 Vagrant 環境で Node.js ランタイムを使用して Node.js 実行 / デバッグ構成を作成します。

  3. ツールバーの 実行 ウィジェットリストから、新しく作成した Node.js 構成を選択し、その横にある 「デバッグ」ボタン をクリックします。

  4. 表示された デバッグツールウィンドウでデバッグセッションを進めてください。 ブレークポイントをステップ実行したり、フレームを切り替えたり、値をその場で変更したり、 中断されたプログラムを調べたり式を評価したり、 ウォッチを設定したりできます。

    Debug a Node.js app in a Vagrant environment
2026 年 6 月 8 日