n8n本地部署 windows完整安装配置教程

在 Windows 电脑上本地部署 n8n，意味着你可以拥有一个完全私有的自动化工作流编辑器，所有流程数据和执行记录都保存在本机硬盘中，无需依赖云端服务。这种方式不仅保障了数据隐私，还方便在离线或内网环境中进行调试。下面将演示如何通过 Docker Desktop 快速搭建这一环境，并确保数据在容器重启后依然完好无损。

n8n 本地部署完成后的工作流编辑器界面

部署的核心在于利用 Docker 容器隔离运行环境，并通过挂载本地目录实现数据持久化。开始前，请确保你的 Windows 系统已开启 WSL2 支持，这是 Docker Desktop 在 Windows 上高效运行的基础。

1. 安装并验证 Docker 环境

首先需要在 Windows 中安装 Docker Desktop。从官网下载并安装完成后，启动软件，等待右下角托盘图标中的 Docker 引擎状态变为“Running”。

打开 PowerShell 终端，输入以下命令检查环境是否就绪：

docker version
docker compose version

如果两条命令均能返回具体的版本号信息，说明 Docker 引擎和 Compose 插件已正常工作。若提示命令不存在，请检查 Docker Desktop 是否完全启动，或尝试以管理员身份重新打开终端。

2. 创建项目目录结构

为了便于管理文件和后续备份，建议在非系统盘创建一个独立的项目文件夹。例如在 D 盘根目录建立 n8n 文件夹，并在其中新建 data 子目录用于存储 n8n 的运行数据。

在 PowerShell 中执行：

New-Item -ItemType Directory -Force D:\n8n\data
Set-Location D:\n8n

请确保后续所有操作都在 D:\n8n 目录下进行，保持路径一致性可以避免权限错误。

项目目录结构示意，包含data子目录

3. 配置环境变量文件

在项目根目录 D:\n8n 下创建一个名为 .env 的文本文件。该文件用于定义容器的基础运行参数，如端口和时区。

写入以下内容：

N8N_PORT=5678
GENERIC_TIMEZONE=Asia/Shanghai
TZ=Asia/Shanghai

N8N_PORT 指定了浏览器访问时的主机端口，默认 5678 即可。如果该端口被占用，可修改为其他空闲端口（如 5680）。GENERIC_TIMEZONE 和 TZ 设置为上海时区，确保工作流中的计划触发时间和日志记录与本地时间一致。

3. 配置环境变量文件

4. 编写 Docker Compose 配置文件

在同一目录下创建 docker-compose.yml 文件。这是编排容器的核心配置文件，决定了镜像来源、端口映射和数据挂载方式。

文件内容如下：

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n
    ports:
      - "${N8N_PORT}:5678"
    environment:
      - GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
      - TZ=${TZ}
    volumes:
      - ./data:/home/node/.n8n
    restart: unless-stopped

关键配置解释：

• image: 使用官方 n8n 镜像。
• volumes: 将本地的 ./data 目录映射到容器内的 /home/node/.n8n。这是实现数据持久化的关键，即使删除容器，工作流数据仍保留在本地 data 文件夹中。
• restart: 设置为 unless-stopped，确保电脑重启或 Docker 服务重启后，n8n 能自动恢复运行。

docker-compose.yml 配置文件内容示例

5. 启动服务并初始化

在 D:\n8n 目录下的 PowerShell 中，依次执行以下命令拉取镜像并启动容器：

docker compose pull
docker compose up -d

启动完成后，执行 docker compose ps 查看容器状态。当 STATUS 列显示为 “Up” 时，表示服务运行正常。

打开浏览器，访问 http://localhost:5678（若修改了端口则对应调整）。首次访问会进入初始化页面，按照提示设置管理员邮箱和密码即可完成注册。

6. 验证数据持久化与时区

登录成功后，创建一个简单的工作流进行测试。例如添加一个“Manual Trigger”节点和一个“Debug”节点，点击执行并保存工作流。

为了验证数据是否真正保存到了本地，执行以下命令重启容器：

docker compose restart

刷新浏览器页面，重新登录。如果刚才创建的工作流依然存在，且执行历史记录未丢失，说明 volumes 映射配置正确，数据已成功持久化到 D:\n8n\data 目录。

同时，检查界面右上角的时间显示或日志时间，确认是否与北京时间一致。若时间偏差较大，请检查 .env 文件中的时区设置并重新执行 docker compose up -d 使配置生效。

测试工作流执行成功并保存的状态

至此，n8n 已在 Windows 本地稳定运行。日常使用中，只需定期备份 D:\n8n 整个文件夹即可实现完整的数据迁移或灾难恢复。若需停止服务，使用 docker compose down 命令，注意不要添加 -v 参数，以免误删本地数据卷。