免费部署 n8n 自动化引擎:本地部署完整教程

532 阅读5分钟

本文将手把手教你如何在本地电脑部署n8n工作流自动化平台。n8n是一款强大的开源AI工作流自动化工具,完全自托管让你的数据安全可控。

关于n8n的其他部署方式,请移步文章末尾处推荐阅读 👉


第一步:环境准备 🔧

系统要求检查

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

CPU: 2核以上

内存: 4GB以上(推荐8GB)

硬盘: 至少20GB可用空间

系统: Windows10/MacOS/Linux都支持

步骤1:安装Docker

Windows用户

1. 访问 Docker官网下载Docker Desktop

2. 双击安装包,一路"下一步"完成安装

3. 安装完成后,在开始菜单找到Docker Desktop并启动

在这里插入图片描述

Mac用户

推荐方式:官网下载安装

1. 访问官网:www.docker.com/products/do…

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. 点击右上角 SettingsDocker 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.edu.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"
 ]
}

4. 点击 Apply & Restart

在这里插入图片描述

🖥️ 方案B:Linux服务器用户

1. 创建配置文件

sudo mkdir -p /etc/docker

2. 编辑配置文件

sudo vim /etc/docker/daemon.json

vim操作步骤

• 按 i 键进入编辑模式

• 粘贴或输入配置内容

• 按 Esc 键退出编辑模式

• 输入 :wq 保存并退出

• 如果遇到权限问题,使用 :w !sudo tee % 强制保存

3. 添加配置内容

{
  "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.edu.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"
 ]
}

4. 重启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汉化包,地址如下:github.com/other-blows…

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

在这里插入图片描述

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

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工作流生涯了。


欢迎在评论区分享你的部署经验 👇 如果喜欢本文,记得点赞✨ + 收藏📌 + 转发📮 关注我们,获取更多优质技术教程 🔔

推荐阅读:

免费部署 n8n 自动化引擎:ClawCloud 完整教程

免费部署 n8n 自动化引擎:HuggingFace 完整教程