n8n 是什么
n8n 是面向技术团队的可自托管工作流自动化平台。它将“可视化编排”与“可写代码的灵活性”结合，帮助你把多个系统、API、数据库、脚本、AI 模型串起来，构建稳定可复用的自动化流程。
解决了哪些问题
-
系统集成与编排难
- 将 SaaS、数据库、HTTP API、消息队列等通过可视化节点连接。
- 支持条件分支、循环、并发、重试、错误处理、超时控制。
-
自动化开发成本高
- 大量内置节点（400+ 集成），无需从零写集成代码。
- 需要时可写 JavaScript/Python、自带包管理，兼顾低门槛与深度可定制。
-
AI 工作流落地复杂
- 原生支持 LLM/向量检索/代理（如基于 LangChain），易于把 AI 能力嵌入业务流程。
- 将提示工程、模型调用、工具使用、长链路执行可视化管理与监控。
-
运维与合规要求
- 可自托管，数据留在自己的基础设施，满足合规与内网/空隔场景。
- 角色权限、审计、SSO、队列/Worker/可扩展部署架构。
-
多团队协作与复用
- 工作流模板化、版本化与迁移，降低跨团队复用与交接成本。
- 结合 Webhook/定时触发/事件触发，快速对接上下游系统。
常见使用场景
- 数据集成/ETL：从 API/DB 抽取、清洗、写入到数据仓库或搜索引擎。
- SaaS 自动化：CRM、工单、监控告警、CI/CD 通知、文档/表格同步。
- AI Agent 流程：文档解析、RAG、工具调用、自动总结与工单助手。
- 营销与增长：线索分配、邮件/消息编排、用户分群与跟进。
- 内部运营/后勤：入离职自动化、审批流、资产/权限同步。
- 事件驱动后端：Webhook → 业务逻辑 → 回调/通知/落库。
为什么选 n8n
- 代码与无代码并重：拖拽式构建为主，遇到复杂逻辑可直接写代码/引入包。
- 自托管与可控性：公平许可（fair-code）、可内网部署、数据不出境。
- 生态丰富：大量官方/社区节点与模板，快速上手与扩展。
- 工程化能力：队列/Worker、重试/补偿、可观测性、与 DevOps 流程兼容。
在本机以最小步骤启动 n8n（npx 方式）
本文提供一个“纯净”的安装与启动流程：安装 Git → 安装 nvm → 用 nvm 安装 Node.js 22.16 → 用 npx 启动 n8n。并说明使用 npx 启动默认仅能通过 localhost 访问，如需通过 IP 访问需配置 HTTPS。
前置条件
- 操作系统：Linux
- 权限：具备安装软件的用户权限（建议非 root 用户）
- 网络：可访问 npm Registry（国内可考虑临时切换镜像或使用代理）
步骤一：安装 Git
# Debian/Ubuntu
sudo apt update
sudo apt install -y git
# CentOS/RHEL（如适用）
sudo yum install -y git
验证：
git --version
步骤二：安装 nvm（Node 版本管理器）
# 安装 nvm（以官方脚本为例，版本号可到官方仓库确认）
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 使当前会话生效（不同 Shell 可能略有差异）
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
验证：
nvm --version
步骤三：用 nvm 安装 Node.js 22.16
nvm install 22.16
nvm use 22.16
nvm alias default 22.16 # 可选：设为默认
验证：
node -v # 应为 v22.16.x
npm -v
步骤四：用 npx 一键启动 n8n
npx -y n8n
- 首次运行会从 npm 下载并运行 n8n。
- 默认在本机提供 Web 界面，访问地址：
可选：固定版本（示例）
npx -y n8n@latest
# 或指定某个版本
# npx -y n8n@1.58.1
关于访问方式与 HTTPS
- 使用
npx n8n的默认方式，通常仅用于本机开发与测试，浏览器访问地址为http://localhost:5678。 - 如需通过局域网或公网 IP 访问，出于安全要求，应提供 HTTPS（TLS）终端：
- 推荐将 n8n 置于反向代理（如 Nginx、Caddy、Traefik）之后，由反向代理终止 TLS，并将流量转发到本机的 5678 端口。
- 需要准备有效证书（如使用 Let’s Encrypt）。
- 完成后即可通过
https://<你的IP或域名>访问。
- 生产访问建议：
- 使用域名 + 有效证书
- 启用强制 HTTPS
- 仅在受控网络或防火墙策略下开放访问端口
