# Node.js と Docker

> 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 を使用すると、Node.js アプリケーションをすばやくブートストラップして、CLion から実行、デバッグ、プロファイルできます。 IDE は初期構成を自動的に新しい  `Dockerfile`  を作成し、イメージのビルドと実行、ソースコードの同期、コンテナー内に  npm  依存関係をインストールすることで行います。

[WebStorm と Docker のクイックツアー(英語)](https://blog.jetbrains.com/webstorm/2017/04/quick-tour-of-webstorm-and-docker/)でいくつかの例を見つけることができます。

## 始める前に

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 で Node.js ランタイムを構成する

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

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

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

Procedure: リモート Node.js ランタイムを作成する

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   を選択します。

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

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

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

6. イメージ命名   リストから、使用するイメージを選択します。

![Docker コンテナーで Node.js ランタイムを構成する: Docker イメージを選択](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_interpreter_from_settings_docker_select_image.png)

Node.js 実行可能ファイルは自動的に検出され、   Node.js ランタイムパス   フィールドに表示されます。

7. OK   をクリックすると、新しいランタイムがリストに追加される   Node.js ランタイム   ダイアログに戻ります。

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

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

![設定: 新しく構成されたリモート Node.js ランタイムがデフォルトで選択されました](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_interpreter_from_settings_docker_default_project_interpreter_and_package_manager_detected.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_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` です。

![Docker コンテナーで Node.js ランタイムを構成する: デフォルトのプロジェクトインタープリターとして設定](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_interpreter_from_settings_docker_default_project_interpreter_and_package_manager.png)

### npm、pnpm、yarn と Docker

CLion を使用すると、ローカルプロジェクトと同様に、プロジェクトの依存関係を管理し、Docker コンテナーでスクリプトを実行できます。

Procedure:

1. [Docker のリモート Node.js ランタイム](#ws_node_docker_configure_interpreter)が構成されていることを確認してください。

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

3. プロジェクトの依存関係を管理します。

* `パッケージ.json​​` ファイルを開き、ローカル開発時と同じように進めます。たとえば、コンテキストメニューから 「<package manager> install」を実行 を選択してください。 依存関係は Docker コンテナー内のデフォルトパッケージマネージャーでインストールされ、プロジェクト内に `node_modules` フォルダーが表示されます。

* または、コマンドラインシェルや組み込みの ターミナルエミュレータ （ `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))）を開き、必要なパッケージを手動でインストールします。たとえば、 `npm install --save-dev eslint` を実行します。

[パッケージのインストールと更新](installing-and-removing-external-software-using-node-package-manager.html#ws_installing_and_upgrading_packages) と [package.json を編集](installing-and-removing-external-software-using-node-package-manager.html#ws_npm_yarn_edit_package_json) を参照してください。

4. [スクリプト実行](installing-and-removing-external-software-using-node-package-manager.html#ws_npm_running_npm_scripts)

## 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_configure_interpreter_run_configuration.png)

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

4. ノードランタイム   リストから、Docker 環境内の関連するリモート Node.js ランタイムを選択します。

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

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

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

5. 自動生成された Docker コンテナーの設定を確認します。 ![展開アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.inline.expand.svg) をクリックすると、ポップアップで設定が開きます。

![Node.js と Docker: 実行 / デバッグ構成、Docker コンテナー設定](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_docker_run_configuration_docker_container_settings.png)

6. オプション : [下記の説明に従って](#ws_node_docker_create_run_debug_configuration_bind_ports_steps)ポートバインディングを構成します。

Procedure: ポートバインディングを構成する (オプション)

基本的に、アプリケーションが実行されているポートをコンテナーのポートにバインドする必要があります。

[Docker コンテナーの設定](#ws_node_debug_docker_container_settings)フィールドの横にある ![閲覧アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.inline.browse.svg) をクリックして、表示される   Docker コンテナー設定の編集   ダイアログで設定を指定します。

1.

ポートバインディング   領域を展開し、ツールバーの ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックします。 開いた   ポートバインディング   ダイアログで、ポートを次のようにマップします。

2.

オプションを変更   をクリックして、指定するオプションを選択します。

![Docker コンテナー設定を構成する: 指定するポートバインディングオプションを選択する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_docker_run_configuration_port_bindings_select_options.png)

3.

* 「 コンテナーポート 」フィールドに、アプリケーションで指定されているポートを入力します。

* ホストポート フィールドに、コンピューターからアプリケーションにアクセスするための任意のポートを入力します。

* OK をクリックして、新しいポートバインディングがリストに追加される Docker コンテナー設定の編集 ダイアログに戻ります。

![Docker: ポートバインディングが追加されました](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_docker_run_configuration_port_bindings_added.png)

4.

OK  をクリックして、 [実行/デバッグ構成: Node.js](run-debug-configuration-node-js.html) ダイアログに戻ります。このダイアログでは、ポートバインディングが   Docker コンテナーの設定   フィールドに追加されます。

![Docker: ポートバインディングが追加されました](https://resources.jetbrains.com/help/img/idea/2026.3/node_docker_run_configuration_port_bindings_added.png)

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

![Running a Node.js application in a Docker container](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_docker_run_app.animated.gif)

Procedure:

1. Node.js   実行/デバッグ構成を [上記の説明の通り](#ws_node_docker_create_run_debug_configuration)作成します。

2. ツールバーの   実行/デバッグ構成を選択   リストから、 [新しく作成された Node.js 構成](#ws_node_docker_create_run_debug_configuration)を選択します。

3. ![the Run button](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.execute.svg) をクリックして   実行/デバッグ構成を選択   リストに移動します。

### アプリケーションの出力を確認する

アプリケーションが期待通りに動作することを確認するために、CLion の [組み込み HTTP クライアント](http-client-in-product-code-editor.html)から HTTP リクエストを実行できます。

![Node.js with Docker: connect to a running app with a HTTP Request](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_docker_run_http_request.animated.gif)

Procedure:

1. HTTP リクエストファイルを作成します。

2. 次のリクエストを書いてください：

```HTTP_REQUEST
GET http://<host IP>:<container port>/
                    
```

例：

```HTTP_REQUEST
GET http://127.0.0.1:3010/
                    
```

3. ガターの ![Run HTTP リクエスト ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.run.svg) をクリックし、   http://<ホスト IP>:<コンテナーポート>/ を実行   の横にある ![Run HTTP リクエスト ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.run.svg) をクリックします。

![HTTP リクエストを起動する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_docker_run_http_request_launch.png)

アプリケーションの出力は、   実行   ツールウィンドウの別のタブに表示されます。

![アプリケーションの出力は、実行ツールウィンドウに表示されます](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_docker_run_http_request_output.png)

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

![Debugging a Node.js application in a Docker container](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_docker_debug_app.animated.gif)

Procedure:

1. 必要に応じて Node.js コードに [ブレークポイント](using-breakpoints.html)を設定します。

2. Node.js   構成を [上記の説明](#ws_node_docker_create_run_debug_configuration)に従って作成し、ツールバーの   実行/デバッグ構成を選択   リストから選択し、リストの横にある ![the Debug button](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.debug.svg) をクリックします。

3. [Node.js アプリケーションと一緒にローカルでデバッガーを起動する](running-and-debugging-node-js.html#debugLocal)場合に進みます。

## アプリケーションをテストする

CLion を使えば、ローカルで行うのと同じように、Docker コンテナー内で [Mocha](http://mochajs.org/) や [Jest](https://jestjs.io/) のテストを実行できます。 詳細については、 [Mocha](running-unit-tests-on-mocha.html) および [Jest](running-unit-tests-on-jest.html) を参照してください。

Procedure:

1. Docker 内の関連するリモート Node.js ランタイムがプロジェクトのデフォルトとして設定され、選択されていることを確認してください。 また、このリモートランタイムに関連付けられたパッケージマネージャーがプロジェクトのデフォルトに設定されていることを確認してください。 詳細については、 [Docker で Node.js ランタイムを構成する](#ws_node_docker_configure_interpreter)および [npm、pnpm、yarn と Docker](#ws_node_docker_manage_dependencies) を参照してください。

2. `パッケージ.json​​`  を開き、必要なテストフレームワークが  `devDependencies`  セクションにリストされていることを確認します。

```JSON
{
  "name": "node-express",
  "version": "0.0.0",
  "private": true,
  "dependencies": {
    "cookie-parser": "~1.4.4",
    "debug": "~2.6.9",
    "express": "~4.16.1",
    "http-errors": "~1.6.3",
    "morgan": "~1.9.1",
    "pug": "^3.0.2"
  },
  "devDependencies": {
    "chai": "^4.3.4",
    "concurrently": "^6.3.0",
    "eslint": "^8.1.0",
    "http-server": "^14.0.0",
    "jest": "^27.3.1",
    "mocha": "^9.1.3",
    "nyc": "^15.1.0"
  }
}
                
```

3. エディターの任意の場所を右クリックして、コンテキストメニューから   「<package manager> install」を実行   を選択します。

4. [Mocha オフィシャル Web サイト(英語)](https://mochajs.org/)または [Jest オフィシャル Web サイト(英語)](https://jestjs.io/docs/getting-started)の指示に従ってテストを作成します。

5. [Mocha テストの実行](running-unit-tests-on-mocha.html#ws_mocha_running)、 [Mocha テストのデバッグ](running-unit-tests-on-mocha.html#ws_mocha_debugging)、 [Jest テストの実行](running-unit-tests-on-jest.html#ws_jest_running_tests)、 [Jest テストのデバッグ](running-unit-tests-on-jest.html#ws_jest_debugging_tests)に従って、エディターから直接単一のテストを実行およびデバッグするか、実行 / デバッグ構成を作成して、テストの一部またはすべてを起動します。

## Docker を使用した ESLint

CLion を使用すると、ローカルと同じ方法で Docker コンテナー内のコードに対して [ESLint](https://eslint.org/) を実行できます。 詳細については、 [JavaScript リンター](linters.html)および [ESLint](eslint.html)を参照してください。

Procedure:

1. Docker 内の関連するリモート Node.js ランタイムがプロジェクトのデフォルトとして設定され、選択されていることを確認してください。 また、このリモートランタイムに関連付けられたパッケージマネージャーがプロジェクトのデフォルトに設定されていることを確認してください。 詳細については、 [Docker で Node.js ランタイムを構成する](#ws_node_docker_configure_interpreter)および [npm、pnpm、yarn と Docker](#ws_node_docker_manage_dependencies) を参照してください。

2. `パッケージ.json​​`  を開き、ESLint が  `devDependencies`  セクションにリストされていることを確認します。

```JSON
{
  "name": "node-express",
  "version": "0.0.0",
  "private": true,
  "dependencies": {
    "cookie-parser": "~1.4.4",
    "debug": "~2.6.9",
    "express": "~4.16.1",
    "http-errors": "~1.6.3",
    "morgan": "~1.9.1",
    "pug": "^3.0.2"
  },
  "devDependencies": {
    "eslint": "^8.1.0"
  }
}
                
```

3. エディターの任意の場所を右クリックして、コンテキストメニューから   「<package manager> install」を実行   を選択します。

4. その後、ESLint は、コードをローカルで操作する場合と同じように機能します。 検出された不一致の説明をエディターまたは   問題   ツールウィンドウで表示し、提案されたクイックフィックスを適用します。 詳細については、 [JavaScript リンター](linters.html)および [ESLint](eslint.html)を参照してください。

![Docker コンテナー内の ESLint](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_docker_eslint.png)

