n8n 实战教程
- 发行日期
- 2025/08/26
- 作者
- Jimmy Song
- 发行方
- jimmysong.io
本教程帮助你快速掌握 n8n 的自动化工作流开发，内容涵盖：
- n8n 的基本架构与核心概念
- 节点与工作流的数据流转机制
- macOS 本地安装与运行 n8n 的详细步骤（不使用 Docker）
- 环境变量与安全配置方法
- 一个完整 PDF 翻译的工作流示例
- n8n 插件与扩展机制详解
- 常见问题与最佳实践
内容摘要
- n8n 基本架构与核心概念：介绍 n8n 的节点、工作流、数据项（Item）、表达式、执行上下文等基础知识。
- 节点执行与数据传递：讲解节点的执行顺序、数据隔离、表达式引用、并行与批量处理方式。
- macOS 本地安装 n8n：提供 Homebrew 和 npm 两种安装方式，包含 Node.js 环境准备、n8n 启动与后台运行方法。
- 环境变量与配置：说明如何设置基本认证、数据存储模式、默认语言、执行数据管理等关键环境变量。
- 插件机制与扩展方式：深入了解 n8n 的插件机制和扩展方式，学习如何开发自定义节点和集成外部服务。
- 权限与路径管理：强调本地文件读写权限、n8n 进程运行用户、配置文件路径等注意事项。
章节目录
了解 n8n 的基本架构、核心概念以及工作流的基本构成。
在 macOS 上安装与运行 n8n（不使用 Docker）
了解如何在 macOS 上通过 Homebrew 或 npm 安装和运行 n8n，包括配置环境变量和权限设置。
详细介绍 n8n 的环境变量与内置变量用法，并给出“多输入合并”的正确姿势（Merge、表达式与 Code 节点）。
简要介绍 n8n 权限与路径管理，助你避免常见错误，保障数据安全与稳定运行。
深入了解 n8n Workflow 编辑器的使用方法，包括界面布局、节点操作和工作流调试技巧。
了解 n8n 中常用节点的使用方法和配置示例，包括文件读写、HTTP 请求、条件判断等节点。
Trigger 节点：定时器、Webhook、手动触发器的使用与差异
了解 n8n 中不同类型的触发节点，包括 Manual Trigger、Schedule Trigger 和 Webhook Trigger 的使用方法和区别。
深入了解 n8n 的插件机制和扩展方式，学习如何开发自定义节点和集成外部服务。
Code 与 Execute Command 节点：原理、对比与最佳实践
比较并介绍 n8n 中的 Code 与 Execute Command 节点的原理、适用场景、限制与实践建议。
如何集成本地程序：使用 Execute Command 节点
学习如何使用 Execute Command 节点将本地脚本和程序集成到 n8n 工作流中。
如何调用大模型：通过 HTTP Request 节点调用 Gemini 或 OpenAI API
了解如何通过 HTTP Request 节点调用大语言模型 API，如 OpenAI 或 Google Gemini，并处理返回的 JSON 数据。
实用集成案例：以 Google Sheets、Google Drive、Gmail 为例调用服务
学习如何集成 Google 服务到 n8n 工作流中，包括 Google Sheets、Google Drive 和 Gmail 的使用方法。
实战示例：将英文 PDF 文档转换为 Markdown 并翻译为中文，最后输出为 PDF
通过一个完整的实战示例，学习如何使用 n8n 将英文 PDF 转换为 Markdown，调用大语言模型翻译，再生成中文 PDF。
了解 n8n 使用过程中可能遇到的常见问题及其解决方法，掌握调试工作流的技巧。