# 配置 Node.js 远程运行时对话框

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

> **TL;DR**
> 所需插件  :
>
>
>
> `JavaScript 和 TypeScript`  -  插件与 IntelliJ IDEA 捆绑在一起，并默认启用。
>
>
>
> `JavaScript Debugger` 、  `Node.js`  和  `Node.js Remote Interpreter`  -  在   设置 | 插件   页面上安装插件。 插件仅在具有 Ultimate 订阅的 IntelliJ IDEA 中可用。

在 IntelliJ IDEA 2023.3 及以后版本中，支持以下 Node.js 版本：

* Node.js 22 - 当前长期支持（ LTS ）版本

* Node.js 24 - 当前版本

有关更多信息，请参阅 [支持的 Node.js 版本](supported-node-js-versions.html)。

当您在 [Node.js 运行时](node-js-interpreters.html) 对话框中点击   添加   !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，并从下拉菜单中选择   远程……   时，将打开该对话框。

使用此对话框配置对远程主机上的 Node.js 安装，或在  Vagrant  实例中设置的开发环境中的 Node.js 安装的访问。

![在 Docker 上配置远程 Node.js 解释器](https://resources.jetbrains.com/help/img/idea/2026.3/ws_add_node_remote_docker.png)

|  条目  |  描述  |
| --- | --- |
|     SSH     |     选择此选项以配置对通过 SSH 凭据可访问的远程主机或环境中的 Node.js 解释器的访问。 选择相应的 SSH 配置，并检查远程主机或环境中默认 Node.js 解释器的路径。       了解更多信息，请参阅 [创建 SSH 配置](create-ssh-configurations.html)。     |
|     Docker     |     此选项仅在安装并启用  Node.js 、  Node.js Remote Interpreter 和  Docker Integration 插件后可用，如 [从存储库安装插件](managing-plugins.html#install_plugin_from_repo)中所述。       选择此选项以使用 Docker 容器中的 Node.js 解释器。        1.     在   服务器  字段中，指定要使用的  Docker 配置 。 有关更多信息，请参阅 [配置 Docker 守护程序连接设置](docker.html#connect_to_docker)。 从列表中选择一个配置，或点击 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)并在打开的 [Docker 页面](settings-docker.html)上创建一个新配置。        2.  在   镜像名称  字段中，指定要使用的基础 Docker 镜像。 从列表中选择一个先前下载的或自定义的图像，或者手动输入图像名称，例如，  `node:argon` 或  `mhart/alpine-node` 。 当您稍后启动运行配置时，Docker 将在您的机器上搜索指定的镜像。 如果搜索失败，镜像将从 [Docker 官方镜像](https://hub.docker.com/_/node/) 仓库下载到 [Docker Registry 页面](settings-docker-registry.html)。     3.    Node.js 运行时路径   字段显示指定镜像中的默认 Node.js 解释器的位置。     4.  当您点击   OK   时，IntelliJ IDEA 会关闭   配置 Node.js 远程解释器   对话框，并将您带到 [Node.js 运行时](node-js-interpreters.html) 对话框，在其中会将新的运行时配置添加到列表中。 点击   OK   返回运行配置。     |
|     Docker Compose     |     此选项仅在安装并启用  Node.js 、  Node.js 远程解释器  和  Docker 集成  插件后可用，如 [从仓库安装插件](managing-plugins.html#install_plugin_from_repo)中所述。       选择此选项以使用在 Docker Compose 文件  `docker-compose.yml`  中定义的 Node.js 解释器配置。 请注意，此文件必须在  `命令` 字段中包含  `node` 或  `npm` ，例如，  `command: node ./src/app.js` 。 如需更多信息，请参阅 [Docker official website](https://docs.docker.com/compose/overview/)。        1.     在   服务器  字段中，指定要使用的  Docker 配置 。 有关更多信息，请参阅 [配置 Docker 守护程序连接设置](docker.html#connect_to_docker)。 从列表中选择一个配置，或点击 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)并在打开的 [Docker 页面](settings-docker.html)上创建一个新配置。        2.  在   配置文件(s)   字段中，指定定义应用程序服务的 [docker-compose.yml 文件](https://docs.docker.com/compose/compose-file/)。     3.  从   服务   列表中选择您要运行的服务。     4.  可选地，您可以在   环境变量   字段中定义环境变量。 有关更多信息，请参阅 [Docker Compose run configuration](docker-compose-run-configuration.html)设置。     |
|     Vagrant     |     此选项仅在安装并启用  Vagrant 插件时可用。  Vagrant  插件未 与 IntelliJ IDEA 捆绑，但可以按照 [从 JetBrains Marketplace 安装插件](managing-plugins.html#install_plugin_from_repo) 中的说明，在   设置 \| 插件   页面上安装。望 JSON? final with response format maybe no code. It output a tool-like object? In final we need content matching schema. Done. But maybe not include action/broken? final generated under processData? It includes       选择此选项以配置对  Vagrant 实例  中 Node.js 解释器的访问，使用您的  Vagrant  凭据。 从技术上讲，这是用于所需环境的  VagrantFile  配置文件所在的文件夹。 基于此设置，IntelliJ IDEA 检测到  Vagrant host  并将其作为链接显示在   Vagrant 主机 URL   只读字段中。       要使用解释器配置，您需要  路径映射 ，以设置项目文件夹、服务器上用于复制项目文件的文件夹以及访问服务器上复制数据的 URL 地址之间的对应关系。 IntelliJ IDEA 从  `VagrantFile` 配置文件中评估路径映射。     |
|  Node.js 运行时路径  |     在此字段中，根据所选远程开发环境的配置，指定  Node.js 可执行文件的位置。     * 对于 Vagrant 实例，IntelliJ IDEA 默认建议 `/usr/bin/node` 位置。    * 对于 Docker 容器，IntelliJ IDEA 默认建议 `node` 位置。      若要指定不同的文件夹，请点击 ![打开](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.open.svg) 并在打开的对话框中选择相关文件夹。 请注意，Node.js 主目录必须处于可编辑状态。          当您点击   OK   时，IntelliJ IDEA 会检查 Node.js 可执行文件是否确实存储在指定的文件夹中。        * 如果没有找到 Node.js 可执行文件，IntelliJ IDEA 会显示一条错误消息，询问您是否继续搜索或仍然保存解释器配置。 ![未找到 PHP 执行文件](https://resources.jetbrains.com/help/img/idea/2026.3/no-php-executable-found-message.png)    * 如果找到 Node.js 可执行文件，您将返回 Node.js 运行时 对话框，其中显示了安装文件夹和检测到的 Node.js 解释器版本。    |

## See also

### 过程

[JavaScript 运行时环境](javascript-runtime.html)