博客文章

分享基础代码优化、高性能架构设计及跨境电商实战经验。我们不仅构建网站，更产出驱动业务增长的硬核知识

n8n Windows 本地部署超详细教程

一、这份教程适合谁

本教程适合第一次在 Windows 电脑上部署 n8n 的用户。按照顺序操作即可，不需要先学习 Docker。你最终会得到一个运行在自己电脑上的 n8n，并通过浏览器访问 http://localhost:5678。

本教程采用 Docker Desktop 方式。n8n 官方目前推荐 Docker 作为常见的自托管方式之一；Docker Desktop 在 Windows 上同时提供 Docker Engine、Docker CLI 和 Compose 等组件。

二、先理解你要安装的几个东西

名称它是什么是否必须单独安装
Windows你的电脑操作系统已经有
Docker Desktop在 Windows 上运行 Docker 的图形界面程序需要安装
Docker Engine真正负责运行容器的 Docker 引擎由 Docker Desktop 提供
n8n你要运行的自动化平台通过 Docker 镜像运行
n8n 镜像n8n 的程序模板Docker 会自动下载
n8n 容器真正运行中的 n8n 实例通过命令创建
浏览器访问 n8n 管理后台已经有

三、官方下载地址

  1. Docker Desktop 官方下载/安装页面：
    https://docs.docker.com/desktop/setup/install/windows-install/
  2. Docker Desktop 官方介绍/下载入口：
    https://www.docker.com/products/docker-desktop/
  3. n8n 官方 Docker 安装文档：
    https://docs.n8n.io/hosting/installation/docker/
  4. n8n 官方自托管文档：
    https://docs.n8n.io/hosting/

建议只从以上官方地址下载，不要从第三方软件下载站下载 Docker Desktop。

四、检查自己的 Windows 是否适合

Docker Desktop 当前 Windows 安装要求与 WSL 2、虚拟化等有关。最简单的方式是先安装 Docker Desktop；如果安装程序提示 WSL 2 或虚拟化没有开启，再按提示处理。Docker 官方文档说明，使用 WSL 2 后端时需要满足相应 Windows、WSL 版本和硬件虚拟化条件。

检查 Windows 版本：

按键盘 Win + R → 输入 winver → 回车。

会出现”关于 Windows”窗口。记下 Windows 10/11 以及版本号。

检查 WSL：打开 CMD 或 PowerShell，输入：

wsl --version

五、什么是 CMD，怎么打开

CMD 就是 Windows 的”命令提示符”，以后教程里的 docker xxx 命令就在这里输入。

方法 A：

  1. 点击 Windows 左下角”开始”。
  2. 输入 CMD。
  3. 点击”命令提示符”。

方法 B：

按 Win + R → 输入 cmd → 回车。

打开后，你会看到类似：

C:\Users\lenovo>

光标就在 > 后面，这里就是输入命令的位置。

注意：命令不要把前面的 C:\Users\lenovo> 一起复制进去。只复制命令本身。

六、CMD 和 PowerShell 怎么选

本教程统一使用 CMD，避免初学者因为 PowerShell 的语法差异产生混淆。以后看到：

C:\Users\lenovo>

就在这个窗口输入。

如果你已经习惯 PowerShell，也可以使用 PowerShell 执行大多数 Docker 命令，但本教程不需要切换。

七、下载 Docker Desktop

  1. 打开浏览器。
  2. 访问：
    https://docs.docker.com/desktop/setup/install/windows-install/
  3. 找到 Windows 下载按钮。
  4. 普通 Intel/AMD 64 位 Windows 电脑选择 x86_64 版本；只有 ARM Windows 电脑才选择 ARM 版本。
  5. 下载完成后，一般会得到类似 Docker Desktop Installer.exe 的安装文件。

不要在 CMD 里直接输入 Docker Desktop Installer.exe；第一次安装直接双击这个文件最简单。

八、安装 Docker Desktop

  1. 双击 Docker Desktop Installer.exe。
  2. 安装程序出现配置选项时，普通 Windows 用户优先使用 WSL 2 后端。
  3. 如果看到”Use WSL 2 instead of Hyper-V”之类选项，普通 n8n 本地部署建议保持 WSL 2 方案。
  4. 按照安装向导继续。
  5. 如果 Windows 弹出 UAC 权限确认窗口，按照安装程序要求确认。
  6. 安装完成后关闭安装程序并启动 Docker Desktop。

Docker 官方说明，per-user 安装模式是多数用户推荐的模式；某些系统级设置仍可能需要管理员权限。

九、第一次打开 Docker Desktop

  1. 点击 Windows 开始菜单。
  2. 搜索 Docker Desktop。
  3. 点击 Docker Desktop。
  4. 第一次启动需要等待一段时间。
  5. 如果出现 Docker Subscription Service Agreement，根据你的使用场景阅读并接受。
  6. 等 Docker Desktop 完全启动后，再打开 CMD。

如果 Docker Desktop 还没有完全启动，就不要急着执行 docker ps。

十、检查 Docker 是否安装成功

打开 CMD，输入：

docker --version

如果正常，会出现 Docker 版本信息。

然后输入：

docker ps

第一次运行可能没有任何容器，这是正常的。只要没有出现”docker 不是内部或外部命令”之类错误，就说明 Docker CLI 已经可以使用。

十一、如果出现”docker 不是内部或外部命令”

先不要重新安装。

  1. 确认 Docker Desktop 已经启动。
  2. 关闭当前 CMD。
  3. 重新打开 CMD。
  4. 再次输入 docker –version。
  5. 如果仍然不行，重新启动 Docker Desktop 或 Windows。

如果仍然无法识别，再检查 Docker Desktop 是否正确安装。

十二、创建 n8n 数据文件夹

建议在 C 盘创建：

C:\n8n

最简单方法：

打开”此电脑” → 打开 C 盘 → 右键空白处 → 新建 → 文件夹 → 命名为 n8n。

最终路径应该是：

C:\n8n

这个目录非常重要，因为我们会把 n8n 数据保存到这里。

十三、创建 n8n 容器

回到 CMD，输入下面这一整行：

docker run -d --name n8n-local --restart always -p 5678:5678 -v C:\n8n:/home/node/.n8n n8nio/n8n:latest

然后按 Enter。

第一次执行时 Docker 会自动下载 n8n 镜像，所以需要等待。网络速度不同，等待时间可能不同。

如果最后返回一串很长的容器 ID，例如 a0f796de9215…，通常表示容器创建成功。

十四、逐项解释上面的命令

  • docker run：创建并运行一个新的 Docker 容器。
  • -d：后台运行，不占用当前 CMD 窗口。
  • –name n8n-local：把容器命名为 n8n-local。
  • –restart always：Docker 服务恢复后自动尝试启动 n8n。
  • -p 5678:5678：Windows 5678 端口映射到容器 5678 端口。
  • -v C:\n8n:/home/node/.n8n：把 Windows 的 C:\n8n 映射到 n8n 数据目录。
  • n8nio/n8n:latest：使用 n8n 官方镜像的 latest 标签。

十五、检查 n8n 容器

执行：

docker ps

正常情况下应该看到类似：

IMAGE n8nio/n8n:latest
STATUS Up ...
PORTS 0.0.0.0:5678->5678/tcp
NAMES n8n-local

其中最关键的是：STATUS 显示 Up，以及 PORTS 有 5678:5678。

十六、打开 n8n

打开 Chrome、Edge 等浏览器。

地址栏输入：

http://localhost:5678

然后按 Enter。

注意必须是 http://localhost:5678。不要只输入 localhost，也不要输入 https://localhost:5678。

第一次进入按照 n8n 页面提示创建账户。

十七、localhost 到底是什么

localhost 不是一个网站，也不是公网地址。它代表”当前这台电脑自己”。

因此：

http://localhost:5678 = 访问你自己电脑上的 5678 端口。

只要 n8n 容器运行，并且端口正确映射，浏览器就可以进入 n8n。

十八、Windows 重启以后怎么进入 n8n

正常情况下：

  1. 开机。
  2. 启动 Docker Desktop。
  3. 等待 Docker Desktop 完全运行。
  4. 由于容器设置了 –restart always，n8n 会自动启动。
  5. 浏览器打开 http://localhost:5678。

如果没有自动启动，执行：

docker start n8n-local

十九、如果 localhost 拒绝连接

如果遇到的问题。按以下顺序排查。

第一步：

docker ps

如果看到 n8n-local 且 STATUS 是 Up，继续下一步。

如果看不到 n8n-local，执行：

docker ps -a

如果看到 n8n-local 但状态是 Exited，执行：

docker start n8n-local

然后重新打开：

http://localhost:5678

二十、查看 n8n 报错日志

如果容器启动后网页仍打不开：

docker logs n8n-local --tail 100

如果需要持续观察日志：

docker logs -f n8n-local

停止实时日志显示时按 Ctrl + C。这个操作只停止查看日志，不会删除容器。

二十一、检查 5678 端口

在 CMD 输入：

netstat -ano | findstr 5678

如果看到 LISTENING，说明 Windows 正在监听这个端口。

二十二、Docker Desktop 图形界面怎么看 n8n

打开 Docker Desktop → Containers。

找到 n8n-local。

如果显示 Running，说明容器正在运行。

点击 n8n-local 可以查看日志、端口、容器信息等。

如果显示 Stopped，可以在 Docker Desktop 中启动它，也可以在 CMD 中执行 docker start n8n-local。

二十三、常用 Docker 命令

用途命令
查看运行中的容器docker ps
查看所有容器docker ps -a
启动 n8ndocker start n8n-local
停止 n8ndocker stop n8n-local
重启 n8ndocker restart n8n-local
查看日志docker logs n8n-local –tail 100
实时日志docker logs -f n8n-local
查看 Docker 版本docker –version
查看镜像docker images
拉取最新版 n8n 镜像docker pull n8nio/n8n:latest

二十四、非常重要：不要随便删除容器

docker stop n8n-local 只是停止容器，不会删除。

docker rm n8n-local 会删除容器。

如果数据没有正确持久化，删除容器可能导致数据问题。因此初学者不要随意执行 docker rm、docker system prune 等清理命令。

本教程使用 C:\n8n:/home/node/.n8n 来持久化 n8n 数据，因此正常情况下工作流数据保存在 Windows 的 C:\n8n。

二十五、备份 n8n

建议至少备份：

  • C:\n8n 整个文件夹。
  • 重要工作流导出的 JSON 文件。
  • 重要凭据的安全记录。

特别是你已经建立了 WordPress、WooCommerce、AI、文件读取等工作流，建议每完成一个重要版本就导出一次工作流 JSON。

二十六、n8n 工作流怎么导出

进入 n8n 后：

  1. 打开需要备份的 Workflow。
  2. 找到右上角菜单。
  3. 选择 Export / Download 等对应导出功能（不同版本界面文字可能略有区别）。
  4. 把 JSON 文件保存到电脑，例如 D:\n8n-backup。

不要把包含敏感凭据的工作流文件公开上传到 GitHub 或发给别人。

二十七、如何更新 n8n

不要直接删除 C:\n8n。

先备份 C:\n8n。

然后拉取新镜像：

docker pull n8nio/n8n:latest

更新容器时，要重新使用原来的端口、数据目录和其他必要参数。最重要的是保持数据持久化配置不变。

n8n 官方 Docker 文档也提供通过 Docker Desktop Images 页面 Pull 新镜像或使用 docker pull 更新镜像的方法。

二十八、不要把”镜像、容器、数据”混在一起

对象作用你当前的例子
镜像 Imagen8n 程序模板n8nio/n8n:latest
容器 Container运行中的 n8nn8n-local
数据 Data工作流、配置等持久化数据C:\n8n

二十九、你的最终环境结构

Windows 电脑
↓
Docker Desktop
↓
Docker Engine / Linux 容器环境
↓
n8n-local 容器
↓
端口 5678
↓
浏览器 http://localhost:5678

n8n 数据：

Windows C:\n8n → 容器 /home/node/.n8n

三十、从零安装时的完整操作清单

  1. 确认 Windows 版本。
  2. 打开浏览器。
  3. 进入 Docker 官方 Windows 安装页面。
  4. 下载 Docker Desktop。
  5. 双击安装程序。
  6. 优先使用 WSL 2 后端。
  7. 安装完成后启动 Docker Desktop。
  8. 打开 CMD。
  9. 执行 docker –version。
  10. 执行 docker ps。
  11. 创建 C:\n8n 文件夹。
  12. 执行 docker run 创建 n8n-local。
  13. 执行 docker ps 检查容器。
  14. 浏览器打开 http://localhost:5678。
  15. 完成 n8n 首次账户设置。
  16. 建立第一个 Workflow。
  17. 导出重要 Workflow JSON 做备份。

三十一、以后最常用的五条命令

docker ps
docker ps -a
docker start n8n-local
docker restart n8n-local
docker logs n8n-local --tail 100

三十二、官方参考资料

Docker Desktop Windows 安装文档：
https://docs.docker.com/desktop/setup/install/windows-install/

n8n Docker 安装文档：
https://docs.n8n.io/hosting/installation/docker/

n8n 自托管文档：
https://docs.n8n.io/hosting/

以上地址均建议保存到浏览器收藏夹。

三十三、最后提醒

对于你目前的 WordPress/WooCommerce + n8n 项目，建议把 Docker 本地环境作为”自动化测试环境”。工作流确认稳定后再考虑部署到服务器。这样即使某个 AI 节点、HTTP Request、Merge 或 WooCommerce 节点配置错误，也不会直接影响线上网站。

另外，n8n 官方文档目前说明 Docker 是推荐的自托管方式之一；本教程选择 Docker 而不是 Windows 直接 npm 安装，主要就是为了让 n8n 的运行环境更加独立、稳定，并方便以后迁移。

文章分类

跨境专线推荐

安全稳定·响应快捷·直播流畅

近期文章