首页开源项目论文解读归档收藏关于译匠
首页/ 开源项目/ n8n 体检报告

n8n 技术体检报告

n8n-io/n8n

⚠️ 有条件推荐

自建内部自动化的强选项:极活跃、集成面广;但协议不是开源许可——内部用没问题,对外分发或托管即踩线。

适合谁

  • 要求数据不出内网的自托管流程自动化团队
  • 需要把 LLM 节点嵌进可视化工作流的 Agent 场景(1500+ 集成)
  • 有 Docker 运维能力、能跟紧升级节奏的团队

不要用,如果要

  • 想把 n8n 本身作为产品对外销售或提供托管服务(协议明确禁止,见 T1)
  • 法务要求全部依赖为 OSI 认证开源协议
  • 无人力跟进安全升级——项目 high 级安全公告历史多(见 T2)
❓ 高危 CVE:未定性(存在 6 条 high 级 GHSA 历史公告(E1),但接口未给出『当前版本是否已修复』字段,需对照版本号逐条核对后才能定性)

体检卡

成熟度权重 25

90 分 · 最后一次推送 2026-10-30(当天),stable/[email protected] 等多条 release 同日发布,209,152 star

上手成本权重 20

70 分 · README 提供 Docker 一行命令启动(映射 5678 端口 + 数据卷),上手路径清晰

运行成本权重 20

— 分 · 未评估 · 缺证据:未实测:空载内存、并发工作流的资源占用缺数据

锁定风险权重 15

45 分 · Sustainable Use License 限制对外分发与商用托管(E1);工作流 JSON 可导出但平台节点语义迁移成本高(推断 E3)

生产就绪权重 10

60 分 · 安全公告库中有 6 条 high、24 条 medium(E1),发版极快但自托管方必须跟紧升级

生态权重 10

90 分 · README 载明 1500+ 集成、20.9 万 star、官方社区与付费云版并存

加权总分 72.8 / 100(仅已评维度参与,已评权重 80;公式:(90×25+70×20+45×15+60×10+90×10) ÷ 80)。未评估维度不记 0 分,也不参与计算。

#红线类型级别判定说明来源
R1协议不可商用禁止级未命中LICENSE 允许「internal business purposes」——内部商用不禁止;禁止的是对外收费分发/托管(详见陷阱 T1)。不构成本项目定义的禁止级红线原文
R2协议不明警示级未命中GitHub 字段 NOASSERTION,但已人工打开 LICENSE.md 定性为 Sustainable Use License(非 OSI 标准协议)原文
R3已停更禁止级未命中最后一次推送 2026-10-30T23:55:29Z,距今 0 天原文
R4高危 CVE禁止级未定性存在 6 条 high 级 GHSA 历史公告(E1),但接口未给出『当前版本是否已修复』字段,需对照版本号逐条核对后才能定性—

解剖:它到底怎么工作

节点式(node-based)工作流平台:工作流以 JSON 定义,节点间传递结构化数据,内置触发器、Webhook 与 AI/Agent 节点;自托管与官方云两种形态。

核心机制

可视化画布编排节点图,每个节点封装一个集成(API/DB/模型调用);执行引擎按图拓扑调度并保存每次运行的输入输出。

AI 能力以内置节点形式接入(README 载明 Combine visual building with JavaScript, Python, and npm packages)。

扩展点

自定义节点以 npm 包形式分发(README/官方文档载明,细节待核实——推断 E3)。

凭据管理、Webhook 入口、外部模型接入为标准扩展面。

未评估

队列模式与水平扩展、执行历史保留策略、权限模型——需读官方文档或实测。

避坑指南

每条陷阱都有可点击来源(E1);没有来源的「坑」不写。本报告共 3 条。

高 对外分发或托管服务违反协议

你会看到:把 n8n 打包进商业产品、或向客户收费提供 n8n 托管后,收到合规质询或法务函。

根因:LICENSE 原文 Limitations 条款:「You may use or modify the software only for your own internal business purposes…You may distribute the software or provide it to others only if you do so free of charge for non-commercial purposes.」

缓解:内部流程自动化可直接用;对外产品化需购买 Enterprise License 或改用 MIT/Apache 协议的工作流引擎。

证据 E1 · https://github.com/n8n-io/n8n/blob/master/LICENSE.md

高 自托管实例安全公告密集,升级必须常态化

你会看到:公网暴露的 n8n 实例被扫到已知漏洞;旧版本实例在 GHSA 中能对上号。

根因:security-advisories 接口列出 30 条已发布公告,其中 6 条 severity=high(含 GHSA-9p7v-45m2-wxgj 等)。

缓解:订阅 release 通知固定升级节奏;实例置于反向代理 + 访问白名单之后,不裸暴露公网;升级前对照 GHSA 列表核对本版本。

证据 E1 · https://api.github.com/repos/n8n-io/n8n/security-advisories

中 .ee. 文件属 Enterprise License,源码混用踩线

你会看到:从源码构建或二次开发时,把带 .ee. 文件名/目录的代码编进了自己的分支,触发许可违约。

根因:LICENSE 原文:文件名含 .ee. 或目录含 .ee 的源码不在 Sustainable Use License 覆盖内,需有效 Enterprise License;且 master 以外的分支内容不受许可。

缓解:二次开发只基于 main 分支,CI 加一条路径扫描规则拦截 .ee. 文件进入自有产物。

证据 E1 · https://github.com/n8n-io/n8n/blob/master/LICENSE.md

成本账

上手时间未评估(未实测:未部署真实实例,无法给出内存与起步耗时)
算力Docker 单容器可起步;生产级建议独立数据库(推断 E3,未实测)
钱自托管无许可费;云版与 Enterprise License 另计(官方定价页未核)
长期维护必须常态化跟进升级与安全公告(见 T2)

替代方案

候选为什么可能不选它
ActivepiecesMIT 协议更干净,但集成数量与社区规模小于 n8n(推断 E3,未收录未对比)
Dify更偏 LLM 应用编排,通用流程自动化(ERP/邮件/DB 类节点)不如 n8n(推断 E3)
Windmill代码优先,适合工程团队,但可视化编排弱于 n8n(推断 E3)

证据链

展开全部 5 条证据(断言 → 来源 → 等级)
#断言等级来源
E1star = 209,152;pushed_at = 2026-10-30T23:55:29Z;license 字段 = NOASSERTIONE1https://api.github.com/repos/n8n-io/n8n
E2同日多条 release:stable、[email protected]、[email protected]、[email protected]、beta(2026-10-30)E1https://api.github.com/repos/n8n-io/n8n/releases
E3LICENSE.md:Sustainable Use License——仅限 internal business purposes / 非商用;分发仅限免费非商用;.ee. 文件需 Enterprise LicenseE1https://github.com/n8n-io/n8n/blob/master/LICENSE.md
E4README:Fair-code platform…self-hosted or cloud…1500+ integrations;Docker 一行命令启动(端口 5678)E1https://github.com/n8n-io/n8n#readme
E5security-advisories 共 30 条:6 条 high(GHSA-9p7v-45m2-wxgj、GHSA-f2cw-9483-7vcp 等)、24 条 mediumE1https://api.github.com/repos/n8n-io/n8n/security-advisories
复核人译匠(具名编辑,译匠)
复核日期2026-10-31
报告版本v1.0

本报告由 AI 采集与起草、具名编辑逐条核对证据后定稿;判定规则与评分权重全部公开。 本报告只评价代码、模型、文档与协议等可验证对象,不评价任何团队的动机或人品。 内容不构成法律、安全或商业建议——协议以仓库 LICENSE 原文为准,安全以官方公告为准。 发现错误请通过站内纠错页提交(记录可查、结果公示),修订记录只增不删。