SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor

什么是 n8n?自托管工作流自动化入门

n8n 是可部署在自有服务器上的工作流自动化工具。本文解释 n8n 的发音和含义、触发器与节点、JSON 数据流,以及何时通过 HTTP 和 Code 节点使用它。

什么是 n8n?

n8n 是一种可在自有服务器上运行的工作流自动化工具。工作流是一串称为节点的方框。第一个节点等待某个事件发生,后续节点执行处理任务。您可以在浏览器编辑器中连接这些节点。如果现成节点无法满足需求,可以插入 Code 节点,在该步骤编写 JavaScript 或 Python。

关于 n8n,有两点比功能列表更重要。它是源代码可用的软件,由您自行托管,因此工作流及其使用的凭据都保存在您控制的服务器上。它还使用普通的 HTTP 和 JSON,而不是依赖某个供应商的服务目录。因此,即使某个托管自动化产品从未提供过某个内部服务,只要该服务支持 HTTP,就可以通过 HTTP Request 节点访问它。

如何发音 n8n?这个名称是什么意思?

它的发音是“n-eight-n”。

这个名称是“nodemation”的缩写。创始人在项目 README 中作了如下解释:“node-”表示编辑器采用节点视图,运行时基于 Node.js;“-mation”表示自动化。计算“nodemation”中第一个 n 和最后一个 n 之间的字母数量,结果是 8,因此名称中使用了 8。创始人将名称缩短,是因为每次在终端中输入完整名称太麻烦。

触发器、节点及其之间的数据

每个工作流都从触发器节点开始。触发器决定工作流何时运行。Webhook 触发器会在 HTTP 请求到达 n8n 分配的 URL 时触发。Schedule 触发器按计划时间触发。应用触发器会在其监控的服务报告新事件时触发。没有触发器节点的工作流无法自行启动,因此只能在编辑器中点击按钮运行。

触发器之后的所有节点都是操作节点:发送消息、调用 API、读取数据库、调整字段格式,或根据条件进行分支。节点会沿着您绘制的连线从左到右运行。IF 节点会将连线拆分为两条,而 Switch 支持多个输出路由;每个输出都会沿自己的路径继续运行。

数据以项目列表的形式在节点之间传递。每个项目都是一个 JSON 对象,封装在 json 键下;如果项目包含文件,还会有一个可选的 binary 键。大多数节点会对每个项目运行一次,因此触发器传递 50 个项目时,下一个节点会执行 50 次。这是最容易让人意外的地方:一次工作流执行并不等于一次操作,而是每个项目执行一次操作。

节点使用表达式读取这些数据。表达式是写在双大括号中的一小段 JavaScript,{{ $json.email }} 表示“当前正在处理的项目的 email 字段”。在节点允许输入值的任何位置,您都可以改为输入表达式。

从开始到结束的小型工作流

下面的示例包含 3 个节点。请求到达后,一个节点处理请求,另一个节点发送消息。无需安装任何组件,您也可以了解其结构。

步骤 1。 添加一个 Webhook 节点,并将 HTTP 方法设置为 POST。n8n 会在节点面板顶部显示 2 个 URL。编辑器正在监听时,测试 URL 有效。只有发布工作流后,生产 URL 才有效。这两个 URL 有意设置为不同地址,因此未完成的工作流不会响应真实网络流量。

步骤 2。 单击“监听测试事件”,然后向该节点发送内容。将节点面板中的测试 URL 粘贴到下面的变量中。

# paste the test URL that the Webhook node shows in the editor
TEST_URL='https://n8n.example.com/webhook-test/xxxxxxxx'
curl -X POST -H 'Content-Type: application/json' \
  -d '{"name":"Ana","plan":"pro","email":"ana@example.com"}' \
  "$TEST_URL"

节点面板会填充 1 个项目,内容如下:

{
  "headers": { "content-type": "application/json" },
  "params": {},
  "query": {},
  "body": { "name": "Ana", "plan": "pro", "email": "ana@example.com" }
}

请记住这种结构。您提交的内容位于 body 下。请求头和查询字符串与它处于同一层级,不会合并到其中。第一个工作流如果读取 {{ $json.name }},会得到空值,因为该字段实际位于 {{ $json.body.name }}。

步骤 3。 添加一个 Edit Fields (Set) 节点。添加一个名为 message 的字符串字段,并将其值设置为表达式:

New signup: {{ $json.body.name }} on the {{ $json.body.plan }} plan

您输入时,面板会根据实际项目预览最终字符串。请使用此预览。路径错误会立即显示为空预览,而不是在凌晨 4 点让聊天频道收到空消息。

步骤 4。 添加发送消息的节点。可以使用已选择频道的 Slack 节点,也可以使用 HTTP Request 节点,将请求发送到聊天工具提供的 incoming webhook URL。将文本字段设置为 {{ $json.message }},即前一个节点生成的字段。

步骤 5。 单击画布标题栏中的 Publish 按钮(或按 Shift+P),然后确认。为版本命名需要 n8n Cloud Pro 或 Enterprise,或者 self-hosted Business 或 Enterprise;Community edition 不提供此功能。无需单独保存:n8n 会自动保存您的编辑,节点编辑在发布前都处于草稿状态。只有此时生产 URL 才会响应,并且它始终运行已发布的版本。因此,之后对节点的编辑不会影响生产环境,直到您再次发布。工作流设置例外:如果您只更新这些设置,n8n 会自动重新发布该版本。在发布前访问该 URL,会得到 HTTP 404,响应正文会准确说明问题,措辞仍沿用 n8n 2.0 将 Active 切换为 Publish 之前的版本:

The requested webhook "POST new-signup" is not registered.
The workflow must be active for a production URL to run successfully.

还需要注意一个差异。测试运行会在画布上实时绘制执行过程,因此您可以看到数据流动。生产运行不会这样显示。它会出现在 Overview 页面的 Executions 选项卡中,其中节点输入和输出是否保存取决于执行设置和保留限制。

自行运行 n8n

最快了解实际运行效果的方法是使用官方 Docker 镜像。以下命令来自项目 README:

docker volume create n8n_data
docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n

打开 http://localhost:5678 即可访问编辑器。需要重点关注卷配置。n8n 会将 SQLite 数据库和凭据加密密钥保存在 /home/node/.n8n 下。因此,不挂载该卷启动的容器每次都会以空环境运行;如果删除了保存凭据的卷,之后将无法再次解密这些凭据。

该命令仅用于查看效果,不适合实际运行。--rm 会在容器停止后立即删除容器,且这里没有配置 TLS(传输层安全)或重启策略。任何能够访问 5678 端口的用户都可以访问编辑器。对于公网部署,n8n 建议使用反向代理处理 HTTPS 和证书续期。在 VPS 上使用 Docker 和 HTTPS 安装 n8n详细介绍了这一过程。您也可以通过设置 N8N_PROTOCOL=https,并将 N8N_SSL_CERT 和 N8N_SSL_KEY 设置为证书文件和密钥文件,让 n8n 直接提供 HTTPS;但此时需要自行续期证书。如果您不熟悉 Compose 文件,请先阅读 VPS 上的 Docker Compose。

使用 Schedule 触发器时,几乎所有人都会遇到一个设置问题。如果设置了工作流时区,定时工作流会使用该时区;否则会使用实例时区。自行托管实例的默认时区是 America/New_York。请从第一天起就明确设置时区:n8n 的时区和计划介绍了相关变量,以及夏令时带来的问题。

何时 n8n 优于 cron 作业和 shell 脚本

通过 cron 运行的 shell 脚本更小、更快,也比任何自动化平台更容易理解。它不需要备份数据库,不需要编辑器,也不需要保护端口。如果任务只是“在 04:00 运行此命令并写入一个文件”,就应该编写脚本。n8n 在这种情况下没有优势。

在以下任一情况下,n8n 才值得使用:

  • 触发条件不是固定时间。cron 无法响应传入的 HTTP 请求,也无法检测表中出现的新行。
  • 任务需要调用多个 API,而每个 API 都有自己的身份验证、分页和速率限制。凭据存储和每个节点的重试设置可以省去其中大量重复代码。
  • 您需要了解任务的执行结果。执行数据会根据执行设置和保留限制保存,因此您可以打开一次已保存的失败执行,查看导致失败的确切数据项。cron 作业只能提供退出码,以及邮件队列中的一行信息。
  • 需要在 6 个月后由不会编写代码的人员修改流程。在节点面板中编辑一个值,远比在生产服务器上修改 shell 脚本风险更小。

这些功能有实际成本,而且成本不为零。您需要持续运行一个服务、备份一个数据库,并每隔几周执行一次升级。应将它视为您托管的其他服务,因为它本质上就是一个服务。

何时选择托管服务更合适

自行托管会占用您的精力,而精力是有限的资源。n8n Cloud 是厂商提供的托管版本,可以代为处理升级和备份,并为 Webhook 提供稳定的公网 URL,您无需拥有域名。当自动化本身比底层基础设施更重要时,应选择它。

当数据不能脱离您的控制,或者工作流需要访问托管运行器无法访问的私有网络服务时,应将 n8n 保留在自己的服务器上。成本也取决于使用量:托管方案按使用量收费,而自行托管的 Community 版本不收取 n8n 执行费用,但您仍需支付服务器托管费用,以及工作流调用的任何付费服务费用。自行托管的 Business 和 Enterprise 版本同样按执行量计费。

如果您真正想比较的是 n8n 与其他产品,n8n、Zapier 和 Make 的比较会并列说明这三种定价模式,以及每种模式的限制。如果您想了解完全不同项目中的这一思路,n8n 的自行托管替代方案是更简短的选择。

许可边界

n8n 将其模式称为 fair-code。源代码公开,您可以查看全部代码,但许可证仍会限制您可以对其进行的操作。该代码采用 Sustainable Use License 发布,其 Limitations 部分只有4句话,其中第1句起着主要作用:“您只能将本软件用于自己的内部业务,或用于非商业用途或个人用途。”您只能免费且出于非商业目的将其提供给他人,也不得删除其中的版权或许可证声明。第4句规定,任何对 n8n 商标的使用均适用相关法律。

实际而言,为您自己的公司运行 n8n 是允许的;但如果将其托管为服务,让客户自行构建或配置工作流,则需要签订商业协议。只要客户无法创建或编辑工作流,您就可以在自己的实例上为客户构建和维护自动化,并为此收费。这不符合 Open Source Initiative 对开源的定义,因为该定义明确禁止此类用途限制。SAML 单点登录可用于 Business 和 Enterprise 计划,而日志流式传输仍是 Enterprise 功能。完整区别请参阅免费 Community 版本包含和不包含的内容。

AI 功能的定位

n8n 最近受到关注,主要是因为其 AI 节点。这些节点遵循与其他节点相同的模型。AI Agent 节点将大型语言模型(LLM)作为一个子节点,并将一组工具作为其他子节点。工具本质上是模型可以调用的另一个 n8n 节点。其周围的工作流仍然是常规流程:触发器接收数据,代理决定执行什么操作,普通节点完成其余处理。在 n8n 中构建 AI 代理展示了完整的连接方式。

FAQ

如何发音 n8n?

其发音为 “n-eight-n”。这个名称是 “nodemation” 的缩写,由创始人将 “node-”(编辑器是运行在 Node.js 上的节点视图)和 “-mation”(automation,自动化)组合而成。“nodemation” 中第一个 n 和最后一个 n 之间有8个字母,因此使用数字 8;采用缩写形式,是因为在终端中输入完整名称容易变得烦琐。

n8n 可以免费使用吗?

Community 版本可在 Sustainable Use License 下免费下载和自行托管,并且 n8n 不收取按执行次数计费的费用。付费的自托管 Business 和 Enterprise 计划按执行次数定价。该许可证允许您将 n8n 用于自己的内部业务目的或个人用途,但不允许您将 n8n 托管为一项服务,让客户自行构建或配置工作流。n8n Cloud 是付费产品,Business 和 Enterprise 计划包含 SAML 单点登录。

使用 n8n 是否需要懂编码?

对于常见用法,不需要。您只需选择节点、连接节点并填写字段。重塑数据时,使用一些 JavaScript 会有所帮助,因为诸如 {{ $json.body.email }} 这样的表达式是在双大括号中的 JavaScript。当工作流需要某个节点无法提供的逻辑时,Code 节点允许您为该步骤编写 JavaScript 或 Python,并将结果交给下一个节点。

Webhook 的测试 URL 和生产 URL 有什么区别?

单击编辑器中的 “Listen for test event” 或 “Execute workflow” 时,测试 URL 会监听请求,并将结果绘制在画布上,以便您检查每个节点。只有工作流发布后,生产 URL 才会响应;它运行的是已发布版本,而不是您最近对草稿节点所做的编辑。生产工作流的运行记录会出现在 Executions 列表中,而不是画布上。仅更新工作流设置时,n8n 会自动重新发布工作流。对未发布的工作流调用生产 URL 时,会返回 HTTP 404,并提示请求的 webhook 未注册,工作流必须处于 active 状态。

n8n 是开源软件吗?

源代码是公开的,您可以自行托管,因此它属于源代码可用软件。根据 Open Source Initiative 的定义,它不是开源软件,因为 Sustainable Use License 将使用限制为内部业务、个人或非商业用途,而 OSI 批准的许可证不能限制使用领域。n8n 将这一立场称为 fair-code。

这篇文章对您有帮助吗?