n8n 全维度使用指南

n8n 是一个开源可视化 + 代码双模式 AI 工作流自动化平台，对标 Zapier/Make。它主打可私有化部署、全应用互联以及 AI Agent 自定义搭建。平台在 GitHub 拥有 190.1k+ 星标，全球 20 万 + 社区用户，企业客户包括微软、沃达丰、SEAT 等。

01. 核心功能

1. 可视化低代码自动化（基础核心）

1. 拖拽式节点编排：提供 500+ 预制应用节点，开箱接入飞书/钉钉、Google 套件、Slack、各类数据库（MySQL/PG）、ERP、爬虫及网盘等，无需自研 API 对接。
2. 双模式开发：

• 小白模式：拖拽搭流程。
• 开发者模式：插入 JS/Python 自定义代码节点，自由扩展非标逻辑，兼顾低代码易用与代码灵活度。

1. 多触发方式：支持定时 Cron、Webhook、表单触发、消息触发、API 回调，满足定时报表、实时数据同步等场景。

2. AI 原生能力（平台主打亮点）

1. 可视化搭建 AI Agent：接入 OpenAI/Claude/Mistral 或本地大模型，全链路可视化追踪 AI 推理步骤。支持 RAG 知识库、多智能体协作、工具调用 Agent。
2. AI 工作流治理：支持人工介入审批（Human-in-the-loop）、输出格式约束、AI 结果自动校验纠错、模型记忆配置，管控 AI 执行边界，满足企业合规要求。
3. 自然语言生成工作流：输入需求描述自动生成流程草稿，一键微调落地自动化任务。

3. 四大业务落地场景能力

1. IT 运维：新员工入职自动化、安全漏洞扫描 + 工单自动创建、故障告警流转（沃达丰用其做 SOAR 安全自动化，年节省 220 万英镑成本）。
2. DevOps：自然语言转 API 请求、版本更新自动化测试、发布失败自动回滚 + 通知运维。
3. 销售/运营：爬取评论→AI 生成客户洞察→自动汇总表格、订单跨系统同步（电商 ERP+ 物流 + 财务）。
4. 数据自动化：跨库数据同步、定时爬虫、数据清洗、报表自动推送。

4. 企业级管控功能

• 提供审计日志、RBAC 权限、SSO/SAML/LDAP 单点登录、密钥加密存储。
• 支持 Git 版本管理、多环境隔离、工作流历史回溯、运行监控告警。

02. 适用人群与场景

1. 个人/自由职业（零基础~轻度技术）

• 自媒体：内容采集、关键词监控、稿件分发自动化。
• 办公人：自动汇总表格、邮件分类归档、日程同步、消息提醒。

2. 中小企业（运营/销售/IT/产品）

• 运营：表单数据自动入库、社媒消息汇总、活动数据自动报表。
• IT：内部系统打通、运维告警自动化、低成本替代昂贵 RPA 工具。
• 跨境电商：Shopify 订单→ERP→物流全链路自动流转。

3. 技术团队/大型企业（开发/安全/数据）

• 研发：DevOps 流水线、内部 API 网关、私有 RAG 系统搭建。
• 安全团队：威胁情报自动化、恶意链接扫描工单（沃达丰落地案例）。
• 合规行业（金融/医疗）：私有化部署，数据不出内网满足 GDPR、SOC 合规要求。

不适合人群：只需要超简单单步自动化（1 个软件内操作，Zapier 免费版即可）、完全零运维不想碰服务器（优先官方云版）。

03. 免费与付费方案

n8n 提供两种使用形态：自托管本地部署（开源社区版）与 n8n Cloud 官方云端。

1. 自托管（本地/服务器/Docker 部署，开源社区版）

1. 费用：永久免费。核心全功能无执行次数限制，支持完整源码（GitHub 开源）。
2. 权益：全量节点、无工作流数量上限、无限次运行、单用户使用、基础日志调试。
3. 限制：无企业功能（如多用户协作、SSO 单点、RBAC 权限、官方技术支持、审计日志、SLA 保障）。
4. 企业升级：可购买企业商业授权（Enterprise），按需报价，解锁团队协作、合规管控、原厂售后。

2. n8n Cloud（官方 SaaS 云端，注册即用）

• 免费试用版价格：0 元
• 额度：每月 200 次工作流执行，单用户，节点全量，14 天全功能试用，超量停机。
• Starter 入门版价格：约 20 美元/月
• 权益：5000 次/月执行、5 并发任务、少量团队成员、基础 AI 生成。
• Pro 专业版价格：约 50 美元/月
• 权益：无限执行、高并发、完整 AI Workflow、多用户协作、工单支持。
• Enterprise 企业版价格：定制报价
• 权益：私有化云部署、专属售后、SLA、SSO、全合规能力。

注意：额外成本。AI 大模型 API（OpenAI/Claude 等）密钥需自费，n8n 只做流程调度，不收取模型费用。

04. 三种使用方式

方式 1：云端试用（最快上手，5 分钟启动）

1. 打开 n8n.io 注册账号。
2. 免费额度直接创建工作流，拖拽节点、授权第三方应用（如谷歌/飞书等）。
3. 调试运行，用完免费额度按需升级付费套餐。

方式 2：本地 Docker 部署（免费自用，数据本地保存，推荐个人）

1. 安装 Docker 环境。
2. 执行一键启动命令：
3. shell

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

1. 浏览器打开 localhost:5678 进入后台，完全免费无次数限制。

方式 3：服务器私有化部署（企业/重度用户）

1. 在云服务器（阿里云/腾讯云/海外 VPS）安装 Docker 或 Node。
2. 配置域名 +HTTPS 反向代理（宝塔/Nginx），实现外网访问。
3. 自托管社区版免费，多人协作需采购企业授权。

通用入门步骤（新建工作流）

1. Create Workflow：新建流程。
2. 选择触发节点：左侧拖拽触发节点（定时/Webhook）作为流程起点。
3. 串联操作节点：串联读表格/发消息/调用 AI，配置 API 授权。
4. 调试与查看：右侧 Output 查看每步返回数据，调试报错。
5. 激活运行：开启激活状态，定时/Webhook 自动运行流程。

05. 高频避坑指南

1. 部署相关坑

1. 端口占用：默认 5678 端口被占用→需在 Docker 中改端口，如-p 8080:5678。
2. 公网 Webhook 失效：第三方服务（谷歌/Slack）强制 HTTPS，自托管必须配置域名+SSL 证书，裸 IP 无法完成 OAuth 授权。
3. 服务器资源不足：大批量工作流并发报错→需升级服务器 CPU/内存，或拆分多实例部署。

2. 节点与授权坑

1. 第三方授权失败：API 密钥不要手动输入，应在节点内点 Authenticate 跳转官方授权；Slack 事件订阅需开启 n8n 监听再填 URL 握手，否则收不到消息触发。
2. 数据格式报错：不同节点返回 JSON 结构不一致→应用 Set 节点格式化数据，借助{{$json.字段名}}表达式取值，在 Output 面板实时查看原始数据。
3. AI 调用报错：大模型密钥填错/余额不足→需单独测试 AI 节点，核对 API 地址与 Key，区分本地模型/云端 API。

3. 运行与计费坑

1. Cloud 免费版超额停机：云端免费 200 次/月用完直接停止运行，重要自动化不建议依赖免费额度。
2. 定时 Cron 时区错误：默认 UTC 时区，国内需手动改成 Asia/Shanghai，否则定时任务时差 8 小时。
3. 自托管误开付费功能：社区版强行启用 SSO/多用户会报错，企业功能必须采购商业授权。

4. 流程设计坑

• 复杂流程拆分：别全堆在一个工作流，拆分模块化子流程。
• 逻辑复用：频繁复用的逻辑保存为模板，减少后期修改成本。

06. 补充优势小结

• 对比 Zapier：自托管免费无执行上限、可自定义代码、数据自留、合规友好。
• 主要缺点：自托管需要基础运维能力。
• 建议：零基础短期优先使用 Cloud 试用版；有一定技术基础或关注数据隐私的企业，可选择本地部署。