想要彻底掌握 N8N,本地部署是绕不开的第一步。
先把需要的相关链接和兵器库给你们整理好:
Docker 容器官网:https://www.docker.com/ Docker Hub 镜像站:https://hub.docker.com/ N8N 官方网站:https://n8n.io/ N8N 的 Github 仓库:https://github.com/n8n-io/n8n 全球时区参考列表:https://www.zeitverschiebung.net/cn/all-time-zones.html
关于 Docker 的安装,有一个必须注意的细节。
对于 Windows 用户,Docker 安装时默认会占用 C 盘。 如果你的 C 盘空间告急,强烈建议在安装时更换到其他盘符。 Mac 用户则无需操心,保持默认配置一路“下一步”即可。
接下来是核心的部署环节。
强烈建议:所有的部署命令,先在本地文本编辑器里修改好路径,再复制到终端执行。
Windows 环境下的 Docker 部署指令如下:
docker run -d --name n8n -p 5678:5678 -e GENERIC_TIMEZONE="Asia/Shanghai" -e TZ="Asia/Shanghai" -v /本地路径/n8n:/home/node/.n8n -v /本地路径/n8ndata:/home/node/n8ndata docker.n8n.io/n8nio/n8n
Mac 终端的 Docker 部署指令如下:
docker run -d --name n8n -p 5678:5678 -e GENERIC_TIMEZONE="Asia/BeiJing" -e TZ="Asia/BeiJing" -v 你的n8n文件地址 -v 你的data文件地址 docker.n8n.io/n8nio/n8n
(💡 实操小贴士:不知道怎么写路径?建议直接把桌面文件夹拖进终端,系统会自动生成绝对路径)。
关于指令中几个核心参数的说明:
GENERIC_TIMEZONE 和 TZ 都是用来设置系统的时区。 其中 TZ 是 Linux 的标准时区变量,目前所有主流应用都完美兼容。 而 GENERIC_TIMEZONE 则是 N8N 的旧版本参数(新版本强烈推荐直接使用 TZ)。 镜像地址 docker.n8n.io/n8nio/n8n 指的是 N8N 的最新稳定版(latest stable version)。 这行代码其实等同于显式指定了 docker.n8n.io/n8nio/n8n:latest。
部署过程中,很多新手会卡在一些基础操作上。
排障指南一:终端 / PowerShell 到底怎么打开?
Windows 系统的正确打开方式有两种。
-
点击“开始”菜单,搜索框输入“cmd”,敲击回车键即可调出命令提示符。
-
快捷操作:按下“Windows键 + R”唤出运行窗口,输入“cmd”后按回车。
Mac 系统的打开方式同样有两种。
-
打开“启动台”,在顶部搜索栏输入“终端”并点击打开。
-
极客操作:按下 Command(⌘) + 空格键,呼出搜索框,输入“终端”,回车确认。
排障指南二:在终端里执行拉取 N8N 镜像的指令,为什么毫无反应?
不用怀疑,这种情况 99% 的原因,是你的终端环境无法连接外网。 首选方案是:在本地开启科学节点,并且最好设置为全局模式。 如果全局模式依然无效,那就需要用代码给终端单独配置网络代理。
对于 MAC 电脑: 在终端中先执行以下两行代码,这会为终端临时赋予 HTTP 代理能力。 (注意:把下方代码中的“端口号”,替换为你本地代理软件的实际 HTTP 端口)。 export http_proxy="http://127.0.0.1:端口号" export https_proxy="http://127.0.0.1:端口号"
对于 Windows 电脑: 打开 PowerShell,执行以下两行代码。 同样,记得把“端口号”替换为你自己的实际代理端口。 [Environment]::SetEnvironmentVariable("http_proxy", "http://127.0.0.1:端口号", "User") [Environment]::SetEnvironmentVariable("https_proxy", "http://127.0.0.1:端口号", "User")
解决好网络问题,回车执行,静待花开。
属于你的自动化引擎,就正式启动了。








评论