WebStorm 2026.1 Help

SSH 経由の Node.js

始める前に

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

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

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

    • ファイルのアップロードとダウンロードの説明に従って、プロジェクトソースをターゲットリモートホストへアップロードしてください。

    • ローカルマシンでネットワーク共有を有効にし、リモートホストのターゲットディレクトリにプロジェクトフォルダーをマウントします。

      ファイルとフォルダーを共有する方法は、使用しているオペレーティングシステムによって異なります。 詳細については、OS の説明書を参照してください。

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

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

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

Node.js 実行 / デバッグ構成で直接構成したリモート 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 ランタイムを構成する: デフォルトのプロジェクトインタープリターとして設定

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

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

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

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

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

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

    Node.js 実行構成を作成する: SSH インタープリターを介してリモート Node.js を選択する

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

  5. ローカルフォルダーをリモートホスト上のフォルダーとマップします。

    1. パスマッピング フィールドの横にある 参照ボタン をクリックするか、 Shift+Enter を押します。

    2. 開いた プロジェクトパスマッピングダイアログで、ツールバーの 追加ボタン をクリックします。

      Node.js 実行構成を作成する: マッピングの追加

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

      Node.js 実行構成を作成する: マッピングが追加されました

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

      Node.js 実行構成を作成する: 追加されたマッピングが表示されます

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

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

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

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

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

  2. Node.js 構成を 上記の説明に従って作成し、ツールバーの 実行 / デバッグ構成を選択 リストから選択し、リスト横の 「デバッグ」ボタン をクリックします。

  3. Node.js アプリケーションと一緒にローカルでデバッガーを起動する場合に進みます。

2026 年 6 月 8 日
Node.js と VagrantPug (Jade)