n8n 2.43.7 介绍与选型指南
n8n 2.43.7 核心概念、内置能力实测盘点（922 节点类型/157 表）、版本运行要求、fair-code 授权边界与选型对比，附专栏阅读路线。
n8n 2.43.7 介绍与选型指南
> 目标：说清 n8n 是什么、核心概念有哪些、运行要求与授权边界是什么，并给出可落地的选型判断。文中所有版本信息、内置组件数量、命令回显均来自 n8n 2.43.7 实测环境（Ubuntu 22.04 服务器，2026-10-17 采集），未实测项会明确标注【参考】。
一、n8n 是什么
n8n（读作 "n-eight-n"，node + node 的缩写）是一个源码可得（fair-code）的工作流自动化平台：用可视化画布把"节点（Node）"连成有向图，数据在节点间以 JSON 条目（item）流转，实现系统集成、数据搬运、定时任务、Webhook 服务等自动化场景。
三个关键定位：
- 自托管优先：完整服务端跑在自己的服务器上，数据不出内网；官方云只是托管形态之一。
- 代码友好：每个节点都能切到表达式模式写 JS 片段，还有专门的 Code 节点，可以
return [{json: {...}}]自由加工数据。 - fair-code 授权：源码公开、可自由自托管，但不是 OSI 认证开源——商用再分发受 Sustainable Use License 约束（见第四节）。
二、核心概念（对照实测环境）
| 概念 | 说明 | 实测对应物 |
|---|---|---|
| Workflow 工作流 | 一张节点连线图，是最小部署/激活单元 | 数据库 workflow_entity 表，每条有 16 位 ID（如 JB97JNkL2l1EVbyu） |
| Node 节点 | 一个能力单元：触发器（trigger）或操作（action） | n8n-nodes-base.webhook、n8n-nodes-base.code、n8n-nodes-base.manualTrigger 等 |
| Credential 凭证 | 节点连接外部系统的密钥/账号，AES 加密存储 | credentials_entity 表，加密密钥在 ~/.n8n/config |
| Execution 执行 | 一次运行的完整快照（输入/输出/状态/耗时） | execution_entity + execution_data 表，API 可查 |
| Webhook | 生产 URL /webhook/<path>、测试 URL /webhook-test/<path> | 激活后 POST /webhook/echo 实测返回 200 |
| Project/变量 | 多项目协作与全局变量 | 属企业版能力，社区版 API 实测返回 403 |
一次执行的默认生命周期：触发（Webhook/定时/手动）→ 按连线逐节点执行 → 执行数据入库（可配置保留策略）→ 编辑器里可逐节点查看输入输出。
三、内置能力盘点（2.43.7 实测数字）
以下数字全部来自实测环境直接采集：
- 节点类型：核心包
n8n-nodes-base500 个节点、凭证类型 410 种；AI 包@n8n/n8n-nodes-langchain132 个节点（debug 日志Lazy-loading nodes and credentials行回显）。 - 全量节点清单：
n8n export:nodes --output=/tmp/nodes.json实测输出 922 个节点类型，文件 17.8 MB——覆盖 HTTP、各类数据库、消息队列、办公协同、AI/LLM 链等。 - 数据库规模：默认 SQLite 库启动后 157 张表（含工作流、执行、凭证、标签、项目、Agent 等域）。
- 多进程形态：
n8n --help实测给出start / worker / webhook / engine四类进程入口，支撑从单机到队列模式（queue mode）的水平扩展。 - 命令行：26 个 CLI 子命令（导入导出、执行、审计、许可等），见《n8n 2.43.7 CLI 命令详解与实测》。
- 公开 API：
/api/v1REST 接口 + Swagger 文档页（/api/v1/docs），见《n8n 2.43.7 Public API 使用指南（实测）》。
四、版本与运行要求（实测）
| 项 | 实测值 |
|---|---|
| 当前版本 | 2.43.7（npm dist-tags.latest 同为 2.43.7） |
| 运行时要求 | Node.js >= 24（npm engines 字段实测；Ubuntu 22.04 需自备 Node 24 及以上） |
| 默认监听 | 5678 端口，curl :5678/healthz → {"status":"ok"} |
| 数据目录 | ~/.n8n/：config（加密密钥）、database.sqlite（+WAL）、nodes/、storage/、n8nEventLog*.log |
| 加密密钥 | 首启自动生成并落盘 config，日志原文：No encryption key found - Auto-generating and saving to: /home/node/.n8n/config |
| 安装包体积 | 发布镜像 1.8 GB（含全部内置节点与运行时） |
授权边界（实测验证）
n8n license:info 实测回显 isValid: false、entitlements: 0——未注册许可即为社区版（Community Edition）。实测体验到的社区/企业边界：
- 变量（Variables）API 实测返回 403（企业版功能）；
- 项目/凭证的部分管理接口实测返回 403；
- 工作流、执行、标签、用户等核心 CRUD 实测全部可用（详见 API 篇实测表）。
结论：核心自动化能力在社区版完全可用，企业版主要加在 SSO/LDAP、多项目管理、变量、版本发布流（publish 流水线在 CLI/API 已出现端点）等治理能力上。
五、部署形态与选型
| 形态 | 适用 | 说明 |
|---|---|---|
| npm 全局安装 + 系统服务 | 单机、已有 Node 24 环境 | npm i -g n8n 后用 systemd 托管，见《n8n 2.43.7 运维手册：备份、升级、日志与监控》 |
| Docker Compose | 绝大多数生产单机/小集群场景 | 环境隔离、升级回滚干净，本专栏推荐，见《Ubuntu 22.04 上用 Docker Compose 部署 n8n 2.43.7》 |
| 队列模式（多进程） | 大并发执行 | start（主）+ 多个 worker --concurrency=N + 独立 webhook 进程，需外置 PostgreSQL 与 Redis 队列【队列模式为官方架构，本文仅实测了进程入口存在】 |
数据库选型：默认 SQLite 适合中小规模（实测 157 表、单文件备份简单）；执行量大/多实例时切 PostgreSQL——切换开关与实测过程见《n8n 2.43.7 配置参数详解（环境变量实测）》与部署篇。
六、横向对比（选型参考）
本节为选型判断框架，非实测跑分。
| 维度 | n8n | Zapier/Make（SaaS） | Activepieces/Windmill（开源同类） |
|---|---|---|---|
| 数据主权 | 自托管，数据不出内网 | 数据在厂商云 | 自托管 |
| 授权 | fair-code，免费自托管，企业版收费 | 订阅制按任务计费 | 开源/源码可得 |
| 扩展方式 | 自定义节点 + Code 节点 + HTTP 请求节点兜底 | 闭源应用市场 | 代码优先（TypeScript/Python） |
| 复杂逻辑 | 分支/循环/合并/错误流/子工作流完整 | 支持但颗粒度受限 | 完整 |
| 运维成本 | 需自管升级/备份/监控 | 零运维 | 需自管 |
建议选 n8n：集成点分散在内外网多个系统、需要把 AI 调用嵌进业务流、想要"可视化 + 可写代码"双模式、对数据落点有合规要求。 慎选 n8n：团队完全不想碰服务器运维、只有少量简单 SaaS 间触发（SaaS 工具更省事）、需要严格的纯 OSI 开源授权（n8n 是 fair-code）。
七、本专栏阅读路线
- 部署：《Ubuntu 22.04 上用 Docker Compose 部署 n8n 2.43.7》（唯一允许涉及编排工具的一篇）
- 配置：《n8n 2.43.7 配置参数详解（环境变量实测）》
- 命令行：《n8n 2.43.7 CLI 命令详解与实测》
- 集成开发：《n8n 2.43.7 Public API 使用指南（实测）》
- 生产化：《n8n 2.43.7 运维手册：备份、升级、日志与监控》
💡 一句话总结：n8n 是"能自托管的 Zapier + 能写代码的 IFTTT"。2.43.7 在单机 Ubuntu 22.04 上从零到可用（部署 + Owner 初始化 + 第一个 Webhook 工作流）实测 10 分钟内可完成。