n8n热门的开源 AI 工作流平台实操

n8n 是当前非常热门的开源 AI 工作流平台，在 GitHub 上已获得超过九万颗 star,以下是基于 Node.js 环境部署 n8n 的详细实操步骤，结合多个可靠来源整理而成：

---

🔧 1. 环境准备（Node.js 安装）

• 版本要求：n8n 需 Node.js ≥20.19（推荐 LTS 版本如 22.x）。
• 安装步骤：
  1. 访问 Node.js 官网，下载 LTS 版本安装包。
  2. 运行安装程序，按提示完成安装（Windows 用户需注意勾选 Add to PATH）。
  3. 验证安装：

     node -v  # 输出版本号（如 v22.16.0）
     npm -v   # 输出 npm 版本（如 10.8.0）
     

---

⚙️ 2. 安装 n8n

方式一：全局安装（推荐长期使用）

npm install -g n8n@latest  # 全局安装最新稳定版

• 验证安装：n8n --version 输出版本号即成功。

方式二：npx 临时启动（适合快速测试）

npx n8n  # 自动下载并启动，关闭终端后服务停止

---

🚀 3. 启动 n8n 服务

• 基础启动：

  n8n  # 默认端口 5678
  

• 自定义端口（可选）：

  n8n --port=8080  # 指定端口
  

• 访问 Web 界面：浏览器打开 http://localhost:5678（或自定义端口）。

---

⚠️ 4. 初始配置

1. 首次访问需填写邮箱、姓名、密码创建管理员账户。
2. 跳过引导页，点击 “Get Started” 或 “Skip” 进入主界面。

---

🔒 5. 生产环境优化

作为系统服务运行（确保后台持续运行）

• Linux（systemd）：

  1. 创建服务文件 /etc/systemd/system/n8n.service：

     [Unit]
     Description=n8n Automation Service
     After=network.target
     [Service]
     User=your_username
     ExecStart=/usr/bin/n8n
     Restart=on-failure
     [Install]
     WantedBy=multi-user.target
     

  2. 启用服务：

     sudo systemctl daemon-reload
     sudo systemctl enable n8n
     sudo systemctl start n8n
     

  3. 检查状态：sudo systemctl status n8n。

• Windows（nssm 或 pm2）：

  • nssm：注册为系统服务（参考教程）。
  • pm2（推荐）：

    npm install -g pm2
    pm2 start n8n --name "n8n-server"
    pm2 save
    pm2 startup  # 设置开机自启
    

---

❗ 关键注意事项

1. 版本兼容性：若启动报错 Node.js version X.X.X not supported，需升级 Node.js 至 ≥20.19。
2. 数据持久化：
   • 默认使用 SQLite 存储数据（路径：~/.n8n）。
   • 可迁移至 PostgreSQL（通过环境变量配置）。
3. 协议限制：n8n 开源版禁止对外提供商业服务，仅限内部或个人使用。
4. 安全配置：生产环境建议启用 HTTPS 并设置 N8N_SECURE_COOKIE=true。

---

✅ 部署完成验证

• 访问 http://localhost:5678，登录后可见工作流编辑界面。
• 创建测试工作流（如添加手动触发节点并测试），确认功能正常。

提示：更多进阶配置（如数据库迁移、插件安装）可参考 n8n 官方文档。