已安装Docker Desktop,直接转到“在 Docker 中部署和使用 n8n”。
如还没有安装Docker Desktop,请先安装:
在Docker官网页面Docker Desktop: The #1 Containerization Tool for Developers | Docker
使用Intel/AMD 处理器的64位Windows系统选择Download for Windows - AMD64,使用ARM 处理器的64位Windows系统(如 Surface Pro X、高通骁龙 PC)选择Download for Windows - ARM64。不知道自己电脑是哪种64位系统,直接安装AMD64版本就可以了,大多数电脑适用。
默认安装在C盘。Docker Desktop Installer下载后,点开软件按默认流程直接安装就可以了。如果需安装在D盘,可以参考博文Docker安装到D盘(包教包会)-CSDN博客。简单来说:在D盘已有的Program Files文件夹新建一个Docker文件夹(本文以此路径为例说明;如原本没有可新建,或直接新建Docker文件夹,相应修改后面的Start-Process代码句的路径),将下载的Docker Desktop Installer放在该文件夹,然后按 Win 键输入PowerShell,进入Windows PowerShell界面,在界面输入输入D:\Program Files\,然后输入下列代码句子进行安装
Start-Process -FilePath "Docker Desktop Installer.exe" -ArgumentList 'install', '-accept-license', '--installation-dir="D:\Program Files\Docker"', '--wsl-default-data-root="D:\Program Files\Docker\data"', '--windows-containers-default-data-root="D:\Program Files\Docker"' -Wait
弹出的安装页面选"使用WSL2引擎"选项(如果安装时未选,可在安装后通过设置启用:打开 Docker Desktop → 点击右上角 ⚙️ 设置,进入 General 或 Resources 选项卡,选 Use WSL 2 based engine。另外,在Windows上安装DockerWSL2虚拟化技术,电脑需要进行Windows系统相关配置的,可参考电脑docker怎么安装到d盘 - 今日头条)。安装完成后重启电脑,Docker Desktop 会自动启动并初始化 WSL2 后端。
接着配置 WSL2 内存分配。建议分配至少4GB内存给WSL2,步骤是:在D:\Program Files\Docker新建文本文件命名为.wslconfig,输入
[wsl2]
memory=4GB
swap=2GB
vcpu=4
保存。如果文件已存在,直接编辑并覆盖即可。
说明:
| 参数 | 说明 |
|---|---|
memory | WSL2 最大内存(如 4GB、8GB) |
swap | 交换空间大小(如 2GB) |
vcpu | 分配给 WSL2 的 CPU 核心数 |
保存.wslconfig文件后,打开 PowerShell,输入wsl --shutdown,回车执行,命令执行完成无输出,可以输入 wsl -l -v,检查是否执行成功,如果所有发行版状态显示为Stopped,说明已成功关闭。
在 Docker 中部署和使用 n8n
配置 Docker 国内镜像加速
打开 Docker Desktop 设置,步骤:打开 Docker Desktop,点击右上角 ⚙️ 图标 →Settings,进入Docker Engine选项卡
将右侧系统默认的配置内容
{ "builder": { "gc": { "defaultKeepStorage": "20GB", "enabled": true } }, "experimental": false }替换为:
{ "builder": { "gc": { "defaultKeepStorage": "20GB", "enabled": true } }, "experimental": false, "registry-mirrors": [ "https://docker.1panel.live", "https://docker.mirrors.ustc.edu.cn", "https://hub-mirror.c.163.com" ], "log-driver": "json-file", "log-level": "warn", "log-opts": { "max-size": "10m", "max-file": "3" } }点击 Apply & Restart 然后等待 Docker Desktop 重启。
(推荐优先使用:
https://docker.1panel.live(1Panel 官方镜像加速)
https://docker.mirrors.ustc.edu.cn(中科大镜像))
在PowerShell测试拉取,输入docker pull n8nio/n8n:latest,如果速度明显提升说明配置成功。
拉取成功后运行容器
打开 PowerShell,输入:
docker run -d \
--name n8n \
-p 5678:5678 \
-v n8n_data:/home/node/.n8n \
n8nio/n8n:latest
说明:
| 参数 | 说明 |
|---|---|
-d | 后台运行 |
--name n8n | 容器名称 |
-p 5678:5678 | 主机 5678 端口映射到容器 |
-v n8n_data:/home/node/.n8n | 数据持久化卷 |
n8nio/n8n:latest | 官方镜像 |
在PowerShell验证容器是否运行成功:输入docker ps
查看容器状态,能看到类似输出
应看到类似输出:
CONTAINER ID IMAGE COMMAND STATUS PORTS NAMES
abc123def456 n8nio/n8n:latest "/usr/bin/dumb-init…" Up 2 minutes 0.0.0.0:5678->5678/tcp n8n
输入docker logs n8n查看容器日志,看到输出n8n ready to serve,说明启动成功。
(看到Power Shell提示:Unable to find image 'n8nio/n8n:latest' locally。说明本地没有n8nio/n8n:latest镜像,需要按这一步先拉取镜像才能运行容器。)
访问 n8n
打开链接http://localhost:5678,首次访问会提示创建管理员账号。
打开链接http://localhost:5678/home/workflows,就可以开始创建你的workflow了。
在 Docker 容器中操作 n8n
打开PowerShell,输入
# 1. 查看容器状态
docker ps
# 2. 进入容器
docker exec -it n8n sh
# 3. 在容器内查看进程
ps aux | grep n8n
# 4. 退出容器
exit
# 5. 查看日志
docker logs -f n8n
# 6. 重启容器
docker restart n8n
# 7. 查看资源占用
docker stats n8n
# 8. 备份数据
docker run --rm --volumes-from n8n -v $(pwd):/backup alpine tar czf /backup/n8n_backup.tar.gz /home/node/.n8n