n8n 中文文档

执行命令

执行命令节点在运行 n8n 的主机上运行 shell 命令。

警告

安全考虑

执行命令节点可能会在与不受信任的用户一起操作的环境中引入重大安全风险。因此,从 n8n 2.0 开始,该节点默认为 残疾人。

提示

哪个 shell 运行该命令?

该节点在主机的默认 shell 中执行命令。例如,Windows 上为 cmd,macOS 上为 zsh。

如果您使用 Docker 运行 n8n,您的命令将在 n8n 容器中运行,而不是在 Docker 主机中运行。

如果您使用的是 队列模式,则该命令在生产模式下执行任务的工作线程上运行。运行手动执行时,它将在主实例上运行,除非您将 OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS 设置为 true。

提示

Feature availability 功能可用性

Execute Command 节点适用于:

  • Self-hosted 自托管:所有版本

该节点不适用于 n8n Cloud。

节点参数

使用以下参数配置节点。

执行一次

选择您希望节点仅执行一次(打开)还是对其作为输入接收的每个项目执行一次(关闭)。

命令

输入要在主机上执行的命令。有关运行 多个命令 和 卷曲命令 的示例,请参阅以下部分。

运行多个命令

使用以下两种方法之一在一个执行命令节点中运行多个命令:

  • 在一行中输入每个命令,并用 && 分隔。例如,您可以使用 && 将更改目录 (cd) 命令与列表 (ls) 命令结合起来。

    bash cd bin && ls * 在单独的行中输入每个命令。例如,您可以在更改目录 (cd) 命令之后在新行中写入列表 (ls) 命令。

    bash cd bin ls

运行 cURL 命令

您还可以使用 HTTP 请求 节点发出 cURL 请求。

如果要在执行命令节点中运行curl命令,则必须基于现有的n8n映像构建Docker映像。默认的 n8n Docker 镜像使用 Alpine Linux。

提示

apk 不包含在 n8n 图像中

apk 包管理器已从官方 n8n Docker 映像中删除。要安装像 curl 这样的软件包,您需要首先从新的 Alpine 基础镜像恢复 apk,如下所示。

  1. 创建名为 Dockerfile 的文件。
  2. 将以下代码片段添加到 Dockerfile 中。
   FROM n8nio/n8n
   USER root

   # Restore the apk package manager (removed from the base image)
   COPY --from=alpine:3.22 /sbin/apk /sbin/apk
   COPY --from=alpine:3.22 /lib/apk /lib/apk
   COPY --from=alpine:3.22 /usr/lib/libapk* /usr/lib/

   RUN apk add --no-cache curl
   USER node
  1. 在同一文件夹中,执行以下命令来构建 Docker 映像。
   docker build -t n8n-curl .
  1. 替换之前使用的 Docker 镜像。例如,将 n8nio/n8n 替换为 n8n-curl。
  2. 运行新创建的 Docker 镜像。您现在可以使用执行命令节点执行curl。

模板和示例

浏览 n8n-nodes-base.executecommand 集成模板 或 搜索所有模板

常见问题

有关常见问题和建议的解决方案,请参阅 常见问题。

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。