n8n本地安装的两种方法：小白入门大白话版本

下面给出一份"纯新手也能看懂"的 n8n 本地安装双路线攻略。

把两条路线分别比喻成"买现成盆栽"和"自己播种"，每一步都拆开讲，遇到黑话就用类比翻译，保证零 Linux/编程经验也能跟做。

---

路线 A：Docker 一键盆栽法（官方推荐，最省心）

类比：Docker 像一个大花店，n8n 是里面一盆已经配好土、施好肥的"多肉"，端回家就能摆窗台上。

1. 先装"花店"------Docker Desktop

   Windows/Mac：去官网 docker.com 下载 → 双击安装 → 装完启动，右下角出现小鲸鱼图标即成功 。

   类比：就像装一个"应用商店"，以后所有容器应用都能在里面一键装。

2. 把 n8n 这盆"多肉"搬回家（拉镜像）

   打开 Docker 自带的终端（Windows 叫 PowerShell，Mac 叫 Terminal），复制粘贴：

   docker pull n8nio/n8n

   第一次会跑进度条，大概 200 MB，去倒杯水就好 。

3. 给花盆选个"阳台"（建文件夹）

   在 D 盘或任意位置新建文件夹，比如 D:\n8n-work，用来存工作流数据。

   类比：游戏存档路径，重装系统也不丢档。

4. 真正"端回家"并摆好（启动容器）

   继续在同一条终端里粘贴：

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

   逐段翻译：

   • -d：后台运行，像最小化窗口。
   • --name n8n：给花盆贴个标签，以后好找。
   • -p 5678:5678：把花盆的"窗"开在 5678 端口，浏览器就能看见。
   • -v ...：把刚才的"阳台"挂到花盆里，数据实时同步。
     回车后 10 秒内会返回一串长字符，代表"盆栽"已就位 。

5. 第一次"赏花"

   打开浏览器输 http://localhost:5678，看到注册页就 100 % 成功。

   注册完立刻可以拖拖拽拽建流程，零配置 。

---

路线 B：npm 自己播种法（无 Docker 也能玩）

类比：不用花店，自己去买种子（源码）、买土（Node.js），在自家后院播下去。

1. 先整一块"后院"------装 Node.js

   去 nodejs.org 下载左边那个 LTS（长期支持版），一路 Next。

   装完打开终端输入：

   node -v

   能输出版本号（如 v18.20.0）就说明后院已平整 。

2. 撒种子（全局安装 n8n）

   同一条终端里跑：

   npm install -g n8n

   网络慢就换手机热点，几分钟搞定。

   类比：像给电脑装一个"QQ 音乐"，装完就能直接用。

3. 浇水发芽（启动）

   n8n start

   第一次会看见一串日志，最后停在

   "n8n ready on http://localhost:5678" 就是发芽完成 。

4. 赏花 + 存档

   浏览器进 http://localhost:5678 注册账号。

   数据默认藏在：

   • Windows：C:\Users\<用户名>\.n8n
   • Mac：~/.n8n
     重装系统前把这个文件夹备份即可，相当于"游戏存档复制到 U 盘"。

---

两条路线怎么选？

场景	推荐路线	理由
完全不想碰代码、命令行越少越好	A（Docker）	复制 2 条命令就能玩，升级也一键
公司电脑不让装 Docker/已有限制	B（npm）	只需 Node.js，绿色无污染
想深挖源码、二次开发	B	源码就在 npm install 后的目录里

---

常见新手坑位提示

1. 端口被占：如果 5678 打不开，大概率被迅雷/QQ 占用，把命令里的"5678:5678"改成"6688:5678"即可。
2. 中文文件夹：Docker 卷路径里别出现"桌面""文档"等中文，会识别失败。
3. 关电脑后找不到：Docker Desktop 重启会自动把"花盆"端回来；npm 版则需重新 n8n start，或者把它做成开机启动任务。
4. 升级：Docker 用 docker pull n8nio/n8n:latest 再重新跑；npm 用 npm update -g n8n。

---

一句话总结

想"开箱即食"就走 Docker 路线 A；想"从零开始体验种植乐趣"就走 npm 路线 B。两条路最终都能到达同一座自动化花园，祝你玩得开心！