【栗子的实验室进行的n8n所有教程,均基于【Docker-Compose】部署方式实战。】
【写在前面:n8n 是什么?它对你(普通人)有什么用?】
嗨,我是栗子!🌰 你可能在想,”n8n” 是个啥?听起来很专业。 简单说:n8n 是一个免费、开源的“自动化”工具。 它的作用,就是把你每天在电脑上做的“重复性工作”自动化,帮你“赢回时间”。
举几个普通人能用的例子:
- 让“飞书”里写的笔记,自动同步到“Notion”。
- 你一“收到新邮件”,就自动发“微信通知”提醒你。
- 把“B站”的热门视频,自动抓取并整理到你的表格里。
你不需要成为一个顶尖程序员,n8n 就像“数字乐高”,帮你把这些App“粘”在一起。 这篇文章(和视频)是【n8n探险】系列的第一步:手把手教你免费把它部署在自己的电脑上。 就算你现在还不知道具体要自动什么,也强烈建议你先【收藏】! 因为当你有一天厌倦了“复制粘贴”时,它就是你的神器。
大家好,我是栗子。 你是不是也和我一样,受够了那些日复一日的重复性工作,梦想着能有一个不知疲倦的 AI 助手,帮你打理一切? n8n,就是那个能帮你实现梦想的强大工具。 但说实话,当我第一次下定决心要用它时,光是“安装”这一步,就看得我眼花缭乱。
摆在面前的路太多了:有看起来最简单的 Windows 安装包,有需要敲长长命令的 Docker Run,还有听起来很专业的 npm… 到底该选哪条? 作为一个过来人,我想先分享我当初踩坑后得出的血泪结论:选择比努力更重要。
十字路口的选择
为了不让大家重蹈覆辙,我把几条路都跑了一遍,帮你整理了这张优劣势一目了然的“探险地图”。
| 安装方式 | 推荐指数 | 优点 | 缺点 | 栗子总结 |
|---|---|---|---|---|
| Docker Compose | 💚💚💚💚💚 (强烈推荐) | ① 数据位置可控 ② 配置一目了然 ③ 管理极简 | ① 需先安装 Docker ② 首次配置需粘贴代码 | 一次配置,长久安心。 小白到长期的最佳路径。 |
| Docker Run | 🧡🧡 (不推荐长期) | 无需额外文件,适合快速测试 | ① 命令极长且难记 ② 后期难维护 | 仅适合临时测试。后续想改东西非常折腾。 |
| 本地 npm | ❌ (不推荐) | 无需 Docker | ① Node.js 版本极易冲突 ② 数据默认在C盘 | 小白的“劝退”首选。 极容易被环境卡住。 |
| Windows (.exe) | ❌ (不推荐) | 符合传统安装习惯 | ① 数据强制在C盘(致命) ② 无法后台稳定运行 | 看似最简单,实则“暗坑”最多。C盘很快会被拖垮。 |
你看,那个看似最简单的 Windows 安装包 (.exe) ,其实藏着一个致命的“坑”——它会把所有数据强制塞进你的 C 盘。而 Node.js/npm 安装,对新手来说简直是“劝退”首选。 所以,我们的最佳路径只有一个:Docker Compose 安装。
为什么是 Docker Compose?
我知道,你可能第一次听到Docker这个词,感觉又是一个复杂的新东西。别怕,一开始我也头大。 后来我发现,我们可以用一个特别简单的比喻来理解它。
Docker Desktop,就像一台“智能手机”。
它能在我们的电脑里,创造一个独立、干净、与外界隔离的运行环境。 而 n8n,就是我们要安装在这台“手机”里的一个强大 App。
我们选择的 Docker Compose 方案,就好比在盖房子前,认真地画了一张“设计图”。这张图纸(也就是一个配置文件)清晰地说明了我们的 App 要怎么装、数据要放在哪里。 用它,就像是给我们的自动化事业盖一栋带地基的别墅——初期多花 10 分钟,换来的是长久的稳定与安心。
打下第一根桩:安装“智能手机”Docker
好了,理论不多说,我们直接开干。 第一步,就是先在我们的电脑上,把这台叫 “Docker” 的“智能手机”安装好。
打开 Docker 的官网,找到下载页面。 官网地址: https://www.docker.com/products/docker-desktop
下载过程就像我们安装微信、QQ 一样,没什么特别的,一路点击“下一步”就好。
最关键的一步来了。安装完成后,先不要急着进行下一步。请务必先从你的桌面或开始菜单里,启动 Docker Desktop 这个程序。(在以后每次登录n8n前,也请务必先打开Docker Desktop 这个程序)
你会看到它在后台默默启动,这可能需要一两分钟。 真正的“Win Moment”是: 当你在电脑右下角的任务栏,看到那个憨憨的小鲸鱼图标安稳地出现时,我们的地基,就打好了!
事不宜迟,我们立刻开始盖房子!
打开我们的“指挥中心”
首先,我们需要一个能和 Docker 直接对话的地方。在 Windows 系统里,这个地方就是 PowerShell。 别被它的名字吓到,你可以把它想象成一个拥有最高权限的“指挥中心”。
在 Windows 的搜索栏里搜索 PowerShell,找到它,然后右键点击,一定要选择“以管理员身份运行”。
清理旧环境(可选但推荐)
为了确保我们的“施工现场”绝对干净,我们先分别运行两条清理命令。 在 PowerShell 窗口里,依次粘贴并回车运行下面这两条命令。
命令1:
- 在PowerShell中粘贴并回车
docker stop n8n
命令2:
- 在PowerShell中粘贴并回车
docker rm n8n
看到红字别慌! 如果你看到提示 No such container,这完全正常,甚至是个好消息。它说明你的环境本来就很干净。
在 E 盘“圈地”
这是最核心的一步。我们要用命令,在 E 盘为 n8n 创建两个专属文件夹:一个用来放它的“设计图”(配置文件),一个用来放它未来所有的“家当”(数据)。 请保持这个 PowerShell 窗口不要关闭!
命令1:
切换到E盘 (如果你的盘符是D,就输入 D:)
- 在PowerShell中粘贴并回车
E:
命令2:
作用:创建一个叫 n8n-data 的文件夹,专门存放你未来的所有宝贵数据。
- 在PowerShell中粘贴并回车
mkdir n8n-data
命令3:
作用:创建用于存放配置文件 (n8n-project)
- 在PowerShell中粘贴并回车
mkdir n8n-project
命令4:
- 在PowerShell中粘贴并回车
cd n8n-project
你的命令完成运行后,会显示 PS E:\n8n-project>。⚠️请保持这个windows powershell窗口不要关闭!
绘制 n8n 的“设计图”
现在,我们需要创建整个工程的灵魂——docker-compose.yml 配置文件。 打开你电脑上任何一个文本编辑器(比如系统自带的记事本,或者 VS Code),完整地复制下面的所有代码,粘贴进去。
version: '3.7'
services:
n8n:
# 使用教程中推荐的、固定的版本号,保证环境稳定
image: n8nio/n8n:1.114.4
# 容器的名字
container_name: n8n
# 总是自动重启,保证服务高可用
restart: always
# 端口映射,让你可以通过 localhost:5678 访问
ports:
- "5678:5678"
# --- 这是为E盘定制的关键修改 ---
# 我们将数据卷路径指向了E盘的 n8n-data 文件夹
# 注意:在 yml 文件里,Windows 路径也建议使用正斜杠 "/"
volumes:
- E:/n8n-data:/home/node/.n8n
# 环境变量配置
environment:
# 允许 Code 节点使用所有 Node.js 内置模块
- NODE_FUNCTION_ALLOW_BUILTIN=*
# 允许 Code 节点安装和使用所有外部 npm 包
- NODE_FUNCTION_ALLOW_EXTERNAL=*
# 设置时区为上海,确保所有和时间相关的操作都准确无误
- GENERIC_TIMEZONE=Asia/Shanghai
关键来了: 将这个文件保存。
- 文件名: docker-compose.yml (注意,后缀名是 .yml,不是 .txt)
- 保存位置: E:\n8n-project (就是我们刚才创建的项目基地)
一键启动,见证奇迹!
所有准备工作都已就绪。 回到你一直开着的那个 PowerShell 窗口 (PS E:\n8n-project>)。 深呼吸,粘贴并回车运行最终的启动命令:
- PowerShell 窗口粘贴并回车
docker-compose up -d
稍等片刻,当你看到绿色的 Container n8n Started 字样,就代表——恭喜你,成功了!
呼…搞定!恭喜你,AI 助手的“五星级豪宅”地基打好了! 对了,虽然我们走了最完美的路,但“施工”时你可能还是会遇到一些“小石子”。比如 Docker 启动失败、yml 文件路径怎么填… 我把我那帮“飞书训练营”的伙伴们(@张三 @李四 感谢他们)踩过的坑,都整理成了一个“部署避坑手册(环境篇)”,放在飞书文档里了,你们自取,以防万一。
[👉 点这里,拿走《部署避坑手册(一)【伙伴提问箱】·(一):部署准备与环境篇 - 飞书云文档]
最后,我再唠叨几句。 你可能会想:“栗子,你为啥非要死磕 Docker 这么麻烦的玩意儿?那个 .exe 安装包点一下不香吗?”
我承认,我差点就点了。 还好我多看了一眼,发现它会“强制安装C盘”——这简直是所有“暗坑”里的“坑王”!C盘爆红的焦虑,我真的不想再体验一次。
我又去试了npm和Docker Run。npm的版本冲突能让你在入门前就想放弃;Docker Run那条长得离谱的命令,改一次配置就得重来一遍,太折腾了。
这就是我为什么最终强烈推荐你用Docker Compose的原因。
它就像我们“盖别墅”前画的那张“设计图”。虽然我们初期多花了10分钟去“圈地”、“画图”,但换来的是“E盘安家”的自由和 long term 的安心。 真的,尤其是在折腾新工具这件事上,“选择比努力更重要”。
好了,第一篇就到这,下一篇我们去“豪宅”里领“超级福利”!
哈喽,我是栗子!🌰 一个专注为你探索AI效率工具与工作流的博主。 如果这篇文章对你有帮助,欢迎关注:
- B站:【栗子的实验室】
- 公众号:【栗子的实验室】(ID: LiziLab_) 我们一起,赢回时间。