安装与配置

N8N可以通过多种方式安装，包括Docker、npm或直接下载二进制文件。Docker安装是最推荐的方式，适合大多数用户。确保系统已安装Docker和Docker Compose，运行以下命令启动容器：

docker run -d --name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n

安装完成后，访问http://localhost:5678进入Web界面。首次使用时需设置管理员凭据，建议通过环境变量配置数据库、时区等参数，例如：

docker run -d \
  -e N8N_BASIC_AUTH_ACTIVE=true \
  -e N8N_BASIC_AUTH_USER=<用户名> \
  -e N8N_BASIC_AUTH_PASSWORD=<密码> \
  -p 5678:5678 \
  n8nio/n8n

核心概念

N8N的核心是工作流（Workflow），由多个节点（Node）通过连接线组成。每个节点代表一个操作，例如HTTP请求、数据处理或第三方服务调用。节点分为触发节点（Trigger）和操作节点（Action），触发节点启动工作流，操作节点执行具体任务。

工作流支持手动触发、定时触发或Webhook触发。数据通过节点间的连接传递，每个节点的输出成为下一个节点的输入。节点配置界面通常包含参数、资源选项和执行控制。

创建第一个工作流

在Web界面点击“Workflows”->“New”创建空白工作流。从左侧面板拖拽节点到画布，例如添加“HTTP Request”节点并配置URL为https://api.github.com/users/n8n-io。连接“Start”节点到HTTP节点，点击“Execute Workflow”按钮测试。

数据流转可通过调试面板查看。HTTP节点的输出包含响应体、状态码等信息，后续节点可引用这些数据。例如使用“Function”节点编写JavaScript代码处理响应：

return {
  login: $node["HTTP Request"].json["login"],
  id: $node["HTTP Request"].json["id"]
};

常用节点功能

HTTP节点：支持GET/POST等方法，可配置Headers、Query参数和Body。适合调用REST API或作为Webhook端点。

Cron节点：定时触发工作流，表达式格式为* * * * * *（秒 分 时 日 月 周几）。

Function节点：允许编写自定义JavaScript代码处理数据。可访问上游节点的输出，例如$node["NodeName"].json。

IF节点：条件分支，通过表达式判断数据流向。表达式示例：{{ $node["PreviousNode"].json.value > 10 }}。

Error Trigger节点：捕获其他节点的错误并执行补偿逻辑，需与Error Trigger节点配对使用。

高级功能

Webhook：将工作流暴露为API端点。添加“Webhook”节点并保存工作流后，N8N会生成唯一URL。外部服务可通过POST/GET请求触发工作流。

表达式：使用双花括号{{ }}嵌入动态值。支持JSON路径（如$node["NodeA"].json["key"]）、数学运算和内置函数（如{{ $now }}）。

错误处理：节点执行失败时自动重试或转到特定分支。全局错误处理可通过“Error Trigger”节点实现。

环境变量：在设置中定义变量，工作流中通过{{ $env.VAR_NAME }}引用。适合存储API密钥等敏感信息。

部署与生产建议

生产环境建议配置持久化存储和定期备份。使用PostgreSQL替代SQLite可提升性能：

docker run -d \
  -e DB_TYPE=postgresdb \
  -e DB_POSTGRESDB_DATABASE=<数据库名> \
  -e DB_POSTGRESDB_HOST=<主机> \
  -e DB_POSTGRESDB_PORT=5432 \
  -e DB_POSTGRESDB_USER=<用户> \
  -e DB_POSTGRESDB_PASSWORD=<密码> \
  -p 5678:5678 \
  n8nio/n8n

启用HTTPS可通过反向代理（如Nginx）实现。监控方面，Prometheus指标端点默认位于/metrics，日志可通过Docker命令查看：

docker logs n8n --tail 50