【Docker部署】一键教会你部署docker——以n8n为例

Docker 从零开始部署 n8n (Windows 环境)
你之前的经历完美地证明了为什么 Docker 是运行 n8n 等应用的绝佳方式：它能彻底告别本地环境和依赖项冲突的烦恼。

把 Docker 想象成一个超轻量的虚拟机。我们将下载一个官方制作的、已经把 n8n 所有环境都完美配置好的 "n8n 系统镜像"，然后直接运行它。

第一步：安装 Docker Desktop

既然是从零开始，第一步就是安装 Docker 本身。
docker

安装：双击下载的 .exe 安装包。安装过程中，请勾选 "Use WSL 2 instead of Hyper-V" (如果出现该选项)，这是推荐的后端，性能更好。一路按照默认设置点击 "Ok" 或 "Next" 即可。

重启电脑：安装完成后，Docker 会要求你重启 Windows。

验证安装：重启后，Docker Desktop 应该会自动启动。你会在系统托盘（右下角）看到一个鲸鱼图标 🐳。

打开你的终端 (PowerShell)，输入以下命令来验证 Docker 是否安装成功：

docker --version
如果它能返回版本号 (例如 Docker version 20.10.24)，恭喜你，Docker 环境已经就绪！

第 1 步：为 n8n 创建一个专属文件夹
为了让你创建的工作流、凭证等数据能够持久化保存，我们需要在你的电脑上创建一个文件夹，并将其“链接”到 Docker 容器内部。这样，即使容器被删除或重建，你的数据也安然无恙。

在你喜欢的位置创建一个文件夹，例如 D:\docker-data\n8n。在 PowerShell 中可以用这个命令：

mkdir -p D:\docker-data\n8n
(这个文件夹将作为 n8n 的“外部数据库”)

现在是最关键的一步。打开 PowerShell 终端，复制并粘贴以下命令，然后回车。

docker run -d --restart always --name n8n -p 5678:5678 -v D:\docker-data\n8n:/home/node/.n8n docker.n8n.io/n8nio/n8n

这条命令看起来复杂，我们来分解一下它的含义：

docker run: 告诉 Docker 我们要运行一个容器。

-d: Detached 模式。让容器在后台持续运行，不会占用你的终端。

--restart always: 一个非常重要的设置！它能确保每次 Docker 启动时 (比如你重启电脑后)，n8n 容器都会自动启动。

--name n8n: 给你的容器起一个好记的名字，叫 n8n，方便以后管理。

-p 5678:5678: 端口映射。将你电脑的 5678 端口连接到容器内部的 5678 端口。这是你访问 n8n 界面的入口。

-v D:\docker-data\n8n:/home/node/.n8n: 数据卷映射 (最关键的部分)。这就是将你在第 1 步创建的文件夹 (D:\docker-data\n8n) 链接到 n8n 容器内部存储数据的默认路径 (/home/node/.n8n)。

docker.n8n.io/n8nio/n8n: 这是 n8n 官方的 Docker 镜像地址。Docker 会自动从这个地址下载镜像。

第一次运行此命令时，Docker 会花一些时间下载 n8n 镜像，之后就会秒速启动。

检查容器状态：运行 docker ps 命令，你应该能看到一个名为 n8n 的容器正在运行 (STATUS 为 Up)。

docker ps

访问 n8n：打开你的浏览器（Chrome, Edge, etc.），访问地址：

现在，你应该能看到 n8n 的设置界面了！你在这里创建的所有工作流都会被安全地保存在你电脑的 D:\docker-data\n8n 文件夹里。

如何管理你的 n8n 容器？

停止 n8n： docker stop n8n

启动 n8n： docker start n8n

查看日志 (用于排错)： docker logs n8n

删除容器 (数据会因-v参数而保留)： docker rm n8n (必须先停止)