IntelliJ IDEA 2026.1 Help

SSH 経由の Node.js

始める前に

  1. 設定で JavaScript and TypeScript バンドルプラグインが有効になっていることを確認します。 Ctrl+Alt+S を押して設定を開き、 プラグイン を選択します。 インストール済み タブをクリックします。 検索フィールドに JavaScript と TypeScript と入力します。 プラグインに関する詳細は、 プラグインの管理を参照してください。

  2. 設定 | プラグイン ページのタブ Marketplace で、 Node.jsNode.js Remote InterpreterJavaScript デバッガーFTP/SFTP/WebDAV Connectivityプラグインを、 JetBrains Marketplaceからプラグインをインストールするの説明に従ってインストールします。 プラグインは IntelliJ IDEA Ultimate でのみ利用できます。

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

  4. プロジェクトソースがターゲットリモートホスト上にあることを確認してください。 これは次の 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. Node runtime フィールドの横にある 参照ボタン をクリックします。

    ランタイムの追加 - 参照ボタン
  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 ランタイム ダイアログに戻ります。

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

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

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

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

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

  1. 実行 | 実行構成の編集 に移動します。 開いた 構成の編集 ダイアログで、ツールバーの the Add New Configuration button をクリックし、コンテキストメニューから Node.js を選択します。 「実行 / デバッグ構成 」ダイアログが開きます。

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

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

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

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

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

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

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

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

      Node.js 実行構成を作成する: マッピングの追加
    3. リモートホスト上のローカルフォルダーと対応するフォルダーへのパスを指定します。 例: プロジェクトフォルダーを /home/opc にマップできます。

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

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

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

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

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

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

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

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

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

2026 年 3 月 30 日