关键词速览：n8n 是一种低代码自动化工具，用于连接 API 和服务；全程围绕 n8n安装、n8n教程、workflow 三大关键词展开。

1. n8n 是什么

• 定义：n8n（发音 "n-eight-n"）是开源、基于节点流（node-flow）的低代码自动化平台，用可视化方式把 400+ 主流服务串成 workflow。
• 开源特性：源码托管于 GitHub，采用 fair-code 许可证，可自托管，也可直接使用 n8n.cloud 托管版。
• 适合人群：
• 不想写胶水代码的开发者
• 需要快速对接内部系统与 SaaS 的运维/全栈工程师
• 对自动化、爬虫、AI 感兴趣的产品、运营、数据分析师

2. 安装前准备

Docker 版 vs. 桌面版（npm）区别

• Docker：一次拉镜像、数据卷持久化、方便升级；适合服务器、NAS、CI/CD。
• npm：直接运行在宿主机，占用资源少；适合本地开发、快速体验。

3. 实际安装步骤（Docker 示例）

以下命令在 Linux / macOS / Windows-WSL 通用，演示 n8n安装 全过程。

1) 创建工作目录并拉取镜像

mkdir -p ~/n8n && cd ~/n8n
docker volume create n8n_data
docker pull docker.n8n.io/n8nio/n8n:latest

2) 启动容器

docker run -d --name n8n \
  -p 5678:5678 \
  -e TZ="Asia/Shanghai" \
  -e GENERIC_TIMEZONE="Asia/Shanghai" \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

3) 验证
浏览器访问 http://localhost:5678 出现欢迎页即安装成功。
（首次启动约 10–30 s，视机器性能而定。）

4. 创建第一个 workflow：Webhook 触发 + 邮件通知

目标：向外暴露一个 Webhook URL，POST 任意 JSON → 解析字段 → 发送邮件。

4.1 新建 workflow

1. 点击左上角 + New Workflow → 输入名称「Webhook-Mail」。
2. 保存（Ctrl+S），右上角开关保持 Inactive（先调试再激活）。

4.2 添加 Webhook 触发节点

1. 点击 + 搜索并选择 Webhook。
2. 节点默认 POST 方法，路径自动生成，例如
   http://localhost:5678/webhook/5b5fa7a3-...
   记录此地址，后续用 curl / Postman 测试。

4.3 添加 Email 节点（以 SMTP 为例）

1. 右侧 + → 搜索 Email (SMTP)。
2. 填写凭证：

• Host: smtp.163.com（示例）
• Port: 465 SSL
• User / Pass：你的邮箱账号 & 授权码

1. 参数配置：

• To: {{ $json.email }} // 引用上游 JSON 字段
• Subject: n8n 通知
• Text: 收到数据：{{ JSON.stringify($json) }}

4.4 连线 & 测试

Webhook → Email 连线完成。
点击 Execute Workflow，在另一个终端执行：

curl -X POST http://localhost:5678/webhook/5b5fa7a3-... \
  -H "Content-Type: application/json" \
  -d '{"email":"test@example.com","msg":"Hello n8n"}'

返回 {"message":"Workflow started"}，随后邮箱收到正文含 JSON 的邮件，表明 workflow 跑通。

5. 执行与调试

1. 执行日志
   底部面板 Executions 实时显示每次运行状态、耗时、节点高亮。
2. 查看变量
   点击任意节点 → JSON 标签，可看到输入/输出数据结构，方便写表达式。
3. 手动重跑
   在历史记录里点击 Retry，可复用旧参数快速重放，无需再次触发 Webhook。
4. 错误处理
   打开节点设置 → Settings → On Error → Continue / Stop / Retry，根据业务选择策略。

6. 小结与常见坑

• 数据持久化：忘记挂卷 -v n8n_data:/home/node/.n8n 会导致升级后配置丢失。
• 时区：容器与宿主机 TZ 不一致，Cron 触发会错位；务必加 -e TZ="Asia/Shanghai"。
• Webhook 外网不可达：本地测试可用 ngrok 做反向代理；生产环境请配置域名 + HTTPS。
• 邮件被拦：部分邮箱需开启「SMTP 授权码」；标题/正文勿含垃圾关键词。
• 升级：Docker 版 docker pull ... && docker restart n8n 即可；npm 版用 npm i -g n8n@latest。

FAQ

Q1. n8n 免费吗？
A：社区版完全免费且可商用；企业版提供 SSO、角色权限等高级特性，需付费授权。

Q2. 可以把 workflow 导出给别人吗？
A：可以。点击右上角 … → Download 生成 JSON 文件，对方直接 Import 即可复现相同流程（含节点配置，不含密钥）。

Q3. 支持中文界面吗？
A：截至 2025.10 官方编辑器已内置简体中文，Settings → Language 切换即可；节点名称与文档仍以英文为主。

至此，你已完成 n8n安装、首个 workflow 搭建与调试。继续探索 400+ 节点、AI 插件与模板库，把更多重复工作交给 n8n 自动化！