n8n-io / n8n

n8n-io/n8n

open_in_new前往仓库

公平代码工作流自动化平台，具备原生AI能力。结合可视化构建与自定义代码，支持自托管或云部署，提供400多种集成。

项目概览

项目概述

n8n 是一个 fair-code 的 AI Agent 与工作流自动化平台，支持可视化画布结合自定义代码，可自托管或使用云服务，并连接大量外部应用。README 自称连接 1500+ 集成、提供 9000+ 工作流模板；仓库描述字段则写 400+ 集成，两者以官方文档/官网为准。名称来自 "nodemation"，读作 n-eight-n。

核心功能

  • AI 原生自动化平台：构建多步骤 AI Agent 与工作流，使用自己的数据、模型和工具。
  • 模型灵活无锁定：可接入 OpenAI、Anthropic、Google 或开源模型，切换供应商无需重构。
  • 从原型到生产：支持逻辑、工具调用、人工审批、完整可观测性。
  • 代码与可视化结合：支持 JavaScript、Python、npm 包扩展。
  • 企业就绪：自托管部署，支持基于角色的访问控制、审计日志、敏感数据处理。
  • 大量集成与模板：README 声称 1500+ 集成、9000+ 模板。
  • MCP 相关能力：仓库 topics 含 mcp、mcp-client、mcp-server。

适用与不适用场景

仓库资料未提供官方适用/不适用场景清单，以下根据 README 与仓库结构归纳。

适用场景：工作流自动化、AI Agent 编排、多系统集成、自托管自动化平台、原型快速验证、企业内部流程自动化。

不适用/注意场景：fair-code 许可不等于传统开源，商用或企业功能需注意许可范围；如果需要 OSI 认证的开源许可证，或需要不经评估直接使用全部企业功能，应另行确认。仓库资料未说明移动端、桌面端等未列明能力。

技术架构与依赖

  • 主要语言：TypeScript、Node.js。
  • 前端：Vue（editor-ui、design-system）。
  • 后端/CLI：packages/cli，包含 API 代码。
  • 数据库：SQLite 为默认，支持 PostgreSQL；通过 TypeORM 访问，schema 由 migrations 定义。
  • 包管理：pnpm workspaces 单仓库。
  • 测试：单元测试、Playwright E2E、Testcontainers。
  • 容器：官方 Docker 镜像 docker.n8n.io/n8nio/n8n。
  • 其他：仓库 topics 提到 MCP client/server、API、集成框架等。

仓库资料未提供完整依赖清单，以上仅基于仓库文档所列信息。

安装与快速开始

快速开始（需要 Node.js）：

npx n8n

Docker 部署：

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

启动后访问 http://localhost:5678。

开发环境：需要 Node.js 24+、pnpm 10.22+、corepack；执行 pnpm install、pnpm build、pnpm start。CONTRIBUTING.md 还提供了 Dev Container 和本地多配置测试方式。

典型使用方法

  • 在可视化编辑器中组合触发器、AI 节点、代码节点、应用集成节点。
  • 使用 AI Agent 结合自有数据、模型和工具，构建多步骤智能体。
  • 在流程中插入 JavaScript/Python 代码节点，并使用 npm 包扩展能力。
  • 使用 Webhook、定时调度等触发器连接外部系统。
  • 从模板库和 1500+ 集成（按 README）快速搭建工作流。

仓库内未提供更多示例代码，具体操作步骤需查阅官方文档和社区模板。

配置与部署要点

  • 自托管：可通过 npm 或 Docker 启动。
  • 数据目录：默认 ~/.n8n，可通过 N8N_USER_FOLDER 指定。
  • 数据库：默认 SQLite，生产环境可配置 PostgreSQL。
  • 部署形态：README/CONTRIBUTING 提到 Docker、队列模式、多主模式等；具体生产部署手册需参考官方文档。
  • 环境变量：仓库提供 .env.local.example 模板，可使用 dotenvx 加载。
  • 企业功能：RBAC、审计日志、syslog 等；CONTRIBUTING 明确 syslog 需要企业许可证。
  • MCP：数据库 schema 包含 mcp_registry_server 等表，说明平台具备 MCP 相关存储与能力。

限制、风险与许可证

  • 许可证：仓库元数据 license 字段为 NOASSERTION；README 说明 n8n 采用 fair-code 模式，使用 Sustainable Use License 和 n8n Enterprise License。
  • 风险：fair-code 不是 OSI 开源许可证；商用、分发或使用企业功能前需核对许可证条款。
  • 贡献限制：CONTRIBUTING 要求贡献者签署 Contributor License Agreement。
  • 其他注意：README 与描述字段中集成数量不一致（400+ 与 1500+），应以官方渠道为准。

官方链接

信息来源和分析时间

信息来源：GitHub 仓库 n8n-io/n8n 的 README、CONTRIBUTING.md、docs/db.md、docs/generated PostgreSQL schema、仓库描述字段与 latestRelease 元数据。

分析时间：2026-08-07（以仓库最新 release n8n@2.33.7 的发布时间为参考）。仓库内容可能持续变化，请以最新官方信息为准。