Linux本地安装N8N全攻略 (小白避坑指南)

准备工作

首先，确保你的Linux系统（以Ubuntu 20.04为例）已经安装了Node.js和npm。N8N是基于Node.js开发的，所以这是必须的。可以通过以下命令检查：

node -vnpm -v

如果没有安装，可以使用包管理器安装：

sudo apt updatesudo apt install nodejs npm -y

或者使用NodeSource源安装较新版本。

安装N8N

使用npm全局安装N8N：

sudo npm install n8n -g

等待安装完成。这个过程可能需要几分钟，取决于网络速度。

启动N8N

安装成功后，可以直接在终端启动：

n8n start

默认情况下，N8N会监听5678端口，打开浏览器访问 http://localhost:5678 即可看到界面。

常见问题与解决

• 端口占用：如果5678端口被占用，可以通过 --port 参数指定其他端口，如 n8n start --port=8080。
• 权限错误：全局安装时使用sudo，但运行时不建议用sudo，可以修改npm权限或使用nvm管理Node.js。
• 依赖缺失：某些Linux发行版可能缺少构建工具，运行 sudo apt install build-essential 安装。
• 后台运行：希望N8N在后台持续运行，可以使用PM2或systemd。例如创建systemd服务：sudo nano /etc/systemd/system/n8n.service，然后添加配置...

配置为系统服务（可选）

为了让N8N开机自启，可以创建systemd服务。新建服务文件：

[Unit]Description=n8n workflow automationAfter=network.target[Service]Type=simpleUser=你的用户名ExecStart=/usr/bin/n8n startRestart=on-failure[Install]WantedBy=multi-user.target

然后启用并启动：sudo systemctl enable n8n && sudo systemctl start n8n。

至此，你已经成功在Linux上安装了N8N，并解决了常见问题。现在可以开始创建你的第一个自动化工作流了！

关键词：N8N, Linux安装, 自动化工作流, Node.js