n8n入门及其安装部署教程（Windows&Mav版）
本文讨论了 n8n 这一工作流自动化平台的入门及安装部署教程，包括其特点、适合人群以及不同系统和方式的安装部署步骤和注意事项。n8n 简介：n8n 是开源低代码工作流自动化工具，有 400 + 预置集成、支持 JavaScript/Python 定制等特点，适合需高度定制自动化流程的团队和开发者。Node 安装：Mac 用户可下载 node - v22.18.0.pkg 安装包，Windows 用
N8N：最强工作流自动化平台
n8n是一个开源的低代码工作流自动化工具，可以帮你把各种不同的应用和服务连接起来，实现自动化操作。N8N 是一个工作流自动化平台，为技术团队提供代码的灵活性和无代码的速度。n8n 具有 400+ 集成、原生 AI 功能和公平代码许可证，可让您构建强大的自动化功能，同时保持对数据和部署的完全控制。
官方地址：AI Workflow Automation Platform & Tools - n8n https://n8n.io/
<不想安装的朋友可以直接在官网注册体验使用：注意使用非敏感数据测试>
官方模板地址： https://n8n.io/workflows/
核心特点：
- 400+预置集成
- 支持JavaScript/Python定制
- 轻量级部署(推荐2核4G云服务器即可 本地物理机虚拟化1核1G 能够满足docker运行)
- 强大的自动化能力
适合人群：需要高度定制自动化流程的团队和开发者
那我们接下来给大家分享如何用
在我们详细了解n8n之前，建议大家先按照下面的文档，安装部署n8n（优先本地部署）
n8n项目地址：https://github.com/n8n-io/n8n
nodejs软件下载地址：https://nodejs.org/en/download
docker软件下载地址：https://www.docker.com
N8N本地安装和部署具体步骤
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部署
🔧 方法一：快速试用（适合体验流程）
npx n8n- 前提：已安装 Node.js
- 打开 http://localhost:5678 即可体验
- 缺点：流程和数据不持久，适合试验不适合长期用
这种方式，中间运行的数据是临时存储在C盘，能快速体验n8n的完整功能，如果是需要数据持久化，推荐使用方法二，Docker方式部署。
🛠 方法二：Docker方式部署（推荐，长期运行）
这种方式Mac 和 Windows 的步骤是类似的，下载docker 时注意选择对应的 系统。
安装前准备
- - 下载并安装 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部署命令，不然可能会报错。
{
"builder": {
"gc": {
"defaultKeepStorage": "20GB",
"enabled": true
}
},
"experimental": false,
"registry-mirrors": [
"https://mirror.baidubce.com",
"https://docker.mirrors.ustc.edu.cn",
"https://registry.docker-cn.com",
"https://registry.aliyuncs.com"
]
}到这里为止，Mac 和 Windows 都是相同的步骤，只是 docker 安装的版本是不一样的。
大家先看懂这里的逻辑，后面创建数据卷和挂载文件夹和写入文件就不至于一脸懵逼了。
┌────────────────────────────┐ ┌─────────────────────────────┐ ┌────────────────────────────┐
│ 浏览器 UI │ --> │ Docker 容器 (运行 n8n) │ --> │ 宿主机 (Windows / Mac) │
│ - 在 n8n 节点里填写路径 │ │ - 只能识别容器内路径 │ │ - 实际的硬盘存储位置 │
│ - 例：/data/files/xxx.ext │ │ - 路径：/data/files/xxx.ext │ │ - Windows: E:/N8N/n8n/xxx │
│ │ │ │ │ - Mac: ~/N8N/n8n/xxx │
└────────────────────────────┘ └─────────────────────────────┘ └────────────────────────────┘
那我们接下来主要是两步：创建数据卷，拉取 n8n docker 镜像。
- 1. 创建持久化数据卷，让 后面docker 部署的 n8n相关文件存储在我们本地电脑，不会随着 n8n 容器镜像的销毁而销毁。
- 2. 拉取 n8n docker 镜像，本地部署。
2. Mac 本地部署
最好是在docker里面的terminal执行命令
创建持久化数据卷，存储相关数据，创建独立于容器的存储空间，即使容器销毁了，数据还在。
docker volume create n8n_data如果你用 Mac，不知道自己新建的专门放文件的地址是在哪，可以打开浏览器，输入 /
我下面的目录就是在我本地下载目录下新建了 docker，docker 文件夹目录下面新建 n8n文件夹
注意⚠️：-v ～/Downloads/docker/n8n:/data/files 要替换成你本地的文件夹
如果没有，你要去访达下载文件夹中建对应的目录
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，注册成功后点击右上角创建工作流。
3. Windows 本地部署
Windows系统 也可以直接在 上述 docker 的控制台操作，也可以用 Windows键+r 输入cmd，点击确定。
创建持久化数据卷，存储相关数据，创建独立于容器的存储空间，即使容器销毁了，数据还在。
docker volume create n8n_data
本地部署 docker 命令参考（-e n8n_COMMUNITY_PACKAGES 当时是为了解决 n8n 中的插件版本错误，现在新版本已经修复，用下面正常的可复制命令执行就好）
本地部署与启动n8n容器。
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 是你的素材存储盘，自行替换
比如我的本地目录就是这里 E:\n8n\n8n 大家可以自己选择一个存储空间比较大的位置，一般不建议放在C盘
后续可能需要一些梯子，会导致时间紊乱，建议部署的时候直接用上海的时区，另外可以指定版本，确保依赖正确。
和 Mac 类似，部署完在 docker 里点击 n8n 容器或者打开浏览器：访问 http://localhost:5678，注册后 即可开始使用！
由于每个人的电脑系统，环境依赖等可能都不一样，可能会出现各种问题，如果重试一次还是不行的话，
可以直接截图问AI，更有针对性。
4. 现代云部署
n8n本身对于电脑要求不高，如果想更加方便进行使用，可以用zeabur云端部署，24h执行自动化任务。
搜索n8n，进行部署。
可以选择部署到美国或者香港地区
有很多程序员朋友，也可以在谷歌云，阿里云等云平台部署n8n，或者使用内网穿透，让大家可以基于网页访问本地部署的 n8n。——先要进行初始化
🧭 最后如果想绑定域名作为日常使用，推荐Nginx反向代理（实际生产还需要其他配置）
#N8N
server {
listen 443 ssl;
server_name n8n.srebro.cn; ##替换成自己的域名
error_page 404 /404/404.html;
charset utf-8;
ssl_certificate /home/application/nginx/cert/srebro.cn.pem;
ssl_certificate_key /home/application/nginx/cert/srebro.cn.key;
ssl_session_cache shared:SSL:1m;
ssl_ciphers HIGH:!aNULL:!MD5;
ssl_prefer_server_ciphers on;
location / {
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header x-wiz-real-ip $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $http_host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_pass http://127.0.0.1:5678;
}
}
【隐私安全】
N8N的各种节点和插件以及MCP都需要填写明文的API/key需要时刻关注应用运行状况
大家也注意自己的API Key这些关键信息，尽可能不要让别人知道，否则别人可以拿着你的这个 API Key去消费。主要涉及：飞书、Notion相关、速推APIKey、一些AI大模型的APIKey等等
最后来个总结
本文讨论了 n8n 这一工作流自动化平台的入门及安装部署教程，包括其特点、适合人群以及不同系统和方式的安装部署步骤和注意事项。关键要点包括：
-
n8n 简介：n8n 是开源低代码工作流自动化工具，有 400 + 预置集成、支持 JavaScript/Python 定制等特点，适合需高度定制自动化流程的团队和开发者。
-
Node 安装：Mac 用户可下载 node - v22.18.0.pkg 安装包，Windows 用户根据系统架构下载对应 msi 格式安装包，安装后在终端输入 node - v 有版本号则安装成功。
-
n8n 部署 - 快速试用：前提是已安装 Node.js，运行 npx n8n 命令，打开 http://localhost:5678 体验，但流程和数据不持久。
-
n8n 部署 - Docker 方式：下载安装 Docker Desktop，准备空文件夹挂载数据。Mac 和 Windows 步骤类似，只是安装版本不同，需配置 Docker Engine。创建持久化数据卷 docker volume create n8n_data，再执行相应部署命令。
-
Mac 本地部署：在 docker 里的 terminal 执行命令，注意 - v 路径替换成本地文件夹，首次使用建议开启 VPN，部署成功可在浏览器访问 http://localhost:5678。
-
Windows 本地部署：可在 docker 控制台或 cmd 执行命令，E:/n8n/n8n 替换为本地素材存储盘，部署后同样访问 http://localhost:5678。
-
其他部署方式：可使用zeabur云部署，也可在谷歌云、阿里云等云平台部署，注意保管 API Key。
-
🎁 获取N8N CNB 仓库地址：https://cnb.cool/srebro/pidin/-/tree/main/pidin/ai/n8n
火山引擎开发者社区是火山引擎打造的AI技术生态平台，聚焦Agent与大模型开发，提供豆包系列模型（图像/视频/视觉）、智能分析与会话工具，并配套评测集、动手实验室及行业案例库。社区通过技术沙龙、挑战赛等活动促进开发者成长，新用户可领50万Tokens权益，助力构建智能应用。
更多推荐
23
0- 0
已为社区贡献6条内容
所有评论(0)