llms.txt: machine-readable documentation index. Markdown version of this page is also available.

IntelliJ IDEA 2026.3 Help

SSH 経由の Node.js

始める前に

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

  2. Node.js、 Node.js リモートインタープリター、 JavaScript デバッガー、 FTP/SFTP/WebDAV 接続プラグインを 設定 | プラグイン ページで、 JetBrains Marketplace からプラグインをインストールするの説明に従ってインストールします。 プラグインは Ultimate サブスクリプション付きの IntelliJ IDEA でのみ利用できます。

  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. ノードランタイム フィールドの横にある 参照ボタン をクリックします。

    ランタイムの追加 - 閲覧ボタン
  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 は、たとえば実行 / デバッグ構成を作成するときに、 ノードランタイム リストから プロジェクト エイリアスを選択するたびに、このインタープリターを自動的に使用します。

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

    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 構成を選択し、その横にある 実行ボタン をクリックします。

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

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

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

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

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

2026 年 11 月 3 日