1、n8n安装部署教程

1、n8n安装部署教程 1、n8n安装部署教程 Modified September 28, 2025 node v22.18.0.pkg 81.52MB node v22.19.0 arm64.msi 26.39MB node v22.19.0 x64.msi 29.92MB node v22.19.0 x86.msi 27.24MB 创建持久化数据卷，存储相关数据，创建独立于容器的存储空间，即使容器销毁了，数据还在。 创建数据卷 Bash Copy docker volume create n8n data 如果你用 Mac，不知道自己新建的专门放文件的地址是在哪，可以打开浏览器，输入 / 我下面的目录就是在我本地下载目录下新建了 docker，docker 文件夹目录下面新建 n8n文件夹 注意⚠️： v ～/Downloads/docker/n8n:/data/files 要替换成你本地的文件夹 如果没有，你要去访达下载文件夹中建对应的目录 Mac下我的n8n部署命令 Bash Copy docker run d restart unless stopped name n8n p 5678:5678 v n8n data:/home/node/.n8n v ～/Downloads/docker/n8n:/data/files e GENERIC TIMEZONE="Asia/Shanghai" e TZ="Asia/Shanghai" docker.n8n.io/n8nio/n8n:latest 然后在 docker(建议)或teminal 终端窗口里面执行上述命令（创建数据卷和 n8n部署命令）。 • 第一次使用建议开启VPN避免镜像拉取失败 🥇 注意：这里如果安装失败记得开启魔法 或者 把我们的Docker Engine 设置好并应用 如果报如下错误的话，先确定 Docker Engine 的配置有没有改，改了有没有应用，然后再重试，还是不行的话，把命令最后面 docker.n8n.io/n8nio/n8n:latest 改为 n8nio/n8n:latest 即可。 如果是显示下面的内容说明我们的n8n镜像拉取成功。 然后打开Docker，就能发现对应的容器了，点击如下链接即可进入n8n的本地端口 注册完成后即可开始使用，进入如下页面表示 n8n 部署成功；你也可以在浏览器访问 http://localhost:5678，注册成功后点击右上角创建工作流。 Mac页面成功部署显示 3. Windows 本地部署 Windows系统 也可以直接在 上述 docker 的控制台操作，也可以用 Windows键+r 输入cmd，点击确定。 创建持久化数据卷，存储相关数据，创建独立于容器的存储空间，即使容器销毁了，数据还在。 创建数据卷 Bash Copy docker volume create n8n data 本地部署 docker 命令参考（ e n8n COMMUNITY PACKAGES 当时是为了解决 n8n 中的插件版本错误，现在新版本已经修复，用下面正常的可复制命令执行就好） 本地部署与启动n8n容器。 Windows下n8n部署命令 Bash Copy docker run d restart unless stopped name n8n p 5678:5678 v n8n data:/home/node/.n8n v E:/n8n/n8n:/data/files docker.n8n.io/n8nio/n8n:latest • E:/n8n/n8n 是你的素材存储盘，自行替换 node v22.18.0.pkg 81.52MB node v22.18.0.pkg 81.52MB node v22.19.0 arm64.msi 26.39MB node v22.19.0 arm64.msi 26.39MB node v22.19.0 x64.msi 29.92MB node v22.19.0 x64.msi 29.92MB node v22.19.0 x86.msi 27.24MB node v22.19.0 x86.msi 27.24MB 创建持久化数据卷，存储相关数据，创建独立于容器的存储空间，即使容器销毁了，数据还在。 如果你用 Mac，不知道自己新建的专门放文件的地址是在哪，可以打开浏览器，输入 / 我下面的目录就是在我本地下载目录下新建了 docker，docker 文件夹目录下面新建 n8n文件夹 注意⚠️： v ～/Downloads/docker/n8n:/data/files 要替换成你本地的文件夹 如果没有，你要去访达下载文件夹中建对应的目录 然后在 docker(建议)或teminal 终端窗口里面执行上述命令（创建数据卷和 n8n部署命令）。 • 第一次使用建议开启VPN避免镜像拉取失败 🥇 注意：这里如果安装失败记得开启魔法 或者 把我们的Docker Engine 设置好并应用 注意：这里如果安装失败记得开启魔法 或者 把我们的Docker Engine 设置好并应用 如果报如下错误的话，先确定 Docker Engine 的配置有没有改，改了有没有应用，然后再重试，还是不行的话，把命令最后面 docker.n8n.io/n8nio/n8n:latest 改为 n8nio/n8n:latest 即可。 如果是显示下面的内容说明我们的n8n镜像拉取成功。 然后打开Docker，就能发现对应的容器了，点击如下链接即可进入n8n的本地端口 注册完成后即可开始使用，进入如下页面表示 n8n 部署成功；你也可以在浏览器访问 http://localhost:5678，注册成功后点击右上角创建工作流。 3. Windows 本地部署 Windows系统 也可以直接在 上述 docker 的控制台操作，也可以用 Windows键+r 输入cmd，点击确定。 创建持久化数据卷，存储相关数据，创建独立于容器的存储空间，即使容器销毁了，数据还在。 本地部署 docker 命令参考（ e n8n COMMUNITY PACKAGES 当时是为了解决 n8n 中的插件版本错误，现在新版本已经修复，用下面正常的可复制命令执行就好） 本地部署与启动n8n容器。 • E:/n8n/n8n 是你的素材存储盘，自行替换 后续可能需要一些梯子，会导致时间紊乱，建议部署的时候直接用上海的时区，另外可以指定版本，确保依赖正确。 和 Mac 类似，部署完在 docker 里点击 n8n 容器或者打开浏览器：访问 http://localhost:5678，注册后 即可开始使用！ 由于每个人的电脑系统，环境依赖等可能都不一样，可能会出现各种问题，如果重试一次还是不行的话， 可以直接截图问AI，更有针对性。 4. zeabur 云部署 n8n本身对于电脑要求不高，如果想更加方便进行使用，可以用zeabur云端部署，24h执行自动化任务。 搜索n8n，进行部署。 可以选择部署到美国或者香港地区 有很多程序员朋友，也可以在谷歌云，阿里云等云平台部署n8n，或者使用内网穿透，让大家可以基于网页访问本地部署的 n8n。 大家也注意自己的API Key这些关键信息，尽可能不要让别人知道，否则别人可以拿着你的这个 API Key去消费。 主要涉及：飞书、Notion相关、速推APIKey、一些AI大模型的APIKey等等 在我们详细了解n8n之前，建议大家先按照下面的文档，安装部署n8n（优先本地部署） ⌨️ n8n项目地址：https://github.com/n8n io/n8n nodejs软件下载地址：https://nodejs.org/en/download docker软件下载地址：https://www.docker.com n8n项目地址：https://github.com/n8n io/n8n nodejs软件下载地址：https://nodejs.org/en/download docker软件下载地址：https://www.docker.com 1）Node安装 1. Mac用户 不方便安装的小伙伴，Mac 安装包如下，直接下载如下文件即可。 Mac 用户检查自己是否已经安装Node 使用聚焦搜索: • 按下键盘上的Command (⌘) + 空格键，打开聚焦搜索。 • 输入“终端”或“Terminal”，然后按回车键即可打开终端应用程序。 如果输入 node v 是下面这种情况，那说明在这之前没有安装过 node，需要去手动安装一下。 在https://nodejs.org/en/download网站安装 node ，Mac 和Windows 分别安装好符合自己系统的 node 点击继续，一直按照默认路径点击。 再去终端里面执行 node v 有版本号了说明 node 安装成功。 这个是本地编程的环境，安装后不会有实际软件的图标，显示类似上图即可。 2. Windows系统 Windows安装包如下 大家安装的时候注意自己的Windows系统架构，查看方式如下 在电脑桌面，右键单击，点击属性。 像我这个台式电脑就是X64的，所以我下载前面X64的msi格式的安装包即可。 安装Node节点 注意⚠️ 是下载 msi 格式的内容，不是 zip 格式的压缩包 可以自己选择一个位置，c盘内存比较大的话（ 100GB）也可以直接放 c 盘 Windows 用户使用Windows 键+R 输入 cmd 输入 node v，有版本号证明安装成功 接着我们测试 npx help 2）n8n部署 🔧 方法一：快速试用（适合体验流程） • 前提：已安装 Node.js • 打开 http://localhost:5678 即可体验 • 缺点：流程和数据不持久，适合试验不适合长期用 这种方式，中间运行的数据是临时存储在C盘，能快速体验n8n的完整功能，如果是需要数据持久化，推荐使用方法二，Docker方式部署。 🛠 方法二：Docker方式部署（推荐，长期运行） 这种方式Mac 和 Windows 的步骤是类似的，下载docker 时注意选择对应的 系统。 安装前准备 • 下载并安装 Docker Desktop Docker Desktop • 如果docker报错是wsl错误，则在cmd命令行里面执行 wsl install ，安装后通过命令 wsl version 查看是否安装成功 • 准备一个空文件夹，用于挂载数据（推荐放非C盘） 1. docker软件下载 在Docker官网中下载对应的版本，如果电脑是Windows系统的话根据不同的架构进行下载， 绝大多数传统台式机和笔记本电脑都应选择 AMD64 版本，而 ARM64 版本则专为搭载高通骁龙等 ARM 芯片的新型电脑设计 如果是Mac 则下载Mac版本的docker，也要知道自己是 苹果的架构还是之前Intel的架构。 可以在 系统设置—通用 查看，像我这个 Mac m4 就下载 docker第一个版本就可以了。 拖拽到右边，进行安装。 下载安装后重启电脑，打开Docker，打开设置。 保持跟下图一样的设置。 这里镜像文件挂载位置放在除C盘外比较大的盘中。 Docker Engine 配置，这些镜像代理，方便我们在没有梯子的时候也能下载相关的依赖。 📖 注意⚠️要先把这边替换好并且点击Apply（应用），再去执行后续的docker部署命令，不然可能会报错。 注意⚠️要先把这边替换好并且点击Apply（应用），再去执行后续的docker部署命令，不然可能会报错。 到这里为止，Mac 和 Windows 都是相同的步骤，只是 docker 安装的版本是不一样的。 大家先看懂这里的逻辑，后面创建数据卷和挂载文件夹和写入文件就不至于一脸懵逼了。 那我们接下来主要是两步：创建数据卷，拉取 n8n docker 镜像。 1. 创建持久化数据卷，让 后面docker 部署的 n8n相关文件存储在我们本地电脑，不会随着 n8n 容器镜像的销毁而销毁。 2. 拉取 n8n docker 镜像，本地部署。 2. Mac 本地部署 最好是在docker里面的terminal执行命令 比如我的本地目录就是这里 E:\n8n\n8n 大家可以自己选择一个存储空间比较大的位置，一般不建议放在C盘