跳到主要内容n8n 工作流自动化平台本地部署完整教程 | 极客日志JavaScriptNode.jsAI
n8n 工作流自动化平台本地部署完整教程
n8n 是一款开源 AI 工作流自动化工具,支持完全自托管以确保数据安全。部署流程基于 Docker 环境,首先需检查系统配置并安装 Docker Desktop 或配置 Linux 服务。关键步骤是配置国内镜像源以解决拉取失败问题,随后创建数据卷并运行官方容器命令启动服务。首次访问需注册账号接收激活码,支持通过挂载语言包实现界面汉化。最终用户可通过浏览器访问本地端口开始创建工作流。
ArchDesign1.3K 浏览 n8n 工作流自动化平台本地部署完整教程
n8n 是一款强大的开源 AI 工作流自动化工具,完全自托管让你的数据安全可控。
第一步:环境准备
系统要求检查
开始前,请确认你的电脑配置:
- CPU : 2 核以上
- 内存 : 4GB 以上(推荐 8GB)
- 硬盘 : 至少 20GB 可用空间
- 系统 : Windows10/MacOS/Linux 都支持
步骤 1:安装 Docker
Windows 用户
- 访问 Docker 官网下载 Docker Desktop
- 双击安装包,一路'下一步'完成安装
- 安装完成后,在开始菜单找到 Docker Desktop 并启动

Mac 用户
推荐方式:官网下载安装
- 访问官网:https://www.docker.com/products/docker-desktop/
- 点击
Download for Mac 下载安装包
- 双击下载的
.dmg 文件,拖拽 Docker 到 Applications 文件夹
- 打开 Launchpad,点击 Docker 图标完成初始化
备选方式: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 用户)
推荐操作 :
- 打开 Docker Desktop
- 点击右上角 Settings → Docker Engine
微信扫一扫,关注极客日志
微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
相关免费在线工具
- RSA密钥对生成器
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
- Mermaid 预览与可视化编辑
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
- Keycode 信息
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
- Escape 与 Native 编解码
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
- JavaScript / HTML 格式化
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
- JavaScript 压缩与混淆
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online
在 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"
]
}
方案 B:Linux 服务器用户
sudo mkdir -p /etc/docker
sudo vim /etc/docker/daemon.json
- 按
i 键进入编辑模式
- 粘贴或输入配置内容
- 按
Esc 键退出编辑模式
- 输入
:wq 保存并退出
- 如果遇到权限问题,使用
:w !sudo tee % 强制保存
{
"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"
]
}
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/
第二步:安装 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,那如果想要安装汉化包的朋友就接着往下看。
目前官方只支持英文界面,如果需要切换到中文,需要自行添加国际化(i18n)语言包。
解压后,还是在终端命令窗口中输入如下的命令:(注意替换解压后的地址)
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 工作流生涯了。