Windows本地部署n8n完整教程(基于Docker,新手友好)

一、Windows本地部署整体流程

核心逻辑:Windows系统无法直接高效运行Linux容器,因此先配置WSL 2环境,再安装Docker Desktop,最后通过Docker拉取n8n镜像并完成部署,全程无需复杂的代码操作,跟着点击就能完成。

1.1 配置WSL环境(必做步骤)

很多新手会疑惑,为什么一定要装WSL环境?其实答案很简单:n8n官方最推荐用Docker部署,而Windows版的Docker Desktop,必须依赖WSL 2(Windows Subsystem for Linux 2)才能高效运行为Linux构建的容器,缺少WSL环境,Docker要么无法启动,要么运行卡顿、报错。

具体操作步骤:

  1. 打开Windows命令提示符(CMD)或PowerShell(建议以管理员身份运行,避免权限不足);

  2. 输入命令并回车,开始自动安装WSL及默认分发版(默认是Ubuntu,无需手动选择):

    wsl --install

  3. 安装完成后,重启电脑(必须重启,否则WSL环境不生效);

  4. 重启后,再次打开命令行,输入以下命令检查WSL状态,确认安装成功:

    wsl --status

  5. 正常情况下,会显示默认分发版为Ubuntu,且WSL版本为2,此时WSL环境配置完成。

1.2 Docker安装(核心依赖)

Docker是部署n8n的载体,我们需要安装Docker Desktop(Windows版),步骤如下:

  1. 访问Docker官方地址:https://www.docker.com/,找到Docker Desktop for Windows的下载入口(官网会自动识别系统,直接下载即可);

  2. 下载完成后,双击安装包,按照默认选项下一步即可(安装过程中会自动检测WSL 2环境,若之前配置正确,会直接继续安装);

  3. 安装完成后,启动Docker Desktop,首次启动可能需要几分钟(会初始化WSL关联),等待界面显示「Engine running」,即为启动成功;

  4. (可选但推荐)更改镜像存储路径:默认情况下,Docker镜像会存储在C盘,长期使用会占用大量空间。可在Docker Desktop的「设置」中,找到「Docker Engine」或「镜像存储」选项,修改存储路径(比如D盘新建一个Docker文件夹),保存后重启Docker即可生效。

1.3 安装并启动n8n(最终部署)

Docker启动成功后,就可以开始部署n8n了,全程通过Docker界面操作,无需输入复杂命令,具体步骤如下:

步骤1:拉取n8n镜像

打开Docker Desktop,在左侧菜单栏找到「Docker Hub」(如果没有这个菜单,直接在顶部搜索栏输入「n8n」),搜索结果中找到官方的n8n镜像,点击「Pull」按钮,开始拉取镜像。拉取过程速度取决于网络,耐心等待即可,拉取完成后,在左侧「Images」(镜像)中可以看到n8n的镜像文件。

步骤2:创建n8n数据卷(Volumes)

为了防止n8n的数据丢失(比如配置、流程等),需要创建一个数据卷,用于持久化存储n8n的数据:

  1. 在Docker Desktop左侧菜单栏点击「Volumes」(数据卷);

  2. 点击「Create volume」,输入数据卷名称(建议命名为「n8n_data」,方便识别),其他选项默认,点击创建即可。

步骤3:启动n8n容器

镜像和数据卷准备完成后,开始启动n8n容器,配置参数如下:

  1. 在「Images」中找到n8n镜像,点击右侧「Run」(运行);

  2. 在弹出的配置窗口中,填写关键参数:

  • 容器名称:随意填写(比如「n8n-local」),方便后续管理;

  • 端口映射:默认端口为5678,保持「5678:5678」不变(左侧是本地端口,右侧是容器端口);

  • 数据卷挂载:点击「Volumes」选项,选择刚才创建的「n8n_data」,容器路径填写默认的「/home/node/.n8n」(无需修改);

  1. 其他参数默认,点击「Run」,启动n8n容器。启动成功后,在左侧「Containers」(容器)中可以看到n8n容器处于「Running」(运行中)状态。

步骤4:首次登录并配置n8n

  1. 容器启动成功后,打开浏览器,输入地址:http://localhost:5678/,进入n8n首次登录界面;

  2. 首次登录需要填写基本信息:邮箱、用户名、密码(密码建议设置复杂一些,保障安全),填写完成后点击确认;

  3. 接下来会弹出n8n用户调研界面,内容包括公司类型、个人角色、自动化服务对象、公司规模、了解n8n的途径等,无需认真填写,随便选择即可,也可以直接点击「Get started」跳过调研;

  4. 跳过调研后,会弹出「免费获取高级功能许可」的页面,填写自己的邮箱,点击获取许可密钥;

  5. 打开填写的邮箱,会收到一封包含许可证密钥的邮件,注意:密钥需要在14天内激活,激活后n8n的高级功能可以永久免费使用;

  6. 输入许可证密钥完成激活,即可进入n8n的初始界面!n8n的UI设计干净简洁,操作逻辑也比较直观,后续就可以根据自己的需求创建自动化流程了。

部署总结

整个Windows本地部署n8n的流程,核心就是「配置WSL→安装Docker→部署n8n」,三步即可完成,全程没有复杂的命令操作,新手也能快速上手。重点注意两点:一是WSL环境必须配置正确,否则Docker无法正常运行;二是创建数据卷,避免数据丢失。

部署完成后,就可以尽情探索n8n的自动化功能了,无论是个人日常办公自动化,还是小型团队的流程自动化,n8n都能很好地满足需求~ 如果部署过程中遇到问题,欢迎在评论区留言交流哦!

相关推荐
somi72 小时前
ARM-05-Platform + DTS + GPIO子系统 + 中断 + 等待队列 + 错误处理
linux·运维·arm开发
星马梦缘2 小时前
强化学习实战-2——Keras-DoubleDQN解决Predator【图像输入】
人工智能·python·jupyter·cnn·keras·强化学习·dqn
石榴树下的七彩鱼2 小时前
身份证 OCR 识别 API 接入详解(Python / Java 示例)
java·开发语言·人工智能·后端·python·ocr·api
qq_206901392 小时前
CSS如何选择同级中的第一个元素_通过-first-child伪类实现
jvm·数据库·python
AI、少年郎2 小时前
MiniMind 第 4 篇:《数据工程|Tokenizer 训练 + 预训练 / SFT/DPO 全数据集处理》
人工智能·python·ai·大模型·微调·大模型训练·minimind
InfinteJustice2 小时前
mysql如何设计积分系统_mysql流水账与余额对账
jvm·数据库·python
NotFound4862 小时前
Golang怎么实现防重复提交_Golang如何用Token机制防止表单重复提交【技巧】
jvm·数据库·python
fly-iot2 小时前
TradingAgents 是一个模拟真实交易公司运作模式的多智能体交易框架,本地运行命令行工具,演示执行命令行模式,使用docker镜像打包
python·股票系统·tradingagents
T0uken2 小时前
【Linux】耗时任务执行并邮件通知
linux·运维·服务器