n8n 是什么

n8n（读作 n-eight-n，意为 nodemation：node + automation）是一个基于 fair-code 的平台，用来在可视化画布上构建并部署 AI 智能体（AI agents）与工作流自动化。你可以组合自定义代码，选择自托管或云端运行，并连接 1500+ 集成。

AiDuo123 的资讯采集、开源项目采集、每日推送等内容管线都跑在自托管 n8n 上，文中的踩坑和使用体验来自这半年多的实际使用。

它把「连 LLM、挂工具、加记忆、多模型同流程」放在同一条工作流里，也适合把定时任务、Webhook、HTTP 调用和业务系统串起来。官方还提供 n8n Academy 互动课程（练习、测验、徽章与证书，及格线 70%），适合边做边学。

n8n 官网首页

官网入口与三种用法：n8n Cloud、自托管社区版、企业版

官方文档把用法概括为两大部署路径：n8n Cloud（全托管）和 自托管（跑在你自己的基础设施上）。

用法	大致是什么	适合谁
n8n Cloud	官方托管，含管理后台、版本更新、时区/IP/数据配置、网关与 Assistant 额度	不想运维、先试用或小团队快速上线
自托管 Community	GitHub 上的标准自托管版本，免费，功能接近完整	要数据在自己机器、可接受自己维护
Business / Enterprise	付费能力（如 SSO、环境、项目等）；Business 目前仅自托管，Cloud Business 在候补名单	要合规、协作、规模化与企业功能

Cloud 套餐名称包括：免费试用、Starter、Pro、Enterprise。自托管侧则有 Community（免费）、Registered Community（免费）、Business（付费）、Enterprise（付费）。

企业级能力（如 SSO、environments、projects 等）在 Cloud 与自托管两边都有付费方案可买。GitHub 仓库统计（2026-10-05）：约 206,658 star、61,000 fork，主要语言 TypeScript；最新稳定版为 [email protected](2026-10-02 发布)。

入口可记：产品与定价看 n8n 官网定价页，文档看 docs.n8n.io，代码与 Issue 看 GitHub 上的 n8n-io/n8n。

许可证：为什么说它不是传统意义的开源

n8n 使用 Sustainable Use License 与 n8n Enterprise License，建立在 fair-code 模式上。官方明确：按 OSI 的定义，开源许可证不能限制使用方式，因此 n8n 不自称 open source。

Sustainable Use License 允许免费使用、修改、创作衍生作品与再分发，但有边界，例如：

用于内部业务，或非商业/个人用途
免费再分发仅限非商业目的
不得移除许可证声明

文件名含 .ee. 的源码适用 n8n Enterprise License；主仓库其余主要代码适用 Sustainable Use License。超出 Sustainable Use License 允许的用途，需要与 n8n 另行签订商业协议。

补充：提供商业咨询或支持服务（例如帮客户搭 n8n 工作流），按官方说明不需要再签一份单独的许可协议。

许可证密钥可在界面（Settings > Usage and plan）激活，或用环境变量 N8N_LICENSE_ACTIVATION_KEY；隔离网络可用 N8N_LICENSE_CERT。Business/Enterprise 自托管密钥需每天向许可证服务器报到以保持有效，必要时可能要放行 Cloudflare IP 段。

价格：Cloud 套餐表 + 自托管成本

计费单位是整次工作流执行（一次跑完整条流程算 1 次），不按步骤数计费。官方称这样比按步计费更易预估用量。

方案	价格	关键额度	适合谁
Cloud 免费试用	免费（无需信用卡），14 天	1000 次执行；Pro 功能 + Starter 算力；并发等见试用说明	先体验编辑器与 Pro 能力
Cloud Starter	20 美元/月（按年付费）	2.5K 次执行；5 并发；1 个共享项目；1600 Assistant 额度/月	个人/轻量自动化
Cloud Pro	50 美元/月（按年付费）	10K 次执行；并发 20 或 50；3 个共享项目；Assistant 4000 或 9600/月	小团队、要管理角色与更长历史
Business（自托管）	800 美元/月（按年付费）	40K 次执行；6 个共享项目；SSO 等	自建、要队列/Git/多环境
Enterprise	联系销售	自定义执行量；200+ 并发；无限共享项目等	强合规与治理
自托管 Community	免费	几乎完整功能集；无许可证密钥亦可运行	预算紧、能自己运维

表外补充（更细限制，仍以官网为准）：

试用：未升级则工作区会删除；试用结束后有 90 天可下载工作流。试用期间的限制:5 个并发、单次执行 180 秒超时、1 个团队项目、800 Assistant 额度 + 100 AI 额度。
Starter：最多保存执行 2.5k、存储 2.5 GB、日志保留最多 7 天、单次执行最长 5 分钟、工作流历史最多 1 天；论坛支持；含 Agents、MCP 与 AI 节点。
Pro：洞察 7 天；最多保存执行 25k、25 GB 存储、保留 30 天；单次执行最长 40 分钟；工作流历史 5 天；在 Starter 之上还有管理员角色、基于指标的评估、工作流历史等。
Business：目前仅自托管；含 SSO/SAML/LDAP、队列模式、Git 版本控制、多环境、论坛支持；超额为每额外 30 万次执行 4000 欧元。员工不足 20 人可能申请 Start-up Plan，Business 五折（资格以官方创业计划页为准）。
Enterprise：外部密钥、日志流、带 SLA 的专属支持；可 Cloud 或自托管。托管套餐数据存放在欧盟（法兰克福）服务器。
Assistant 额度：Starter 1600/月；Pro 为 4000 或 9600（随套餐规格）；试用 800；未用完不结转，可另购。自托管 Assistant 为预览版 BYOK，无额度上限。
Cloud 方案可月付或年付,年付省 17%。

n8n Cloud 价格页

用 Docker 自托管

安装路径包括：一行命令安装、Docker、Docker Compose、npm，以及 DigitalOcean、AWS、Azure、Google Cloud 等云厂商。从 n8n 3.0（2026 年 10 月发布）起只通过 Docker 分发，npm/npx 不再用于新安装。

一行命令（最快拉起）：

curl -fsSL https://get.n8n.io | sh

默认访问 http://localhost:5678，内置 SQLite，并可带可选 Assistant 沙箱服务。升级：

curl -fsSL https://get.n8n.io | sh -s -- --upgrade

停止可用 docker compose down（一行安装场景下的官方说明）。

官方 Docker run 示例：

docker volume create n8n_data

docker run -it --rm \
 --name n8n \
 -p 5678:5678 \
 -e GENERIC_TIMEZONE="<YOUR_TIMEZONE>" \
 -e TZ="<YOUR_TIMEZONE>" \
 -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
 -e N8N_RUNNERS_ENABLED=true \
 -v n8n_data:/home/node/.n8n \
 n8nio/n8n

参数怎么理解：

-p 5678:5678：把容器 5678 映射到本机，浏览器访问编辑器
GENERIC_TIMEZONE：给日程类节点正确时区
TZ：容器系统时区
N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true：强化设置文件权限
N8N_RUNNERS_ENABLED=true：启用 task runners（1.x 仍可能需要；从 2.0 起该变量已弃用，不再必须设置）
卷 n8n_data:/home/node/.n8n：持久化凭证、历史执行与工作流

GitHub README 快捷示例镜像路径为 docker.n8n.io/n8nio/n8n：

docker volume create n8n_data
docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n

默认数据库是 SQLite；也可用 PostgreSQL（DB_TYPE=postgresdb 及相关环境变量）。手写 Docker Compose 时，官方要求 Docker Compose v2，至少 4 GB RAM、2 vCPU。拉镜像：docker pull n8nio/n8n；也可指定版本（文档示例 n8nio/n8n:1.81.0）或 n8nio/n8n:next。当前稳定版为 2.41.6,测试版为 2.42.2。

生产相关提醒（自托管常见）：

队列模式（EXECUTIONS_MODE=queue）官方称扩展性最好；Community 含 queue mode，multi-main 需付费方案并设 N8N_MULTI_MAIN_SETUP_ENABLED
Code 节点建议外部 runners（n8nio/runners sidecar）；无 runners 或 internal 模式时，能改工作流的人理论上可能读到库、加密密钥、凭证与环境变量
可关遥测：N8N_DIAGNOSTICS_ENABLED=false；版本通知：N8N_VERSION_NOTIFICATIONS_ENABLED=false
彻底关闭 MCP：N8N_DISABLED_MODULES=mcp

第一个工作流怎么搭

官方入门路径很直接：打开编辑器 → 新建工作流 → 加触发器 → 加节点与凭证 → 执行 → 发布。

推荐步骤骨架（官方 “Build your first workflow”）：

新建工作流，用 Schedule Trigger 或其它触发器开头
添加业务节点（教程示例用 NASA 节点 + 凭证）
用 If 做分支，再用输出节点（教程示例为 PostBin）
点 Execute Workflow 手动跑通，再 Publish

工作流两种启动方式：

手动：编辑器里 Execute Workflow
自动：第一个节点用触发器（Webhook、定时、表单、聊天等）

凭证（Credentials） 用来保存各应用的认证信息，应只在 n8n 内使用，不要外传。参数可用表达式动态填充，例如日期：{{ $today.minus(7, 'days') }}。

自托管一行安装后，可在 http://localhost:5678 跟同一套入门。想系统学，走 n8n Academy；想马上动手，走 “Build your first workflow”。

n8n 工作流编辑器

AI Agent 与 MCP

AI 工作流：可连接 OpenAI、Anthropic、Google 等 LLM 提供商，在同一流程里加工具、记忆，并组合多个模型。n8n 实现了 LangChain 相关概念，也支持向量库、评估与官方 AI 示例。

Agent 和 Chain 的区别：

AI Agent：会决定调用哪些工具；可使用记忆，跨轮保留上下文
Basic LLM Chain：可与接入的 LLM 对话，但不支持记忆与工具

注意：Agents 功能处于 Preview，未来可能变更；官方建议避免在生产工作流里强依赖。产品里原 “AI Assistant” 已更名为 n8n Assistant（仅命名）。Cloud 上 Assistant 默认开启；自托管为预览 BYOK。从 2.7.0 起可在 Settings > AI Usage 管理 AI 使用。官方称：Assistant 可能发送工作流上下文给 LLM，但不会发送凭证字段值或实际输出数据；数据 30 天后删除，且不用于训练模型。Code 节点的 Ask AI 页签已弃用/隐藏；AI Transform 节点仍保留。

MCP（Model Context Protocol）相关能力：

能力	作用
实例级 MCP Server	Claude Desktop、Lovable 等客户端可安全连接实例，搜索/触发/创建/编辑工作流与数据表
启用位置	Settings > Instance-level MCP（owner/admin）；推荐 OAuth，也可用 API key；Server URL 以 `/mcp-server/http` 结尾
工作流准入	须显式为 MCP 开启；且为已发布、并含 webhook / form / schedule / chat 触发器
MCP Server Trigger	把单条工作流里的工具暴露出去
MCP Client Tool	工作流作为客户端调用外部 MCP 服务器
节点面板 MCP 注册表	一键把注册表中的 server 接到 agent；否则手动填 URL 与凭证
n8n Skills	n8n-io/skills 提供 13 个能力技能与参考，改善经 MCP 的工作流生成

相关功能的起始版本:经 MCP 构建/编辑工作流自 2.13.0；更丰富 MCP 设置 UI 自 2.33.0；经 MCP 使用 agents 自 2.34.0。

中文支持情况

编辑器界面是英文。官方公开材料几乎不谈完整中文 UI 或中文文档本地化；能确认的是时区（GENERIC_TIMEZONE / Cloud 后台时区）以及 Assistant 部分控件标签的本地化，不能据此理解成「全产品中文化」。

实际内容管线里：抓取中英文资讯、让大模型生成中文文章、推到中文 Telegram 与 X，没有遇到编码或乱码问题。对中文用户，主要门槛是读英文界面和英文文档，而不是「能不能处理中文数据」。

和同类怎么选：Zapier、Make、Dify 等

下面只做选型方向，不写竞品价格。竞品信息以各家官网为准。

维度	n8n	Zapier（一般特点）	Make（一般特点）	Dify（一般特点）
核心定位	可视化 + 自定义代码；AI agent 与工作流；Cloud 或自托管	面向业务人员的 SaaS 自动化与海量应用连接	以场景/模块拼装见长的自动化平台	更偏 LLM 应用编排与 AI 应用工程
部署	Cloud 全托管；Community 可免费自托管	通常以云服务为主	通常以云服务为主	常见云与可自建方案（以官网为准）
计费直觉	按整次执行，不按步数	常见按任务/步或套餐层级（以官网为准）	常见按操作次数等（以官网为准）	多与模型用量、坐席/资源相关（以官网为准）
代码与可控性	画布 + Code 节点；可接队列、Docker、自建扩展	以配置连接器为主，深度代码空间因产品而异	可视化拼装强，复杂逻辑看产品能力	强在 Prompt/Agent/知识库链路
大陆可用性	自托管可放自己基础设施；Cloud 数据在法兰克福；界面英文	视网络与账号区域而定	视网络与账号区域而定	视部署与网络而定

怎么快速拍板：

要 数据在自己机器、可改代码、按次执行好预估 → 优先看 n8n 自托管
要 少运维、官方托管 → n8n Cloud 或其它纯 SaaS 自动化
主线是 Chatbot/知识库/LLM 应用产品 而不是系统集成 → 更该对比 Dify 类工具
只要「应用 A 到应用 B」的轻量同步、且团队已习惯某 SaaS → 继续用现有 Zapier/Make 往往迁移成本更低

局限与坑

官方 issue 里的已知问题

以下摘自公开 GitHub issue，部署前建议点开看现状（是否已修复会随版本变）。

AI Agent 不把 Tool 使用写入 memory：多轮里工具调用轨迹可能进不了记忆，排障与「代理是否记得用过什么工具」会不准。#14361
HTTP Request 分页时 Bearer 认证失效：带分页的请求链可能丢认证，表现为后续页 401。#16005
Ollama 节点超过约 5 分钟时超时设置不生效：本地大模型慢请求可能被意外切断或忽略你设的超时。#25360
2.36.5 回归：Mistral Chat Model 报 Failed to parse URL from [object Request]：2.35.4 可用、之后版本报错，升级前先对 Mistral 相关流做回归。#36972
DeepSeek 响应需去掉 <think></think>：推理标签混进正文，下游解析/展示要额外清洗。#13149
Agent 下 Tool 报错直接让整单失败：错误没有回到 agent 让它改道，而是工作流失败。#24042
设置了 N8N_PATH 与 N8N_EDITOR_BASE_URL 后点文件夹 404：反代/子路径部署时前端路由易踩坑。#15240

我们自托管踩过的坑

下面这些来自内容管线半年多的实战（工作流大量经公开 REST API 创建与修改，很少纯手工点选）。

Manual Trigger 不能被 API 触发：只能编辑器里点；要脚本/其它系统拉起，改用 Webhook Trigger（设 path 后用 HTTP 调）。
HTTP Request 里手拼 JSON 字符串遇引号就坏：标题正文含 " 或 \ 时 body 非法。用 ={{ JSON.stringify({ text: $json.text }) }}，或在前置 Code 里 JSON.stringify 整包再原样交给 HTTP 节点。
别逼大模型把长文塞进 JSON：长 markdown 常带未转义换行和引号，JSON.parse 必炸。改让模型用 XML 风标签或固定分隔符（如 <content>...</content>），再用正则取出。
多上游汇合可能「某节点尚未执行」：并行多个 HTTP 再合并曾踩调度问题。可在一个 Code 节点里 await Promise.all([this.helpers.httpRequest(...), ...]) 自己并行。
凭证库挂不到 Code 节点上：密钥放凭证库，HTTP Request 挂凭证；Code 只拼 body。多阶段模型管线往往是「Code 组 body → HTTP 挂凭证」交替。
API 创建工作流时凭证参数名两套：通用凭证用 authentication: "genericCredentialType" + genericAuthType；预置服务凭证用 predefinedCredentialType + nodeCredentialType。写混了不一定配置报错，运行时才 401。
上游 0 条数据时下游整段不跑：去重查询第一次空表会返回 0 条。对该节点开 Always Output Data（alwaysOutputData: true）。
节点改名不会改表达式里的 $('旧名字')：要全局搜旧名手改，否则运行期找不到节点。
经 REST 写库时 ORM 自动字段不会自己出现：如 updated_at 需在请求体里显式带上，否则非空约束失败。
PUT 更新工作流只传必要字段：放 name、nodes、connections、settings；带上 id、active、创建时间等只读字段会被拒；更新后启用状态保持不变。
不要直接在生产流上试改：API 复制出带 Webhook 的临时流，触发后用 GET /executions?includeData=true 看每节点 IO，确认再改生产并删临时副本。
上游偶发 5xx 开 Retry On Fail：外部 API 或库的 REST 瞬时错误时，节点级重试比整条流直接挂更稳。

适合谁 / 不适合谁

适合：

要自托管、数据与密钥在自己基础设施上的团队
需要「可视化 + 代码」混合，愿意用表达式、Code 节点和 REST API 管工作流
把 LLM、工具、记忆、MCP 客户端/服务端放进同一自动化链路
执行次数可预估、希望按整次执行计费（Cloud）或 Community 免费自建
能接受英文 UI，并自己处理 Docker、备份、升级与观察性

不适合 / 需谨慎：

完全不能读英文界面和文档、又期待开箱即用中文产品体验
不能接受 fair-code 使用限制，或必须把 n8n 当「可无限制商用再分发」的传统开源来二次售卖（超出许可要另谈商业协议）
强依赖 Preview 期 Agents 做核心生产路径
只要纯聊天机器人/知识库产品形态，集成系统不是主线（更该评估 Dify 类）
无容器/运维人力，却要上高可用 multi-main、严格 SLA（应看 Enterprise 或直接用 Cloud）

常见问题 FAQ

n8n 是什么？和「AI 工作流平台」是同一回事吗？

n8n 是 fair-code 的可视化平台，用来构建并部署 AI agents 与工作流自动化，可自托管或 Cloud，并连接 1500+ 集成。它既能做经典 iPaaS 式连接，也能在同一画布接 LLM、工具与记忆，因此常被当作 AI 工作流平台来选，但定位不限于「只跑模型」。

n8n Cloud free 有什么？试用结束会怎样？

Cloud 提供 14 天免费试用,可体验 Pro 功能,无需绑定信用卡。额度包括 1000 次执行等；试用 FAQ 还列过 5 并发、180 秒超时等。未升级则工作区会删除，结束后有 90 天可下载工作流。长期免费跑完整实例，应看自托管 Community，而不是把试用当永久免费 Cloud。

n8n community edition 免费吗？缺什么？

Community 是免费自托管版，无许可证密钥即可运行，官方称几乎完整功能集。它不含自定义变量、environments、external secrets、projects、SSO、sharing、Git 版本控制、multi-main 等。邮箱注册可成 Registered Community，仍免费，并解锁 folders、debug in editor、custom execution data。

n8n docker 怎么装？3.0 后还能 npm 装吗？

现在可用官方一行脚本或 docker run/docker pull n8nio/n8n。从 n8n 3.0（2026 年 10 月） 起只通过 Docker 分发，npm/npx 不再用于新安装。Compose 手搭建议至少 4 GB RAM 与 2 vCPU。

n8n agent 和 MCP 能直接上生产吗？

MCP 实例级服务与 Client/Server 节点已可用来打通外部客户端与工具生态；工作流须发布并显式开启 MCP，触发器类型也有限制。Agents 仍为 Preview，官方建议避免在生产工作流中依赖。Assistant 在 Cloud 有月额度；自托管为 BYOK 预览、无额度上限。

n8n 中文好不好用？要不要梯子？

界面与文档以英文为主；中文数据处理在实践中可正常抓取、生成与推送。是否需要梯子取决于你访问的是 Cloud、哪些模型 API、以及你的网络环境——自托管时把实例放在自己可管控的网络，与「产品是否中文化」是两件事。

和 Zapier、Make、Dify 怎么选？

要自托管、代码扩展、按整次执行计费或 AI+自动化同栈，优先评估 n8n。要极致应用生态、团队已在某 SaaS 自动化里，继续 Zapier/Make 往往更省事。主线是 LLM 应用/知识库产品，把 Dify 类放在同一张决策表里。与其比较哪个更强,不如按部署方式、许可证、运维成本和主要场景来定。

自托管许可证和 Business 密钥要注意什么？

Business/Enterprise 自托管密钥需每天联系许可证服务器；网络策略可能要放行相关 IP。激活可走 Settings > Usage and plan 或 N8N_LICENSE_ACTIVATION_KEY。超出 Sustainable Use License 的使用方式需要单独商业协议。

本文信息核对至 2026 年 10 月(n8n 2.41)。价格与限制以官方页面为准。

n8n 是什么：价格、Docker 部署与自托管指南