リモート Node.js ランタイムの構成
IntelliJ IDEA では、リモートホストまたは仮想環境にインストールされた Node.js 上でアプリケーションを開発、テスト、リント、実行、デバッグする場合、リモート Node.js ランタイムを構成する必要があります。
リモート Node.js ランタイムは、Node.js リモートインタープリターの構成ダイアログで設定します。このダイアログは、設定ダイアログの JavaScript ランタイムページから、またはそれ以降に、リモート環境でアプリケーションを実行またはデバッグするための Node.js 実行 / デバッグ構成を作成または編集するときに開くことができます。
推奨される方法は、設定ダイアログでリモート Node.js ランタイムを設定することです。この場合、ランタイムと関連するパッケージマネージャーをプロジェクトのデフォルトとして設定できます。
Node.js 実行 / デバッグ構成で直接構成したリモート Node.js ランタイムは、この実行 / デバッグ構成でのみ使用できます。
SSH 接続経由でアクセス可能なホスト上のリモート Node.js ランタイム
始める前に
JetBrains マーケットプレイスからプラグインをインストールする説明に従って、Node.js および Node.js リモートインタープリタープラグインを設定 | プラグインページのマーケットプレースタブにインストールします。
設定で FTP/SFTP/WebDAV 接続プラグインが有効になっていることを確認します。Ctrl+Alt+S を押して設定を開き、を選択します。インストール済みタブをクリックします。検索フィールドに FTP/SFTP/WebDAV 接続と入力します。プラグインの詳細については、プラグインのマッピングを参照してください。
SSH 構成を作成する説明に従って、ターゲットリモートホスト上の SSH サーバーへのアクセスを構成し、このサーバーが実行されていることを確認します。
SSH 経由の Node.js ランタイムは、Node.js リモートインタープリターの構成ダイアログで設定します。このダイアログは、設定ダイアログの JavaScript ランタイムページから、または Node.js の実行 / デバッグ構成を作成または編集するを使用してアプリケーションを実行またはデバッグする際に開くことができます。
推奨される方法は、設定ダイアログでリモート Node.js ランタイムを設定することです。この場合、ランタイムと関連するパッケージマネージャーをプロジェクトのデフォルトとして設定できます。
Node.js 実行 / デバッグ構成で直接構成したリモート Node.js ランタイムは、この実行 / デバッグ構成でのみ使用できます。
設定で SSH 経由でリモート Node.js ランタイムを構成するダイアログ
設定ダイアログ(Ctrl+Alt+S)を開き、に移動します。
ノードランタイムフィールドの横にある
をクリックします。

現在構成されているすべてのランタイムのリストが表示されている Node.js ランタイムダイアログで、ツールバーの
をクリックし、コンテキストメニューからリモートの追加を選択します。

開いた Node.js リモートランタイムを構成するダイアログで、SSH を選択します。
使用する SSH 構成を選択します。

または、
をクリックして、SSH 構成を作成する説明に従って新しい SSH 構成を作成します。
OK をクリックすると、新しいランタイムがリストに追加される Node.js ランタイムダイアログに戻ります。

新しく構成されたランタイムをプロジェクトのデフォルトとして設定するには、リストでそれを選択し、OK をクリックして JavaScript ランタイムダイアログに戻ります。
IntelliJ IDEA は、たとえば実行 / デバッグ構成を作成するときに、ノードランタイムリストから
Projectエイリアスを選択するたびに、このインタープリターを自動的に使用します。新しいランタイムに関連付けられたパッケージマネージャーをプロジェクトの依存関係の管理に使用するには、このパッケージマネージャーをプロジェクトのデフォルトとして設定します。そのためには、パッケージマネージャーフィールドにパッケージマネージャーの場所を指定します。
npm 実行可能ファイルのデフォルトの場所は
/usr/local/lib/node_modules/npmです。
実行 / デバッグ構成で SSH 経由でリモート Node.js ランタイムを構成する
に進みます。開いた構成の編集ダイアログで、ツールバーの
をクリックし、コンテキストメニューから Node.js を選択します。「実行 / デバッグ構成: Node.js」ダイアログが開きます。
ノードランタイムフィールドの横にある
をクリックします。

Node.js ランタイムダイアログが開きます。
ツールバーの
をクリックし、コンテキストメニューからリモートの追加を選択します。

上記の説明に従って、 SSH 経由でリモート Node.js ランタイムを構成します。
Docker コンテナー内のリモート Node.js ランタイム
始める前に
JetBrains マーケットプレイスからプラグインをインストールする説明に従って、設定 | プラグインページのマーケットプレースタブに Node.js リモートインタープリタープラグインをインストールして有効にします。
設定 | プラグインページのインストール済みタブで、Node.js および Docker に必要なプラグインが有効になっていることを確認します。詳細については、「プラグインのマッピング」を参照してください。
Docker の説明に従って、Docker をダウンロード、インストール、設定します。
Docker の Node.js ランタイムは、Node.js リモートインタープリターの構成ダイアログで設定します。このダイアログは、設定ダイアログの JavaScript ランタイムページから、または Docker でアプリケーションを実行またはデバッグするために Node.js の実行 / デバッグ構成を作成または編集するを実行する際に開くことができます。
推奨される方法は、設定ダイアログでリモート Node.js ランタイムを設定することです。この場合、ランタイムと関連するパッケージマネージャーをプロジェクトのデフォルトとして設定できます。これにより、Docker で設定された Node.js ランタイムを使用してアプリを実行およびデバッグできるだけでなく、プロジェクトの依存関係の管理、テストの実行、コードのリンティングも実行できるようになります。
Node.js 実行 / デバッグ構成で直接構成したリモート Node.js ランタイムは、この実行 / デバッグ構成でのみ使用できます。
設定で Node.js ランタイムを構成するダイアログ
に進みます。開いた構成の編集ダイアログで、ツールバーの
をクリックし、コンテキストメニューから Node.js を選択します。
開いた実行 / デバッグ構成: Node.js ダイアログで、ノードランタイムフィールドの横にある
をクリックします。
現在構成されているすべてのランタイムのリストが表示されている Node.js ランタイムダイアログで、ツールバーの
をクリックし、コンテキストメニューからリモートの追加を選択します。
開いた Node.js リモートランタイムを構成するダイアログで、Docker オプションを選択します。
サーバーフィールドに、使用する Docker の設定を指定します。詳細については、Docker デーモンの接続設定を構成するを参照してください。リストから構成を選択するか、
をクリックして、開いた Docker ページ上に新しい構成を作成します。
イメージ名: フィールドで、使用するベース Docker イメージを指定します。リストから以前にダウンロードしたイメージまたはカスタムイメージのいずれかを選択するか、
node:argonやmhart/alpine-nodeなどのイメージ名を手動で入力します。後で実行構成を起動すると、Docker はマシン上で指定されたイメージを検索します。検索が失敗した場合、イメージは Docker レジストリページの Docker 公式イメージ(英語)リポジトリからダウンロードされます。Node.js ランタイムパスフィールドには、指定されたイメージのデフォルトの Node.js ランタイムの場所が表示されます。
OK をクリックすると、IntelliJ IDEA は Node.js リモートインタープリターの構成ダイアログを閉じ、Node.js ランタイムダイアログに切り替えます。ここで新しいランタイム構成がリストに追加されます。実行構成に戻るには、OK をクリックします。
Node.js 実行 / デバッグ構成で Node.js ランタイムを構成する
に進みます。開いた構成の編集ダイアログで、ツールバーの
をクリックし、コンテキストメニューから Node.js を選択します。「実行 / デバッグ構成: Node.js」ダイアログが開きます。
ノードランタイムフィールドの横にある
をクリックします。Node.js ランタイムダイアログが開きます。
ツールバーの
をクリックし、コンテキストメニューからリモートの追加を選択します。

上記の説明に従って、リモート Node.js ランタイムを構成します。
Docker Compose 定義を持つ Docker コンテナーでリモート Node.js ランタイムを使用する
Docker Compose(英語) を使用すると、Node.js サーバーとアプリケーションコードを別々のサービスとして実行できます。必要に応じてコンテナーを追加することで各サービスを拡張できます。これにより、実稼働環境に似た動的環境で効率的な開発とテストを実行できます。
始める前に
JetBrains マーケットプレイスからプラグインをインストールする説明に従って、設定 | プラグインページのマーケットプレースタブに Node.js リモートインタープリタープラグインをインストールして有効にします。
設定 | プラグインページのインストール済みタブで、Node.js および Docker に必要なプラグインが有効になっていることを確認します。詳細については、「プラグインのマッピング」を参照してください。
Docker の説明に従って、Docker をダウンロード、インストール、設定します。
マルチコンテナー Docker アプリケーションの Node.js ランタイムは、Node.js リモートインタープリターの構成ダイアログで設定します。このダイアログは、設定ダイアログの JavaScript ランタイムページから、または Node.js の実行 / デバッグ構成を作成または編集しますを使用して Vagrant 環境でアプリケーションを実行またはデバッグする際に、設定ダイアログ以降から開くことができます。
推奨される方法は、設定ダイアログでリモート Node.js ランタイムを設定することです。この場合、ランタイムと関連するパッケージマネージャーをプロジェクトのデフォルトとして設定できます。これにより、Docker で設定された Node.js ランタイムを使用してアプリを実行およびデバッグできるだけでなく、プロジェクトの依存関係の管理、テストの実行、コードの lint チェックも可能になります。以下の npm、pnpm、yarn と Docker、アプリケーションをテストする、Docker を使用した ESLint を参照してください。
Node.js 実行 / デバッグ構成で直接構成したリモート Node.js ランタイムは、この実行 / デバッグ構成でのみ使用できます。
設定ダイアログ(Ctrl+Alt+S)を開き、に移動します。
ノードランタイムフィールドの横にある
をクリックします。

現在構成されているすべてのランタイムのリストが表示されている Node.js ランタイムダイアログで、ツールバーの
をクリックし、コンテキストメニューからリモートの追加を選択します。

開いた Node.js リモートランタイムを構成するダイアログで、Docker Compose を選択します。
サーバーリストから、使用する Docker 構成を選択します。

または、フィールドの横にある新規をクリックし、Docker サポートを有効にする説明に従って Docker サーバーを構成します。
構成ファイルフィールドで使用する docker-compose 設定ファイルを指定します。参照をクリックし、表示される Docker Compose 構成ファイルダイアログで設定ファイルのリストを作成します。

サービスリストから、使用するサービスを選択します。

OK をクリックすると、Node.js ランタイムダイアログに戻り、新しいランタイムがリストに追加されます。新しく構成されたランタイムをプロジェクトのデフォルトとして設定するには、リストでそのランタイムを選択し、OK をクリックして JavaScript ランタイムダイアログに戻ります。

IntelliJ IDEA は、たとえば実行 / デバッグ構成を作成するときに、ノードランタイムリストから Project エイリアスを選択するたびに、このインタープリターを自動的に使用します。
新しいランタイムに関連付けられたパッケージマネージャーをプロジェクトの依存関係の管理に使用するには、このパッケージマネージャーをプロジェクトのデフォルトとして設定します。そのためには、パッケージマネージャーフィールドにパッケージマネージャーの場所を指定します。詳しくはプロジェクト内のデフォルトの Node.js ランタイムとパッケージマネージャーを指定するを参照してください。
プロジェクト内のデフォルトの Node.js ランタイムとパッケージマネージャーを指定する
IntelliJ IDEA は、実行 / デバッグ構成の作成時など、ノードランタイムリストから Project エイリアスを選択するたびに、デフォルトのプロジェクトインタープリターを自動的に使用します。
デフォルトのプロジェクトパッケージマネージャーは、依存関係を管理するために自動的に使用されます。たとえば、package.json ファイルから <package manager> install を実行したり、ESLint、Prettier などのサードパーティツールをインストールしたりします。
設定ダイアログ(Ctrl+Alt+S)を開き、に移動します。
推奨ランタイムリストで Node.js が選択されていることを確認します。

ノードランタイムリストから、現在のプロジェクトでデフォルトで使用する構成を選択します。

パッケージマネージャーリストから、使用するパッケージマネージャーに関連付けられているエイリアスを選択します。IntelliJ IDEA はその位置を自動的に検出します。

または、必要なパッケージマネージャーの場所を手動で指定します。
npm 実行可能ファイルのデフォルトの場所は
/usr/local/lib/node_modules/npmです。pnpm のデフォルトの場所は、インストール方法によって異なります。
npm を介してインストールするための /usr/local/lib/node_modules/pnpm。
カールを介してインストールするための /usr/local/pnpm-global/<version>/node_modules/pnpm(
curl -f https://get.pnpm.io/<version>.js | node - add --global pnpm)。
詳細については、pnpm 公式 Web サイト(英語)を参照してください。
ヤーンのデフォルトの場所は /opt/yarn-<version>5 で、たとえば /opt/yarn-v1.22.5 です。
Node.js 実行 / デバッグ構成で Docker Compose 定義を使用して Node.js ランタイムを構成する
に進みます。開いた構成の編集ダイアログで、ツールバーの
をクリックし、コンテキストメニューから Node.js を選択します。「実行 / デバッグ構成: Node.js」ダイアログが開きます。
ファイルフィールドで、それを開始するアプリケーションのメインファイルへのパスを指定します(たとえば、Express(英語) アプリケーションの場合は bin/www)。

必要に応じて、Node.js アプリケーションの実行とデバッグで説明されているいくつかのオプション設定を指定します。
ノードランタイムリストから、Docker Compose 経由で関連するリモート Node.js ランタイムを選択します。

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

Docker Compose エリアで、Docker Compose に渡すコマンドとオプションを指定します。デフォルト設定を受け入れるか、「
」をクリックしてカスタム設定 (たとえば、
--rmや--service-portsなどのカスタム Docker Compose フラグ) を指定します。詳細については、Docker オフィシャル Web サイト(英語)を参照してください。コマンドプレビューを確認してください。

Vagrant インスタンスの Node.js ランタイム
Vagrant(英語) を使用すると、Node.js アプリケーションをすばやくブートストラップして、IntelliJ IDEA から実行、デバッグ、プロファイリングできます。
始める前に
JetBrains マーケットプレイスからプラグインをインストールする説明に従って、設定 | プラグインページのタブマーケットプレースに Node.js、Node.js リモートインタープリター、Vagrant プラグインをインストールします。
Vagrant(英語) と Oracle の VirtualBox(英語) がコンピューターにダウンロード、インストール、構成されていることを確認してください。詳細については、Vagrant を参照してください。
次の実行可能ファイルの親フォルダーがシステム PATH 変数に追加されていることを確認します。
Vagrant から vagrant.bat または vagrant を選択してください。これは、Vagrant インストーラによって自動的に実行されます。
Oracle VirtualBox インストールからの VBoxManage.exe または VBoxManage。
Vagrant 環境における Node.js ランタイムは、Node.js リモートインタープリターの構成ダイアログで設定します。このダイアログは、設定ダイアログの JavaScript ランタイムページから、または Vagrant 環境でアプリケーションを実行またはデバッグするために Node.js の実行 / デバッグ構成を作成または編集しますを実行する際に、設定ダイアログ以降から開くことができます。
推奨される方法は、設定ダイアログでリモート Node.js ランタイムを設定することです。この場合、ランタイムと関連するパッケージマネージャーをプロジェクトのデフォルトとして設定できます。
Node.js 実行 / デバッグ構成で直接構成したリモート Node.js ランタイムは、この実行 / デバッグ構成でのみ使用できます。
設定で Node.js ランタイムを構成するダイアログ
設定ダイアログ(Ctrl+Alt+S)を開き、に移動します。
ノードランタイムフィールドの横にある
をクリックします。

現在構成されているすべてのランタイムのリストが表示されている Node.js ランタイムダイアログで、ツールバーの
をクリックし、コンテキストメニューからリモートの追加を選択します。

開いた Node.js リモートランタイムを構成するダイアログで、Vagrant を選択します。
使用する環境を指す Vagrant インスタンスフォルダーを指定してください。
技術的には、目的の環境の VagrantFile 構成ファイルが配置されているフォルダーです。この設定に基づいて、IntelliJ IDEA は Vagrant ホストを検出し、Vagrant ホスト URL 読み取り専用フィールドにリンクとして表示します。
デフォルトでは、フィールドには現在のプロジェクトフォルダーが表示されます。
Node.js ランタイムパスフィールドで、Node.js 実行可能ファイルの場所を指定します。

Node.js 実行可能ファイルを見つけるには、埋め込みターミナル(Alt+F12)を開いて次のように入力します。
vagrant ssh whereis node exit
OK をクリックすると、新しいランタイムがリストに追加される Node.js ランタイムダイアログに戻ります。
新しく構成されたランタイムをプロジェクトのデフォルトとして設定するには、リストでそれを選択し、OK をクリックして JavaScript ランタイムダイアログに戻ります。

IntelliJ IDEA は、たとえば実行 / デバッグ構成を作成するときに、ノードランタイムリストから
Projectエイリアスを選択するたびに、このインタープリターを自動的に使用します。使用するパッケージマネージャーへのパスを指定します。

パッケージマネージャーを見つけるには、組み込みターミナル(Alt+F12)を開いて次のように入力します。
vagrant ssh whereis <package manager> exit
Node.js 実行 / デバッグ構成で Node.js ランタイムを構成する
に進みます。開いた構成の編集ダイアログで、ツールバーの
をクリックし、コンテキストメニューから Node.js を選択します。「実行 / デバッグ構成: Node.js」ダイアログが開きます。
ノードランタイムフィールドの横にある
をクリックします。Node.js ランタイムダイアログが開きます。
ツールバーの
をクリックし、コンテキストメニューからリモートの追加を選択します。
上記の説明に従って、 Vagrant 環境でリモート Node.js ランタイムを構成します。
関連ページ:
JavaScript ランタイム
推奨ランタイム:このエリアでは、使用するランタイムを選択します。利用可能なランタイムのセットは、インストールされているプラグインによって異なります。パッケージマネージャー:このフィールドでは、現在のプロジェクトのパッケージマネージャー (npm、Yarn、pnpm、bun) を選択します。IntelliJ IDEA は、これらのマネージャーへの現在のシステムパスに、、エイリアスを使用します。カスタムインストールを使用するには、選択をクリックし、関連するパッケージマネージャーのインストールフォ...
プラグインのインストール
プラグインは IntelliJ IDEA のコア機能を拡張します。例: プラグインをインストールして、次の機能を取得します。バージョン管理システム、課題追跡システム、ビルド管理サーバー、その他のツールとの統合。さまざまな言語とフレームワークのコーディング支援サポート。ショートカットのヒント、ライブプレビュー、ファイルウォッチャーなど。新しいプログラミング言語を学ぶのに役立つコーディング演習。プラグイン設定を開くを押して設定を開き、を選択します。マーケットプレースタブを使用して、JetBrains...
SSH 構成を作成する
IntelliJ IDEA では、リモートサーバーの SSH 接続パラメーターを専用の SSH 構成として保存できます。作成された構成は、SFTP デプロイサーバーへの接続や SSH セッションの起動に使用できます。FTP/SFTP/WebDAV 接続プラグインを有効にするこの機能は、デフォルトで IntelliJ IDEA にバンドルされて有効になっている FTP/SFTP/WebDAV 接続プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してく...
実行 / デバッグ構成: Node.js
作成: 次の Node.js バージョンは、IntelliJ IDEA 2023.3 以降でサポートされています。Node.js 22 - アクティブな長期サポート(LTS)バージョン、Node.js 24 - 現在のバージョン、サポートされている Node.js バージョンの詳細を参照してください。このダイアログで、コンピューター上の Node.js アプリケーションと一緒にデバッガーを開始するための構成を作成します。始める前に:Node.js をダウンロードしてインストールします。JetBra...
Docker
Docker は、分離された再現可能な環境で実行可能ファイルをデプロイおよび実行するためのツールです。これは、たとえば、本番環境と同じ環境でコードをテストする場合に役立ちます。IntelliJ IDEA は Docker 機能を統合し、Docker イメージの作成、Docker コンテナーの実行、Docker Compose アプリケーションの管理、パブリックおよびプライベート Docker レジストリの使用など、IDE から直接実行するための支援を提供します。Docker プラグインを有効にする...
Docker 接続設定
IntelliJ IDEA から Docker エンジン API にアクセスするための設定を指定します。Docker と IntelliJ IDEA の統合の使用方法の詳細については、「Docker」を参照してください。Docker プラグインを有効にするこの機能は、デフォルトで IntelliJ IDEA にバンドルされて有効になっている Docker プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択する...