N8N Docker 部署教程:Win/Mac 安装命令与终端代理设置指南

张3Phone 电脑和网络评论4字数 1767阅读5分53秒

想要彻底掌握 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 系统的正确打开方式有两种。

  1. 点击“开始”菜单,搜索框输入“cmd”,敲击回车键即可调出命令提示符。

  2. 快捷操作:按下“Windows键 + R”唤出运行窗口,输入“cmd”后按回车。

Mac 系统的打开方式同样有两种。

  1. 打开“启动台”,在顶部搜索栏输入“终端”并点击打开。

  2. 极客操作:按下 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")

解决好网络问题,回车执行,静待花开。

属于你的自动化引擎,就正式启动了。

继续阅读
weinxin
KM张3Phone
我的微信
微信扫一扫
 
张3Phone
  • 本文由 张3Phone 发表于 2026年3月9日13:16:19
匿名

发表评论

匿名网友
:?: :razz: :sad: :evil: :!: :smile: :oops: :grin: :eek: :shock: :???: :cool: :lol: :mad: :twisted: :roll: :wink: :idea: :arrow: :neutral: :cry: :mrgreen:
确定

拖动滑块以完成验证