常用节点说明与配置示例
在自动化平台 n8n 中，节点是实现数据处理、集成和流程控制的核心。本章将系统介绍常用核心节点的功能、配置要点和典型场景，帮助你高效构建本地自动化工作流。
文件读写节点
文件读写是本地自动化的基础。n8n 的“Read/Write Files from Disk”节点支持在本地服务器上读取和写入文件。
- 读取文件：选择“Read File”操作，指定文件完整路径。节点会将文件内容作为二进制数据输出，存储在
$binary.data字段，同时$json附带文件名、大小等元信息。支持批量读取和动态路径表达式。 - 写入文件：选择“Write File”操作，指定目标路径和文件名。可指定输入数据来源（如
$binary.data或$json.data），支持文本和二进制写入。写入成功后输出文件信息。注意：目录需提前创建，建议使用绝对路径，尤其在 Docker 环境下。
文件读写节点仅在自托管 n8n 实例可用，n8n Cloud 不支持本地文件操作。
HTTP 请求节点
HTTP Request 节点是 n8n 最通用的集成工具，支持 GET、POST、PUT、PATCH 等多种 HTTP 方法，可用于调用 REST API、发送数据、获取外部资源。
- 请求方法：下拉选择 HTTP 动词。
- URL：填写完整请求地址，支持参数化和表达式。
- 认证：可选预定义凭据或自定义 Header（如 Bearer Token）。
- Headers/Query/Body：支持多种内容类型，JSON、表单、二进制等，参数可用表达式动态生成。
- 响应解析：默认解析 JSON 响应为
$json，可选完整响应模式，支持后续节点直接处理。
HTTP 节点适用于本地 API 集成、第三方服务调用、数据抓取等场景。
条件判断与分批处理节点
自动化流程常常需要分支和循环。n8n 提供 IF 条件判断节点和 Loop Over Items（原 SplitInBatches）节点：
- IF 节点：配置条件表达式，支持多条件组合（AND/OR），根据判断结果分流数据到 true/false 分支。
- Loop Over Items 节点：按批次处理输入数据，设置 Batch Size 后可实现分页、循环等批量操作。配合 IF 节点可实现完整循环逻辑。
典型场景如批量调用 API、数据分组处理、条件分流。
代码节点
Code 节点允许在工作流中编写自定义 JavaScript 或 Python 代码，适合复杂数据处理、格式转换、算法实现等高级场景。
- JavaScript 模式：访问
items、$json等变量，支持 Node.js 内置模块和部分第三方库。 - Python 模式：通过 Pyodide 执行，适合纯 Python 算法和数据处理。
Code 节点适合无法用基础节点实现的特殊逻辑，但建议保持代码简洁，优先用可视化节点组合。
命令执行节点
Execute Command 节点可在本地服务器执行 Shell 命令，适合集成本地脚本、工具或系统命令。
- 配置命令：填写完整 shell 命令，支持参数和工作目录设置。
- 输出结果：
$json.stdout为标准输出，$json.stderr为错误输出，$json.exitCode为退出码。
仅在自托管环境可用，注意安全和权限。
其它常用节点
n8n 还内置了 Merge（合并数据流）、Set（设置/重命名字段）、Email、数据库（MySQL/Postgres）、Webhook 等节点，涵盖数据处理和集成的方方面面。所有节点均可在本地编辑器面板浏览和配置。
context7 官方文档补充
- 核心节点可作为动作或触发器，支持逻辑、调度、通用 API 调用。
- HTTP Request、Webhook、Code 节点适合后端集成和自定义处理。
- 文件读写节点参数包括文件选择器、路径、名称，推荐绝对路径。
- Loop Over Items 节点支持 context[“noItemsLeft”] 字段判断循环结束。
- 节点命名规范：触发器节点以“Trigger”结尾，普通节点不加“node”后缀。
所有节点配置和用法均可在本地编辑器 UI 直接查看，无需跳转外部文档。更多细节请参考本地文档和 localhost 编辑器帮助。
- Execute Command（执行命令）节点：这个节点允许你在工作流中执行系统命令行指令，对于集成本地程序非常有用。例如，你可以运行 Shell 脚本、调用本地的 Python 脚本、ffmpeg 转码视频等操作。配置上，主要填写 命令（Command） 字段，可以直接写入完整的 shell 命令字符串，包括参数等（例如
python /Users/me/script.py --arg1 test）。如果命令需要工作目录或环境变量，也可在 Options 中设置Working Directory和Shell等参数。执行命令节点运行后，会输出执行的结果，其中$json.stdout包含命令的标准输出文本，$json.stderr是错误输出，$json.exitCode是退出码。通常我们关心 stdout 内容，比如调用 Python 脚本 print 出 JSON，那么 stdout 即是 JSON 字符串，可在后续用 JSON 解析节点处理。注意安全：Execute Command 会在 n8n 运行主机上执行命令，一定程度有风险，因此 n8n 要求该节点默认仅在自托管环境使用（n8n Cloud 上不可用）。使用时请确保命令可信，并注意路径和权限问题。如果 n8n 以服务账号运行，可能找不到某些可执行文件（因为 PATH 不同），此时需要写命令全路径或者在启动 n8n 时配置 PATH 环境变量。
以上只是常用节点的一部分。n8n 还内置了很多其它节点，比如 Function Item（现在被 Code 节点取代）、Merge（合并数据流）、Set（设置或重命名字段）、Email、数据库节点（MySQL/Postgres）、Webhook 等，涵盖数据处理和集成的方方面面。你可以在节点添加面板的 Integrations 分类中浏览，或访问 n8n 官方文档了解每个节点的详细用法和示例。