摘要：在本地使用 Docker 部署 n8n 自动化流程时，最常见的需求就是调用本地电脑上运行的 ComfyUI、SD WebUI 或其他 API 服务。但在 n8n 中填写 http://127.0.0.1 往往会导致连接失败。本文将深度解析 Docker 网络隔离机制，详细介绍 host.docker.internal 的原理与用法，并提供 Windows/Mac/Linux 全平台的解决方案。
🛑 一、 遇到的问题：为什么 127.0.0.1 连不通？
很多刚接触 Docker 的开发者都会遇到这个经典报错：Connection Refused 或 Econnrefused。
场景复现：
-
宿主机（你的电脑）：运行着 ComfyUI，地址是 http://127.0.0.1:8088。
-
Docker 容器：运行着 n8n。
-
操作：在 n8n 的 HTTP Request 节点中请求 http://127.0.0.1:8088。
-
结果：报错，无法连接。
核心原因解析：
Docker 容器是一个隔离的环境（相当于一个个独立的"虚拟机"）。
-
当你在 n8n 容器里写 127.0.0.1（localhost）时，它指向的是 n8n 容器内部。
-
n8n 会在容器里找端口 8088，显然容器里并没有跑 ComfyUI，所以连接被拒绝。
你需要的是一个能让容器"跳出三界外"，直接找到宿主机的"传送门"。
🚀 二、 解决方案：使用 host.docker.internal
Docker 官方为了解决这个问题，提供了一个特殊的 DNS 域名：host.docker.internal。
1. 修改 n8n 请求地址
将 HTTP Request 节点中的 URL 修改为：
codeText
http://host.docker.internal:8088这个域名会被 Docker 内部的 DNS 服务器自动解析为宿主机的网关 IP，从而实现从容器内部访问宿主机服务。
⚠️ 三、 关键步骤：ComfyUI 必须开启监听（易错点）
这一步不做，改了地址也连不上！
（但如果是独立版，有以后可能已经开启了网络连接，这一步可能不需要做）
默认情况下，ComfyUI（以及大多数本地服务）出于安全考虑，只监听 127.0.0.1。这意味着它只接受本机内部 的请求。虽然 Docker 跑在你电脑上，但在网络层面，来自 Docker 容器的请求被视为外部访问（来自 Docker 网桥网段）。
操作方法：
你需要修改 ComfyUI 的启动参数，使其监听所有网络接口（0.0.0.0）。
-
找到 ComfyUI 的启动脚本（通常是 run_nvidia_gpu.bat 或 run_cpu.bat）。
-
编辑文件，在 main.py 后面添加 --listen 参数。
修改后的命令示例：
codeBash
python main.py --listen
# 或者指定具体的端口
python main.py --listen 0.0.0.0 --port 8088加上 --listen 后，ComfyUI 才能接收来自 Docker 容器的"外部"请求。
🔍 四、 技术科普：host.docker.internal 到底是什么？
为了更深入理解，我们来拆解一下 host.docker.internal 的工作原理。
1. 它解决了什么痛点？
如果不使用这个域名，你只能填写宿主机的局域网 IP（例如 192.168.1.10）。但这有两个致命缺点：
-
IP 不固定：你换个 Wi-Fi 环境，IP 变了，n8n 流程就挂了。
-
配置不通用：你的 Workflow 发给同事，同事的 IP 跟我不一样，他也跑不通。
2. 工作流程
-
DNS 拦截：容器发起对 host.docker.internal 的请求。
-
动态解析：Docker 守护进程拦截该请求，并将其解析为宿主机在 Docker 网桥上的网关 IP（通常是 172.17.0.1 或 192.168.65.2，视系统而定）。
-
流量转发：流量通过 Docker 网桥顺利到达宿主机端口。
💻 五、 全平台兼容性指南（Win/Mac/Linux）
host.docker.internal 并非所有系统默认支持，请根据你的运行环境进行配置。
1. Windows 和 Mac (Docker Desktop)
状态 ：✅ 原生支持
无需任何额外配置，直接使用即可。
2. Linux (Docker Engine)
状态 ：❌ 默认不支持
Linux 原生的 Docker 默认无法解析这个域名，需要手动添加 host 映射。
方案 A：使用 docker run 命令
启动 n8n 时添加 --add-host 参数：
codeBash
docker run -it --add-host=host.docker.internal:host-gateway n8nio/n8n方案 B：使用 Docker Compose（推荐）
在你的 docker-compose.yml 文件中，为 n8n 服务添加 extra_hosts 配置：
codeYaml
version: '3.8'
services:
n8n:
image: n8nio/n8n
ports:
- "5678:5678"
# 核心配置：让 Linux 也能识别 host.docker.internal
extra_hosts:
- "host.docker.internal:host-gateway"
volumes:
- n8n_data:/home/node/.n8n📝 六、 总结
要实现 Docker 版 n8n 访问本地 ComfyUI，请记住这 "两步一检查"：
-
改地址：n8n 中填写 http://host.docker.internal:8088。
-
改监听：ComfyUI 启动参数必须加 --listen。
-
查系统：如果是 Linux 系统，记得在 Docker 配置中添加 extra_hosts 映射。
通过这种方式，无论你的局域网 IP 如何变化，n8n 都能稳定地连接到你的本地 AI 服务，实现自动化的无限可能。
标签：Docker n8n ComfyUI 网络配置 自动化工作流 运维