跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像AI 生图工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

n8n 工作流自动化平台本地部署完整教程

n8n 是一款开源 AI 工作流自动化工具,支持完全自托管以确保数据安全。部署流程基于 Docker 环境,首先需检查系统配置并安装 Docker Desktop 或配置 Linux 服务。关键步骤是配置国内镜像源以解决拉取失败问题,随后创建数据卷并运行官方容器命令启动服务。首次访问需注册账号接收激活码,支持通过挂载语言包实现界面汉化。最终用户可通过浏览器访问本地端口开始创建工作流。

ArchDesign发布于 2026/2/6更新于 2026/7/251.4K 浏览
n8n 工作流自动化平台本地部署完整教程

n8n 工作流自动化平台本地部署完整教程

n8n 是一款强大的开源 AI 工作流自动化工具,完全自托管让你的数据安全可控。


第一步:环境准备

系统要求检查

开始前,请确认你的电脑配置:

  • CPU : 2 核以上
  • 内存 : 4GB 以上(推荐 8GB)
  • 硬盘 : 至少 20GB 可用空间
  • 系统 : Windows10/MacOS/Linux 都支持

步骤 1:安装 Docker

Windows 用户
  1. 访问 Docker 官网下载 Docker Desktop
  2. 双击安装包,一路'下一步'完成安装
  3. 安装完成后,在开始菜单找到 Docker Desktop 并启动

在这里插入图片描述

Mac 用户

推荐方式:官网下载安装

  1. 访问官网:https://www.docker.com/products/docker-desktop/
  2. 点击 Download for Mac 下载安装包
  3. 双击下载的 .dmg 文件,拖拽 Docker 到 Applications 文件夹
  4. 打开 Launchpad,点击 Docker 图标完成初始化

备选方式:Homebrew 安装

# 使用 Homebrew 一键安装
brew install docker

验证安装 : 打开终端/命令行,输入:

docker --version

看到版本号就说明成功了!


步骤 2:配置国内镜像源(推荐多源冗余)

⚠️ 重要提醒:这是整个教程最关键的一步! 根据实测,90% 的同学无法成功安装 n8n 都是因为镜像拉取失败。请务必认真完成这一步!

问题表现 :如果你遇到以下错误,就是镜像源的问题:

  • Error response from daemon: Get "https://registry-1.docker.io/v2/": net/http: request canceled
  • docker: Error response from daemon: manifest unknown
  • 长时间卡在"Pulling fs layer"或"Waiting"状态

解决方案 :配置国内镜像源!

快速选择你的系统类型

方案 A:Windows/Mac(Docker Desktop 用户)

推荐操作 :

  1. 打开 Docker Desktop
  2. 点击右上角 Settings → Docker Engine
  3. 在 registry-mirrors 数组中添加:
{
  "registry-mirrors": [
    "https://hub-mirror.c.163.com",
    "https://dockercf.jsdelivr.fyi",
    "https://docker.jsdelivr.fyi",
    "https://dockertest.jsdelivr.fyi",
    "https://docker.registry.cyou",
    "https://docker.nju.edu.cn",
    "https://docker.mirrors.ustc.cn",
    "https://mirror.iscas.ac.cn",
    "https://docker.m.daocloud.io",
    "https://docker.xuanyuan.me",
    "https://mirror.baidubce.com",
    "https://docker.1panel.live",
    "https://hub.rat.dev"
  ]
}
  1. 点击 Apply & Restart

在这里插入图片描述

方案 B:Linux 服务器用户
  1. 创建配置文件 :
sudo mkdir -p /etc/docker
  1. 编辑配置文件 :
sudo vim /etc/docker/daemon.json

vim 操作步骤 :

  • 按 i 键进入编辑模式
  • 粘贴或输入配置内容
  • 按 Esc 键退出编辑模式
  • 输入 :wq 保存并退出
  • 如果遇到权限问题,使用 :w !sudo tee % 强制保存
  1. 添加配置内容 :
{
  "registry-mirrors": [
    "https://hub-mirror.c.163.com",
    "https://dockercf.jsdelivr.fyi",
    "https://docker.jsdelivr.fyi",
    "https://dockertest.jsdelivr.fyi",
    "https://docker.registry.cyou",
    "https://docker.nju.edu.cn",
    "https://docker.mirrors.ustc.cn",
    "https://mirror.iscas.ac.cn",
    "https://docker.m.daocloud.io",
    "https://docker.xuanyuan.me",
    "https://mirror.baidubce.com",
    "https://docker.1panel.live",
    "https://hub.rat.dev"
  ]
}
  1. 重启 Docker 服务 :
sudo systemctl daemon-reload
sudo systemctl restart docker

在这里插入图片描述


验证配置是否成功

执行验证命令 :

docker info | grep -A 3 "Registry Mirrors"

成功标志 :输出中包含你配置的镜像源地址,例如:

Registry Mirrors: https://hub-mirror.c.163.com/ https://docker.registry.cyou/ https://docker.nju.edu.cn/

测试拉取速度 :

docker pull hello-world

如果能在 10 秒内完成,说明镜像源配置成功!


第二步:安装 n8n

Docker 环境就绪后,执行以下命令即可完成 n8n 部署:

创建 n8n 数据卷:

docker volume create n8n_data

启动 n8n(官方推荐):

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -e GENERIC_TIMEZONE="Asia/Shanghai" \
  -e TZ="Asia/Shanghai" \
  -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
  -e N8N_RUNNERS_ENABLED=true \
  -v n8n_data:/home/node/.n8n \
  n8nio/n8n

🎉 访问 n8n :浏览器打开 http://localhost:5678 ,开始创建你的第一个工作流!


第三步:使用 n8n

注册并激活 n8n

首次进入 n8n 界面,可以看到注册页面。大家根据自己的需求随意填写就好,这个填写什么内容不影响后期的软件使用。

在这里插入图片描述

完成注册以后,要留下一个邮箱用来接收 激活码 。

在这里插入图片描述

如果有可能,最好留 Gmail 邮箱。QQ 邮箱好像容易出错,收不到激活码。邮箱中收到激活码之后,就可以在 Settings 中的 Usage and plan 输入进行激活。激活完成,会出现一个 Registered 的标记。

在这里插入图片描述

到这就算是把 n8n 搭建起来了。


第四步:汉化安装

上一步我们安装完了 n8n,那如果想要安装汉化包的朋友就接着往下看。

目前官方只支持英文界面,如果需要切换到中文,需要自行添加国际化(i18n)语言包。

这里需要用到 github 上的一个 n8n 汉化包,地址如下:https://github.com/other-blowsnow/n8n-i18n-chinese/releases

将该项目的安装包下载到本地,进行解压。

在这里插入图片描述

解压后,还是在终端命令窗口中输入如下的命令:(注意替换解压后的地址)

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -e GENERIC_TIMEZONE="Asia/Shanghai" \
  -e TZ="Asia/Shanghai" \
  -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
  -e N8N_RUNNERS_ENABLED=true \
  -v 解压后的地址:/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist \
  -v n8n_data:/home/node/.n8n \
  -e N8N_DEFAULT_LOCALE=zh-CN \
  -e N8N_SECURE_COOKIE=false \
  n8nio/n8n

重新访问 http://localhost:5678 ,我们看到汉化后的界面了。

在这里插入图片描述

到这里为止,恭喜你,完成了 n8n 的本地化部署安装。可以开始你的 AI 工作流生涯了。

目录

  1. n8n 工作流自动化平台本地部署完整教程
  2. 第一步:环境准备
  3. 系统要求检查
  4. 步骤 1:安装 Docker
  5. Windows 用户
  6. Mac 用户
  7. 使用 Homebrew 一键安装
  8. 步骤 2:配置国内镜像源(推荐多源冗余)
  9. 快速选择你的系统类型
  10. 方案 A:Windows/Mac(Docker Desktop 用户)
  11. 方案 B:Linux 服务器用户
  12. 验证配置是否成功
  13. 第二步:安装 n8n
  14. 创建 n8n 数据卷:
  15. 启动 n8n(官方推荐):
  16. 第三步:使用 n8n
  17. 注册并激活 n8n
  18. 第四步:汉化安装
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • MySQL 数据库表操作:数据类型与约束详解
  • Llama Guard 3 8B 模型安全分类技术报告解读
  • Mac 命令行安装与使用 Claude Code 终端 AI 编程助手
  • GitHub 7 款 Claude Skills 开源项目:Skill Creator、Superpowers 与 Code Review 实战指南
  • MiGPT GUI 部署小爱音箱接入大模型配置
  • C++ 类与对象进阶:初始化列表、静态成员与编译器优化
  • VS Code 配置 GitHub Copilot 使用第三方模型 API
  • AI 大模型在制造业中的应用类型与核心能力
  • 基于 OpenClaw 与优云智算的公众号 AI 自动化创作发布流程
  • 用 WebGIS 和百度天气做一个复古天气预报页
  • 商汤开源 SenseNova-MARS:多模态搜索推理模型解析
  • 2024 主流 AI 绘图工具深度解析:Midjourney 与 Stable Diffusion 对比
  • CSS 颜色函数与渐变:构建绚丽前端界面
  • C++ 继承基础:概念定义、访问权限与默认成员函数
  • ToDesk 内置 ToClaw AI 实现科技新闻日报自动化实战
  • ORB-SLAM3 开源视觉与视觉惯性 SLAM 库详解
  • Java 大数据在智能家居能源消耗趋势预测与节能策略优化中的应用
  • Linux 进程与 fork 系统调用详解
  • Coze 工作原理与实战案例:构建 AI Agent
  • AI Infra 底层逻辑与落地实战指南

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online