## 项目概述

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 仓库：https://github.com/n8n-io/n8n
- 官方文档：https://docs.n8n.io
- 集成列表：https://n8n.io/integrations
- 工作流模板：https://n8n.io/workflows
- AI 与 LangChain 指南：https://docs.n8n.io/advanced-ai/
- 社区论坛：https://community.n8n.io
- 最新 Release：https://github.com/n8n-io/n8n/releases/tag/n8n%402.33.7

## 信息来源和分析时间

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

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