n8n 安装教程

n8n 是一款开源的工作流程自动化工具，支持可视化创建复杂的工作流（类似 Zapier）。它可通过 Docker、npm 或二进制文件安装，支持本地或服务器部署。

---

安装前准备

操作系统要求：Windows 10+/macOS 10.12+/Linux（Ubuntu/CentOS 等）

硬件要求：

• 最低：1GB 内存，1GHz CPU
• 推荐：2GB+ 内存，2GHz+ CPU

网络环境：确保能访问互联网（下载依赖包）。

---

安装方式 1：使用 Docker（推荐）

安装 Docker

• Windows/macOS： 访问 Docker 官网 下载 Docker Desktop，双击安装包完成安装，启动 Docker Desktop。

• Linux（Ubuntu）：

sudo apt update
sudo apt install docker.io
sudo systemctl start docker
sudo systemctl enable docker

拉取 n8n 镜像

docker pull n8nio/n8n

运行 n8n 容器

docker run -d \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n

参数解释：

• -p 5678:5678：将容器端口映射到主机端口。
• -v ~/.n8n:/home/node/.n8n：持久化存储工作流数据。

访问 n8n Web 界面 打开浏览器访问：http://localhost:5678

---

安装方式 2：使用 npm（Node.js）

安装 Node.js 访问 Node.js 官网 下载 LTS 版本（推荐 v16.x+），安装完成后验证：

node -v
npm -v

安装 n8n

npm install n8n -g

启动 n8n

n8n

默认访问地址：http://localhost:5678

---

安装方式 3：直接下载二进制文件

适用于无法使用 Docker 或 npm 的环境。

1. 访问 n8n Releases 页面。
2. 下载对应系统的二进制文件（如 n8n-linux、n8n-win.exe）。
3. 赋予执行权限（Linux/macOS）：

chmod +x n8n-linux

1. 运行：

./n8n-linux

---

高级配置

修改默认端口

• Docker：

docker run -d -p 8080:5678 n8nio/n8n

• npm：

n8n --port 8080

启用身份验证 在启动命令中添加环境变量：

docker run -d \
  -e N8N_BASIC_AUTH_ACTIVE=true \
  -e N8N_BASIC_AUTH_USER=admin \
  -e N8N_BASIC_AUTH_PASSWORD=your_password \
  n8nio/n8n

---

常见问题

无法访问 5678 端口 检查防火墙是否放行端口，尝试 curl http://localhost:5678 验证服务是否运行。

Docker 权限问题（Linux） 将用户加入 Docker 组：

sudo usermod -aG docker $USER
newgrp docker

数据备份 Docker 数据存储在 ~/.n8n 目录，定期备份此文件夹。

---

更新与维护

Docker 更新

docker stop n8n
docker rm n8n
docker pull n8nio/n8n
docker run ...（原启动命令）

npm 更新

npm update n8n -g

按照以上步骤操作后，你已成功安装并运行 n8n！如需进一步学习如何使用工作流，可参考 n8n 官方文档。