n8n怎么安装保姆级新手教程附避坑指南

大家好！n8n这个工作流自动化工具真的太火了，很多人都想用来提高工作效率。

但很多教程一上来就是一堆代码，直接劝退了不少非技术背景的小伙伴。

其实安装n8n十分简单！今天我就把踩坑总结出来的安装教程分享给大家，

就算是纯小白也能轻松搞定！

（大家也可以先收藏起来以免后续找不到）

一、n8n使用的3大方式

目前想要使用n8n一共3种方式：

1.n8n Cloud

由官方维护，无需本地部署，即开即用，新用户是14天免费体验。

适合想要先简单了解n8n功能的新手，长期使用不推荐。

传送门：https://n8n.io/

2.使用 npm 安装 n8n

但这个适合 Node.js 开发者，对小白来说没必要。

此处就不展开了，想要体验可以看官方文档：

https://docs.n8n.io/hosting/installation/npm/

3.使用 Docker 本地部署

这是我们今天主要讲的，听起来很复杂，但整体操作很简单，往下看便知。

一个简单的类比就是：

Docker 是手机，n8n 是应用。

所有安装了 Docker 后，部署 n8n 就是 一键操作 的事儿。

二、安装 Docker

安装Docker十分简单：

1.下载Docker Desktop

可从官方网站（ https://www.docker.com/ ）下载安装。

也可以通过下面链接获取：

https://pan.quark.cn/s/889f4575364a

2.安装Docker

双击安装包，点击“OK”开始安装。等待安装完成后，点击“Close”。

如果系统提示要重启，那就重启电脑。

3.首次运行

打开Docker Desktop，会显示用户协议，点击“Accept”接受。

之后可以跳过初始设置，不用登录，直接进入主界面。

4.修改镜像存储路径

Docker一般默认将镜像文件存储在C盘，可能占用大量空间（建议C盘至少有150G空闲）。为避免C盘空间不足，建议修改存储路径。

打开Docker设置（右上角齿轮图标），在左侧菜单中找到“Resources”。

在“Disk Image location”选项中，将路径修改到其他磁盘（如D盘，但剩余空间不少于100G）。

点击“Apply”按钮，等待Docker完成迁移并重启。

三、下载n8n镜像并配置存储

安装好 Docker 后，后续我们只需要点点鼠标就能把 n8n 下载下来。

1.创建数据卷

在 Docker 界面找到 Volumes（卷）选项，新建一个卷，名字可以随便起，比如就叫 n8n-data 。

这是为了保存你的工作流数据，防止每次重启就丢失。

2.拉取镜像

切换到 Images 选项，在顶部搜索栏输入 n8n 。

找到搜索结果的第一条，点击 Pull （拉取）。

3.关键步骤：配置启动项

等镜像下载好，在 Images 里会能看到“n8nio/n8n”。

然后点击后面的“三角形”启动按钮，这时候会弹出一个配置窗口。

这一步最关键，大家仔细看，我们需要配置这几样东西：

①基础配置

给容器起个名字（比如 n8n），端口默认填 5678 即可。

②数据卷

左侧就是前面创建好的（比如 n8n-data），直接填进去就可以，确保数据不丢失。

右侧是容器路径，这个是固定的，直接填 /home/node/.n8n 。

③环境变量

n8n默认是美区，为了防止时区错误或权限问题，点击右侧 + 号，添加以下配置：

• GENERIC_TIMEZONE 填 Asia/Shanghai

• TZ 填 Asia/Shanghai

这是一个比较简单的设置，新手的话可以先不管那么多。

比如后面可以配置其他映射到本地的文件夹，方便数据保存在本地文件夹等。

4.启动并验证

配置完成后，点击 Run 按钮。

然后我们切换到 Containers （容器） 里，能看到多了一个 n8n 的容器，并且是在运行状态。

最后一步，打开浏览器访问：

http://localhost:5678/

看到这个界面，恭喜你，到此搭建成功啦！

然后就是输入你的邮箱完成注册和激活，接下来就可以开始你的自动化探索之旅了。

四、避坑指南

1.后续启动

虽然十分小白，但也还是提一嘴，后续我们要再使用n8n时，需要先打开 Docker 来启动n8n镜像。

但启动不是在 Images 里面，而是在 Containers 中。

只需要在 Containers 找到n8n，点击后面的小三角图标启动，然后再通过 http://localhost:5678/ 访问就行。

2.n8n镜像下载失败

如果你在拉取n8n镜像过程中，出现拉取很慢或者失败的话，这种情况一般是挂个梯子就能解决。

3.Docker安装过程中报错

可能需要更新或者安装一下 wsl ，具体如下：

键盘 wind+R 打开命令提示符，输入 cmd ，打开命令行。

输入安装WSL的命令：

wsl --install

设置WSL版本：

wsl --set-default-version 2

安装之后重启电脑，再安装Docker。