本文将手把手教你如何在本地电脑部署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. 点击右上角 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.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工作流生涯了。
欢迎在评论区分享你的部署经验 👇 如果喜欢本文,记得点赞✨ + 收藏📌 + 转发📮 关注我们,获取更多优质技术教程 🔔
推荐阅读: