n8n本地部署 windows完整安装配置教程
Windows 11 是微软全新操作系统，现代化界面，流畅操作体验，适用于学习、工作与日常生活。它更偏向把系统状态查看和常用调节动作放在一起，适合需要持续观察和微调设备状态的场景。
详细讲解如何在 Windows 系统中使用 Docker Desktop 部署 n8n 自动化工具。包含环境变量配置、数据卷映射、时区设置及重启验证步骤，实现安全稳定的本地工作流编辑与运行。
在 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 参数，以免误删本地数据卷。
AirBuddy 3 是面向 macOS 的蓝牙外设增强工具，可集中查看 AirPods、Beats 与苹果设备电量，提供快速连接、播放控制、电量提醒、桌面小组件和多台 Mac 外设接力等功能。
AirServer macOS版可把 Mac 转换为无线投屏接收端，通过 AirPlay 或 Google Cast 接收手机、平板和电脑画面，并支持多设备同时连接、高清镜像及会话录制，适合家庭娱乐、课堂教学、会议演示和应用展示。
Beamer 4是面向macOS的本地视频投屏工具，可将Mac中的影片投放到Apple TV、Chromecast及兼容设备，支持常见格式、多类字幕、环绕声、播放列表和电视遥控操作。
Boom 3D macOS版是一款系统级音效增强工具，可为音乐、电影、游戏和流媒体提供3D虚拟环绕声、31段均衡器、音量增强及应用独立音量控制，并支持本地播放器与多种音频输出设备。
Boris FX macOS版是一套面向剪辑、合成、调色及动态图形工作的专业后期工具，涵盖视觉特效、平面与三维跟踪、转描、画面修复、粒子动画和音频清理，可配合多种主流宿主软件使用。
Capto 是面向 macOS 的屏幕截图、高清录屏与媒体编辑工具，支持区域及整屏捕获、网页长截图、双音轨处理、图片和视频标注、素材分类与多渠道分享，适合教师、学生、内容创作者及需要制作演示教程的用户。
Cursor Crane 是一款仅面向 macOS 的键盘操控效率工具，可通过提示标签、网格、文字查找和窗口模式完成点击、滚动、定位与切换，并支持屏幕内容提取、脚本及工作流扩展。
Deep Freeze 冰点还原 macOS版通过冻结系统配置，让受保护的Mac在重新启动后回到预设状态，并提供解冻空间、维护计划、密码保护及Apple Remote Desktop管理能力。
Focusky macOS版是一款面向教学课件、商务汇报、产品展示和动画宣传内容的演示制作工具。它通过无限画布、路径编排、缩放旋转转场及多媒体编辑，将传统逐页幻灯片转化为更具空间感的动态演示。
Folder Colorizer 2 macOS版是一款直观的文件夹外观定制工具，可更换颜色，添加表情、贴纸及图片背景，并支持批量处理、智能推荐和恢复默认样式，帮助用户更快辨认工作、学习与生活资料。
AirServer Windows版可把电脑变成AirPlay、Google Cast和Miracast无线投屏接收端，适合会议演示、课堂教学及家庭大屏分享。发送设备通常无需另装客户端，并可同时接收和智能排列多个镜像会话。
AlwaysUp是一款面向Windows的系统服务注册与程序托管工具，可让普通应用、脚本及批处理在无人登录时随系统启动，并通过状态检测、异常重启、资源监控和邮件通知保障关键任务持续运行。
AnyDesk Windows版是一款轻量化远程桌面与技术支持工具，可用于控制异地电脑、传输文件、远程打印及无人值守访问。它兼顾连接响应、安全权限和部署灵活性，适合个人远程办公、企业设备维护与客服支持。
Boom 3D Windows版是一款面向音乐、电影和游戏场景的系统级音效增强工具，支持虚拟3D环绕声、31段均衡器、预设音效、应用音量控制及本地音乐播放，可配合耳机、扬声器和蓝牙耳机使用。
Boris FX Windows版是一套服务于影视剪辑、视觉特效、运动跟踪、转描、图像修饰及音频修复的专业创作工具集合，可作为插件接入多种主流后期宿主，也包含可独立运行的应用，适合剪辑师、特效师与内容创作者使用。
ChemDraw Windows版是一款面向化学研究、药物研发、材料科学和教学工作的专业结构绘图工具，可快速绘制分子、反应式及生物聚合物，并提供结构整理、格式转换、性质计算和科研文档协作能力。
CODESOFT Windows版是一套企业级条码与RFID标签设计打印工具，可连接Excel、Access、SQL及云端数据源，支持变量、表单、GS1条码、数据库记录和多种工业打印机，适合制造、仓储、物流及合规标识场景。
Deep Freeze 冰点还原 Windows版通过重启恢复技术保护系统盘及指定分区，自动撤销恶意程序、误操作和配置漂移造成的改动，并支持密码保护、解冻空间与多硬盘管理，适合学校机房、公共电脑、办公终端及家庭电脑使用。
EDIUS 11 Windows版是一款面向影视制作、广播电视、纪录片、短视频及教育机构的专业非线性编辑工具，支持4K/8K、多格式混编、HDR调色、字幕、音频处理和后台渲染，并提供素材管理及丰富的导出预设。
FastStone Capture Windows版是一款轻量级屏幕捕捉、录屏与图像编辑工具，可截取窗口、区域、菜单和滚动页面，并提供标注、模糊、取色、OCR、录音录像及多格式导出能力，适合办公说明、教程制作和问题反馈。
Focusky Windows版是一款动画演示与交互课件制作工具，通过无限画布、缩放旋转镜头、模板素材和对象动画组织内容，可导入PPTX，并输出视频、EXE、PDF、网页等格式，适用于课堂教学、微课、商务汇报及产品展示。