n8n教程新手入门第一课：n8n安装下载教程（含Mac + Windows）

作者： Dr.n8n 更新时间：2025-10-16 18:45:53 分类：n8n教程

无论你是刚听说 n8n、想试着做点自动化，还是已经被各种重复任务折磨够了，这一课会带你从零开始——搞定安装和运行。 n8n教程新手入门第一课：n8n安装下载教程（含Mac + Windows）

n8n 是一款开源的自动化工具，可以把不同的应用、API、甚至你自己的脚本连起来，让它们自动协作。它像是一块“无代码”拼图板，你只需要拖拽节点，就能搭出自己的工作流。

这篇入门教程不会跳步骤，也不会假设你已经是程序员。我们会一起完成最关键的第一步：

了解 n8n 是什么
在 Mac 或 Windows 上安装它
成功运行第一个本地版本

等到最后，你就能打开浏览器、看到属于自己的 n8n 控制台，为后面的自动化课程打下基础。

n8n 是什么

如果要用一句话来形容 n8n，它是一款“开源、可私有化部署的低代码自动化工具”。更白话一点，就是：你可以用它把不同网站、应用、API 甚至自己写的小脚本串起来，让它们在后台自动干活。

在这个教程里，我们把这种事情叫做“魔法”。
原因很简单：

它的确能创造出一点“看不懂但好用”的效果；
它不追求大规模、企业级的稳定，而更像是一座由你亲手搭建的 移动城堡；
它让非程序员也能掌控复杂系统间的流动，把琐碎任务变成自动化流程。

n8n 的全名来自 “nodemation”（node + automation），意思是“节点式自动化”。
在它的界面里，你只需拖拽节点、配置触发条件，就能完成原本需要写很多代码的事情——比如：

每天定时把表格数据同步到 Notion；
当你发布一篇新文章时自动发推；
从邮箱里提取附件并分类保存到云盘。

对新手来说，它既是工具，也是入口。通过学习 n8n，你会慢慢理解自动化背后的逻辑，明白“程序”其实不过是一种表达方式。

这一课，我们从这里出发。

n8n 能做什么

如果把 n8n 比作一座工坊，那它能做的事，取决于你想造什么。
有人用它打理内容分发：

新文章一发布，就自动同步到微信公众号、X（Twitter）和 Telegram。

有人拿它做数据整理：

每天凌晨从多个 API 拉取数据，清洗后写进 Google Sheets 或数据库。

也有人让它做私人助理：

当邮件里出现特定关键词时自动提醒；
定期把待办任务转存到笔记工具里。

它并不是万能的，
但在重复、琐碎、逻辑清晰的任务上，它几乎是最轻量的方案。

n8n 支持上百种内置节点（如 Slack、GitHub、OpenAI、Notion、Google Sheets 等），
也可以直接调用 HTTP 接口来连接其他任何服务。
更妙的是——你可以在自己电脑、服务器甚至树莓派上部署它，
完全掌控数据和隐私。

换句话说：
n8n 既能帮你省时间，也能让你重新定义工作方式。

Mac OS 下的 n8n安装教程（苹果Arm芯片）

在 Mac 上安装 n8n 的方式主要有两种：
一种适合想深入研究、调试或二次开发的人；
另一种更适合想稳定运行、少折腾的使用者。

🧩 方案一：直接安装（Node.js 方式）

这一方案更贴近开发者逻辑，安装灵活，可随时修改源码或插件。

1. 安装 Node.js

推荐用 nvm 管理 Node 版本，方便切换。
在终端执行：

然后编辑 ~/.zshrc，加入以下内容：

保存后执行：

2. 安装 n8n

3. 启动 n8n

浏览器中访问 👉 http://localhost:5678
即可看到你的 n8n 控制台界面。

🐳 方案二：Docker 安装（更稳定、易更新）

这一方案更适合长期运行或服务器部署，尤其当你希望保持环境干净。

1. 安装 Docker Desktop（支持 Apple Silicon）

前往官网下载安装：
👉 https://www.docker.com/products/docker-desktop/

2. 拉取并运行 n8n 镜像

其中 ~/.n8n 是你的数据目录，里面会保存所有工作流和配置。

3. 打开浏览器访问

👉 http://localhost:5678

到这里，你的 n8n 就已经在苹果芯片的 Mac 上顺利运行起来了。

Mac OS 下的 n8n安装教程（英特尔芯片）

Intel 芯片的 Mac（uname -m 显示 x86_64）装 n8n 有两条主路：

想调试/二开：Node.js 直装
想稳定省心：Docker 运行

小提示：不确定是不是 Intel？在终端输入 uname -m，x86_64 就是 Intel，arm64 就是苹果芯片。

🧩 方案一：直接安装（Node.js 方式）

适合要看日志、改节点、连本地脚本的人。

1）准备 Node.js（用 nvm 管理版本）

Intel Mac 上 Homebrew 默认在 /usr/local，直接：

# 装 nvm brew install nvm mkdir -p ~/.nvm

把下面这段加到 ~/.zshrc（或 ~/.bashrc）：

刷新并安装 LTS（推荐 Node 20）：

如果 brew 报编译工具缺失，先装命令行工具：xcode-select --install

2）全局安装 n8n

3）本地启动

打开浏览器访问 👉 http://localhost:5678

想后台常驻？用 pm2：

npm i -g pm2 pm2 start "n8n" --name n8n pm2 save && pm2 startup

🐳 方案二：Docker 安装（更稳定、易更新）

适合长期跑、少折腾；环境干净，升级回滚也方便。

1）安装 Docker Desktop（Intel 版）

下载并安装：https://www.docker.com/products/docker-desktop/

2）拉起 n8n（持久化数据 + 基本环境）

最简启动：

推荐带上时区、主机名等（利于 Webhook/外网访问）：

说明：~/.n8n 是你的数据目录（工作流、凭据等），换新容器也不会丢。

3）访问

浏览器打开 👉 http://localhost:5678

🛠 常见小坑（Intel Mac）

端口被占用：lsof -i :5678 查占用进程，关掉或改端口（-p 8080:5678）。
权限问题（Docker 挂载目录）：首次运行前创建并给权限：

mkdir -p ~/.n8n && chmod -R 700 ~/.n8n
网络受限导致安装慢：给 npm 换源（权衡后再用）：

npm config set registry https://registry.npmmirror.com
Webhook/外网访问：把 N8N_HOST 改成你的域名，并在反代里把 5678 暴露出去；HTTPS 场景把 N8N_PROTOCOL 设为 https。
升级 n8n：
- Node 方案：npm i -g n8n@latest
- Docker 方案：docker pull n8nio/n8n && docker stop n8n && docker rm n8n 然后用原参数再跑一遍