【保姆级】不依赖 Docker!手把手教你用 Node.js 跑起 n8n

208 阅读5分钟

抛弃Docker!用Node.js 5分钟搞定开源工作流神器n8n的轻量部署 🚀

想要自动化工作流但又不想折腾Docker?试试这个最直接的方式。

引言:为什么选择n8n + Node.js?

如果你正在寻找一个免费、开源、功能强大的自动化工具来连接各种应用和服务,那么 n8n 绝对是你的首选。它被誉为  “开源版Zapier”  或  “更强大的IFTTT” ,拥有超过400个节点(集成),涵盖从常见SaaS(Notion、Slack、GitHub)到数据库、API甚至自定义代码的广泛连接能力。

与需要付费且数据流经第三方服务器的SaaS方案不同,n8n的核心优势在于:

  • 完全免费且开源:基于公平代码许可,可自托管
  • 数据隐私:所有数据都在你自己的服务器或电脑上运行
  • 高度可定制:可轻松创建自定义节点

虽然官方推荐Docker部署,但对于本地快速测试、开发环境、或是对容器技术不熟悉的同学,通过 Node.js 直接运行 是最简单、最轻量的方式,无需额外学习Docker,资源占用也更少。

前置准备:确保Node.js环境就绪

n8n要求 Node.js 18 或更高版本。如果你需要管理多个Node.js版本,强烈建议使用 nvm (Node Version Manager),nvm作为一个node.js的管理神器,可随时下载最新的node版本,并自由的切换,开发者们要是感兴趣还是特别推荐大家去安装的,毕竟谁不想一劳永逸呢。

1. 检查当前Node.js版本

bash

node -v

如果版本低于18,请使用nvm安装并切换:

2. 使用nvm安装Node.js 18+(如未安装),若nvm安装不顺利,也可直接去官网下载Node.js

以下是Node的官方下载地址

nodejs.org/zh-cn

bash

# 安装nvm(如果尚未安装)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 重新加载shell配置后,安装Node.js 18
nvm install 18
nvm use 18

核心步骤:安装并启动n8n

安装过程简单到只需两行命令。

1. 全局安装n8n
使用 -g(global)参数是关键,这会将 n8n 命令行工具安装到系统路径,让你可以在任何位置启动它。

bash

npm install -g n8n

2. 启动n8n服务
安装完成后,直接运行:

bash

n8n start

或直接运行

npx n8n

看到类似下面的输出,说明服务已成功启动:

text

n8n ready on http://localhost:5678

image.png

恭喜!此时n8n已经在你的本地运行起来了。

3.现在你要注册一个n8n账号,注册的过程就不演示了,E-mail大家使用QQ邮箱就行(亲测有效)

image.png

注册成功后你就可以创建属于你自己的自动化工作流了

4.点击右上角的Create workflow开始创建

image.png

避坑指南:你可能遇到的常见问题 🛠️

1. 权限问题(Permission Denied)

在Linux/macOS系统全局安装包时,可能会遇到 EACCES 错误。
解决方案

  • 推荐:使用Node版本管理器(如nvm),它管理下的npm无需sudo权限。
  • :修复npm的默认目录权限(官方指南)。

2. 端口冲突

如果本地的 5678 端口已被占用,启动时会报错。
解决方案:使用 --port 参数指定另一个端口。

bash

n8n start --port=5679

3. 如何让n8n在后台持续运行?

直接运行 n8n start 会在前台运行,关闭终端服务即停止。
解决方案:使用进程守护工具,最推荐 PM2

bash

# 1. 全局安装pm2
npm install -g pm2

# 2. 使用pm2启动n8n并命名为“n8n-workflow”
pm2 start n8n --name "n8n-workflow" -- start

# 3. 设置开机自启(可选)
pm2 startup
pm2 save

使用pm2后,你可以通过 pm2 status 查看状态,pm2 logs n8n-workflow 查看日志,服务会一直稳定运行在后台。

💡 高级技巧:快速创建临时公网地址(用于测试Webhook)

如果你需要测试需要公网回调的触发器(如GitHub Webhook),可以使用内置的隧道功能:

bash

n8n start --tunnel

启动后,命令行会显示一个临时的 *.n8n.cloud 地址,该地址会指向你的本地服务,极大方便了调试。注意:此地址为临时地址,重启即变,且所有流量公开,切勿用于生产环境。

初体验:登录并创建你的第一个工作流

  1. 打开浏览器,访问 http://localhost:5678
  2. 首次访问会进入管理员初始化页面,填写邮箱、密码、姓名等信息。
  3. 登录后,你将进入n8n的主仪表盘。
  4. 点击  “New”  按钮即可创建一个空白工作流(Workflow),通过拖拽右侧的节点(Nodes),连接它们并配置,就能构建自动化流程了。不妨从创建一个“定时发送天气到Slack”的简单工作流开始尝试!

结语

通过Node.js安装n8n,可能是体验这款强大自动化工具门槛最低的方式。它省去了容器化的复杂度,让你在几分钟内就能专注于工作流本身的设计与构建。

现在就动手,用开源的力量解放你的双手,将重复性工作自动化吧!

Have fun automating!

如果上述的内容对您正在解决的问题有帮助,就请您点个赞吧

NEXT06