跳到主要内容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 canceleddocker: 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 工作流生涯了。
