n8n 中文系列教程_05.如何在本机部署/安装 n8n（详细图文教程）

        n8n 是一款强大的开源工作流自动化工具，可帮助你连接各类应用与服务，实现自动化任务。如果你想快速体验 n8n 的功能，本机部署是最简单的方式。本教程将手把手指导你在 Windows 或 MacOS 上通过 Docker 轻松安装和运行 n8n，无需服务器，5 分钟即可完成部署！无论是学习、测试，还是搭建个人自动化流程，这篇指南都能帮你快速上手。🚀

一、本机部署概述

本机部署指的是在你日常使用的计算机（Windows 或 MacOS）上部署 n8n。这种部署方式有以下几个特点：

1. 适合新手学习：完全无需考虑复杂的服务器运维问题

2. 快速启动：跳过复杂的服务器环境部署阶段

3. 局限性：不适合长期稳定使用，仅推荐用于学习和试用

二、安装 Docker 环境

2.1 下载 Docker Desktop

1. 访问 Docker 官方网站：Docker: Accelerated Container Application Development

2. 导航至 Products > Docker Desktop

3. 在下载页面选择适合你操作系统的版本：

   • Windows 用户选择 "Docker Desktop for Windows"

   • Mac 用户选择 "Docker Desktop for Mac"

在下载页面里，选择适合你系统的版本进行下载：

运行或拖拽（MacOS）下载后的文件，按提示将 Docker 安装在你的电脑上。

2.2 安装 Docker

• Windows用户：

  1. 双击下载的安装包

  2. 按照安装向导完成安装

  3. 安装完成后可能需要重启电脑

• Mac用户：

  1. 将下载的 .dmg 文件拖拽到 Applications 文件夹

  2. 从应用程序中启动 Docker

  3. 可能需要输入系统密码授权安装

2.3 验证安装

安装完成后：

1. 启动 Docker Desktop

2. 在终端/命令行运行 docker --version

3. 应该能看到类似 Docker version 20.10.17, build 100c701 的输出

三、部署 n8n 工作流自动化工具

3.1 获取 n8n 官方镜像

1. 打开 Docker Desktop 应用

2. 点击顶部搜索框，输入 "n8n"

3. 从搜索结果中选择官方镜像 n8nio/n8n

4. 在电脑任意位置创建一个目录，这个目录是用来存储 n8n 数据的，你可以自己随意找地方，起名字（非中文）。

   

   回到 Docker，选择 Images，找到刚才下载的 n8nio/n8n 镜像，点击右边的三角图标。

   

⚠️ 注意：如果搜索或下载过程中出现错误，可能是网络连接问题。由于n8n部分功能依赖国外服务，建议配置网络环境后再试。

3.2 准备数据存储目录

1. 在电脑任意位置创建一个新目录（建议使用英文路径）

   • 例如：C:\n8n_data 或 /Users/yourname/n8n_data

2. 记住这个路径，后续配置会用到

3.3 创建并配置 n8n 容器

1. 在 Docker Desktop 中切换到 "Images" 标签页

2. 找到已下载的 n8nio/n8n 镜像

3. 点击右侧的三角运行图标

首次运行时需要配置以下参数：

端口设置 (Ports)

• 将容器端口 5678 映射到主机端口 5678

• 这样可以通过 http://localhost:5678 访问 n8n

数据卷设置 (Volumes)

1. 点击 "Volumes" 选项卡

2. 添加一个卷映射：

   • Host path：选择之前创建的目录

   • Container path：填写 /home/node/.n8n/

💡 专业提示：这一步的卷映射至关重要，它将n8n的数据存储目录映射到Docker容器外部。如果不这样做，当容器更新或重建时，所有工作流和数据都会丢失。

3.4 启动 n8n 容器

1. 完成上述配置后，点击 "Run" 按钮

2. 等待约1分钟初始化

3. 在 "Logs" 选项卡中查看启动日志

当看到类似以下日志时，表示启动成功：

2024-07-02 10:36:40 Editor is now accessible via:
2024-07-02 10:36:40 http://localhost:5678/

---

资料推荐

• 💡大模型中转API推荐
• ✨中转使用教程

---

四、访问和使用 n8n

1. 在浏览器中访问 http://localhost:5678/

2. 你将看到 n8n 的登录界面

3. 首次使用可能需要设置管理员账户

🌟 专业建议：如果n8n的运行环境不能访问Google或OpenAI等国际服务，建议配置网络代理。可以使用CloseAI或WildCard等支持免科学上网访问OpenAI和Anthropic模型的代理服务，支持支付宝付款和按量付费。

五、常见问题解答

Q1: 为什么需要映射数据卷？

A: Docker采用数据-程序分离的设计理念。如果不映射数据卷，容器停止或更新时，所有工作流和配置都会丢失。

Q2: 可以更改默认端口吗？

A: 可以。在创建容器时，将主机端口改为其他未被占用的端口即可，如 5678:5678 改为 8080:5678。

Q3: 如何更新n8n版本？

A: 只需重新拉取最新镜像并重新创建容器（使用相同的数据卷配置），你的数据和工作流将保持不变。

希望这篇详细的教程能帮助你顺利在本机部署n8n！如果在部署过程中遇到任何问题，欢迎在评论区留言讨论。有用的话记得点赞收藏噜！