n8n可以运行在树莓派上了！

最近n8n官方给出了在树莓派上运行n8n的方法

我今天就我在树莓派上成功部署了n8n，一款便携式AI工具流硬件就此诞生！

今天分享这个实践过程。

为什么选择树莓派？

相比传统方案，树莓派部署具有以下特征：

成本维度：硬件一次性投入约800元，无云服务月费

功耗与空间：功耗5W左右，体积仅为信用卡大小

平台扩展性：树莓派本身支持IoT开发，可与传感器、执行器直接集成

使用门槛：无需Docker知识，直接基于系统级部署

部署教程

第一步：创建独立用户

树莓派系统默认包含pi用户，但为了权限隔离和便于管理，建议为n8n创建独立账户。执行以下命令：

sudo adduser --system --group --home /home/node node
sudo usermod -s /bin/bash node

第二步：系统更新

在安装前更新系统软件包至最新版本，避免依赖冲突导致安装失败：

sudo apt update && sudo apt upgrade -y

更新耗时通常在15-20分钟。如系统镜像较旧，可能需要更长时间。

第三步：安装Node.js 20.x

n8n基于Node.js运行。树莓派官方镜像预装的Node.js版本较旧，需先卸载后重装。

删除旧版本：

sudo apt remove -y nodejs
sudo apt purge -y nodejs

安装Node.js 20.x：

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs=20.19.0-1nodesource1

验证安装：

node -v
# 输出：v20.19.0
npm -v
# 输出：10.8.2

第四步：安装n8n

通过npm全局安装n8n：

sudo npm install -g n8n
n8n --version

性能差异说明：在树莓派3上此步骤耗时约1小时（ARM架构较旧），树莓派4/5则需10-15分钟。

安装过程中会出现多个警告提示（warn），可直接忽略，不影响最终功能。

第五步：安装SQLite3数据库

n8n工作流、用户配置等数据存储于SQLite3。树莓派官方镜像默认未预装，需手动安装：

sudo npm install -g sqlite3

验证安装状态：

npm list -g sqlite3

第六步：配置系统服务

通过systemd服务实现开机自启和后台运行，避免每次手动启动。

创建服务文件：

sudo nano /etc/systemd/system/n8n.service

配置内容如下：

[Unit]
Description=n8n Automation Tool
After=network.target

[Service]
ExecStart=/usr/bin/n8n
Restart=always
User=node
Environment=PATH=/usr/bin:/usr/local/bin
Environment=NODE_ENV=production
WorkingDirectory=/home/node/
Environment=N8N_BASIC_AUTH_ACTIVE=false
Environment=N8N_HOST=<树莓派IP或域名>
Environment=N8N_PORT=5678
Environment=N8N_PROTOCOL=http
Environment=N8N_SECURE_COOKIE=false

[Install]
WantedBy=multi-user.target

配置参数说明：

• N8N_PROTOCOL=http：使用HTTP协议（局域网环境）
• N8N_BASIC_AUTH_ACTIVE=false：禁用基础认证（可根据需求启用）
• N8N_SECURE_COOKIE=false：适配HTTP环境下的Cookie处理

注：若需HTTPS访问，需配置SSL证书，配置复杂度相对较高，此处采用HTTP方案。

激活服务：

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

访问n8n

在浏览器中输入以下地址即可访问：

http://<树莓派IP地址>:5678

例如：http://192.168.1.100:5678

就此你就获得了一个树莓派部署的n8n，不仅在成本低，更在于n8n从此它便携了！

你可以用来：

• 本地化运算：工作流完全在本地执行，数据不上云，符合隐私保护需求
• IoT集成：可直接集成传感器和硬件设备，支持复杂的自动化场景
• 运维成本：一次硬件投入，零月度成本，适合长期稳定运行的流程

接下来我将会把大部分工作流从云服务迁移至本地树莓派，希望能扛住我的日常运行需求。

如你也有类似需求，这套方案值得尝试。

官方链接：https://bdking71.wordpress.com/2025/11/17/instructions-n8n-on-raspberry-pi/