# Node.js と Docker Compose

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

> **TL;DR**
> 必須プラグイン  ：
>
>
>
> `JavaScript and TypeScript` 、  `Node.js` 、  `Node.js Remote Interpreter` 、  `Docker`  - プラグインは CLion にバンドルされており、デフォルトで有効化されています。
>
>
>
> 下記の [Before you start](#before_you_start)を参照してください。

[Docker Compose(英語)](https://docs.docker.com/compose/overview/) は、マルチコンテナーアプリケーションを実行するために使用されます。 例: Web サーバー、バックエンドデータベース、アプリケーションコードを個別のサービスとして実行できます。 各サービスは、必要に応じてコンテナーを追加することで拡張できます。 これにより、本番環境と同様に、動的な環境で効率的な開発とテストを実行できます。

## 始める前に

Procedure:

1. JavaScript と TypeScript 、  JavaScript デバッガー 、  Node.js 、  Node.js リモートインタープリター 、  Docker  の必須プラグインが   設定 | プラグイン   ページで有効化されていることを確認します。 詳細については、 [プラグインの管理](managing-plugins.html)を参照してください。

2. Node.js  および  Node.js リモートインタープリター  プラグインを   設定 | プラグイン   ページにインストールします ( [JetBrains Marketplace からプラグインをインストールする](managing-plugins.html#install_plugin_from_repo) の説明に従います)。

3. Docker  をダウンロード、インストール、構成し、 [Docker プラグイン統合](docker.html) に記載されている手順に従ってください。

## Docker Compose で Node.js ランタイムを構成する

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

推奨される方法は、   設定   ダイアログでリモート Node.js ランタイムを設定することです。 この場合、ランタイムと関連するパッケージマネージャーをプロジェクトのデフォルトとして設定できます。 これにより、Docker で設定された Node.js ランタイムを使用してアプリを実行およびデバッグできるだけでなく、プロジェクトの依存関係の管理、テストの実行、コードの lint チェックも可能になります。 以下の [npm、pnpm、yarn と Docker](node-with-docker.html#ws_node_docker_manage_dependencies)、 [アプリケーションをテストする](node-with-docker.html#ws_node_docker_test_app)、 [Docker を使用した ESLint](node-with-docker.html#ws_node_docker_lint) を参照してください。

Node.js 実行 / デバッグ構成で直接構成したリモート Node.js ランタイムは、この実行 / デバッグ構成でのみ使用できます。

Procedure:

1. 設定   ダイアログ（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ）を開き、  `言語 & フレームワーク | JavaScript ランタイム`  に進みます。

2. 「   ノードランタイム   」フィールドの横にある「 ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) 」をクリックします。

![ランタイムを追加 - 参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_interpreter_from_settings_browse_button.png)

3. 現在構成されているすべてのランタイムのリストが表示されている [Node.js ランタイム](node-js-interpreters.html)ダイアログで、ツールバーの ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックし、コンテキストメニューから   リモートの追加   を選択します。

![Docker コンテナーで Node.js ランタイムを構成する: リモートの追加](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_interpreter_from_settings_docker_add_remote.png)

4. 開いた [Node.js リモートランタイムを構成するダイアログ](null)で、   Docker Compose   を選択します。

5. サーバー   リストから、使用する Docker 構成を選択します。

![Docker Compose 経由で Node.js ランタイムを構成する: Docker サーバーを選択する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_interpreter_from_settings_docker_compose_docker_server.png)

または、フィールドの横にある   新規   をクリックし、 [Docker サポートを有効にする](docker.html#connect_to_docker)説明に従って Docker サーバーを構成します。

6. 構成ファイル   フィールドで、使用する  `docker-compose`  構成ファイルを指定します。 「   閲覧   」をクリックし、表示される「   Docker Compose 構成ファイル   」ダイアログで構成ファイルのリストを作成します。

![Docker Compose 経由で Node.js ランタイムを構成する: 構成ファイル](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_interpreter_from_settings_docker_compose_configuration_files.png)

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

![Docker Compose 経由で Node.js ランタイムを構成する: サービスの選択](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_interpreter_from_settings_docker_compose_select_service.png)

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

![リモートランタイムダイアログ: Docker の新しい Node.js ランタイムがリストに追加されました](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_configure_interpreter_docker_compose_added.png)

CLion は、   ノードランタイム   リストから  `プロジェクト`  エイリアスを選択するたびに、このインタープリターを自動的に使用します。たとえば、実行／デバッグ構成の作成時などです。

新しいランタイムに関連付けられたパッケージマネージャーをプロジェクトの依存関係の管理に使用するには、このパッケージマネージャーをプロジェクトのデフォルトとして設定します。 そのためには、   パッケージマネージャー   フィールドにパッケージマネージャーの場所を指定します。 詳しくは [プロジェクトでデフォルトの Node.js ランタイムとパッケージマネージャーを指定する](#ws_node_docker_specify_default_project_interpreter_and_package_manager)を参照してください。

### プロジェクト内のデフォルトの Node.js ランタイムとパッケージマネージャーを指定する

CLion は、   ノードランタイム   リストから  `プロジェクト`  エイリアスを選択するたびに、デフォルトプロジェクトインタープリターを自動的に使用します。たとえば、実行／デバッグ構成の作成時などです。

デフォルトのプロジェクトパッケージマネージャーは、依存関係を管理するために自動的に使用されます。たとえば、  `パッケージ.json​​` ファイルから  `<package manager> install` を実行したり、ESLint、Prettier などのサードパーティ製ツールをインストールしたりします。

Procedure:

1. 設定   ダイアログ（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ）を開き、  `言語 & フレームワーク | JavaScript ランタイム`  に進みます。

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

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

![設定: 新しく構成されたリモート Node.js ランタイムがデフォルトで選択されました](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_interpreter_from_settings_docker_compose_default_project_interpreter_and_package_manager_detected.png)

または、必要なパッケージマネージャーの場所を手動で指定してください。

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

* pnpm のデフォルトの場所はインストールメソッドによって異なります： 1. npm を介してインストールするための `/usr/local/lib/node_modules/pnpm` 。 2. カールを介してインストールするための `/usr/local/pnpm-global/<version>/node_modules/pnpm` （ `curl -f https://get.pnpm.io/<version>.js | node - add --global pnpm` ）。 詳細については、 [pnpm 公式 Web サイト(英語)](https://pnpm.io/installation)を参照してください。

* ヤーンのデフォルトの場所は `/opt/yarn-<version>5` で、たとえば `/opt/yarn-v1.22.5` です。

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

Procedure:

1. `実行 | 実行構成の編集​`  に進みます。 開いた   構成の編集   ダイアログで、ツールバーの ![the Add New Configuration button](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックし、コンテキストメニューから   Node.js   を選択します。 「 [実行 / デバッグ構成: Node.js](run-debug-configuration-node-js.html)」ダイアログが開きます。

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

![Node.js の実行 / デバッグ構成: JavaScript ファイルが指定されました](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_docker_compose_run_configuration_js_file_specified.png)

3. 必要に応じて、 [Node.js アプリケーションの実行とデバッグ](running-and-debugging-node-js.html#ws_node_run_config_optionally)で説明されているいくつかのオプション設定を指定します。

4. ノードランタイム   リストから、Docker Compose 経由で関連するリモート Node.js ランタイムを選択します。

![Node.js と Docker Compose: 構成の実行 / デバッグ、インタープリターの選択](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_docker_compose_run_configuration_select_interpreter.png)

または、   ノードランタイム   フィールドの横にある ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) をクリックし、 [上記のよう](#ws_node_docker_compose_configure_interpreter)にリモート Node.js ランタイムを構成します。

![Node.js と Docker Compose: 実行 / デバッグ構成、ランタイムの構成、リモートの追加を選択](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_docker_compose_run_configuration_add_remote.png)

5. Docker Compose   エリアで、Docker Compose に渡すコマンドとオプションを指定します。 デフォルト設定を受け入れるか、 ![展開ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.expandComponent.svg) をクリックしてカスタム設定を指定してください。たとえば、  `--rm`  や  `--service-ports`  などのカスタム Docker Compose フラグを指定できます。 詳細については、 [Docker 公式ウェブサイト](https://docs.docker.com/compose/reference/)を参照してください。

コマンドプレビュー   を確認してください。

![Docker Compose エリアのプレビュー](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_docker_compose_run_configuration_docker_compose_area.png)

