甄选推荐系统：
Pocket Bookmarks。 口袋书签
谷歌浏览器插件：立即安装 Pocket Bookmarks
edge浏览器插件：立即安装Pocket Bookmarks为什么你急需这个插件？
3秒极简操作：无需学习成本，清爽界面一键管理
跨设备无缝同步：电脑/手机随时存取重要链接
黑科技AI助手：自动分类+智能推荐，比你自己更懂你的收藏习惯
可视化数据看板：TOP10常用书签、访问趋势一目了然
效率党最爱的功能：
- 多维度分类：支持标签+文件夹双重管理
- 智能排序：按访问频率/创建时间快速筛选
- 团队协作：分类书签一键共享给同事
- 个性展示：九宫格/列表/时间轴多种视图
在 Docker 中运行的 n8n 无法通过 localhost访问宿主机的 API 服务，这是一个非常典型的问题，其根源在于 Docker 容器的网络隔离性。不过别担心，解决方法很明确。
问题根源 🤔
简单来说，当你在 n8n 容器内部使用 http://localhost:5030时，这个 localhost指的是 n8n 容器自己，而不是你的宿主机（物理电脑）。容器里并没有运行你端口为 5030 的 API 服务，所以连接会被拒绝。
解决方案：修改连接地址与服务配置 🛠️
解决此问题的核心是让 n8n 容器能够正确找到宿主机上的服务。推荐使用下表总结的“两步走”方案：
| 步骤 | 操作 | 说明 | 检查点 |
|---|---|---|---|
| 1. 修改 n8n 中的地址 | 将 URL 中的 localhost替换为 host.docker.internal | 这是 Docker 提供的特殊域名，容器可通过它访问宿主机。 | 新的 URL 应为：http://host.docker.internal:5030/api/... |
| 2. 检查宿主机服务监听设置 | 确保你的 API 服务监听所有网络接口（0.0.0.0），而非仅 127.0.0.1 | 如果服务只监听 127.0.0.1，会拒绝来自 Docker 容器的外部请求。 | 查看你的 API 服务启动日志或配置，确认其绑定在 0.0.0.0或已设置 --listen等参数。 |
针对 Linux 用户的特别说明 🐧
如果你在 Linux 系统上直接使用 Docker Engine（而非 Docker Desktop），默认可能不支持 host.docker.internal这个域名。你需要通过以下方式手动添加：
- 如果使用
docker run：在启动命令中添加--add-host=host.docker.internal:host-gateway参数。 - 如果使用
docker-compose：在服务的配置下添加extra_hosts字段：# docker-compose.yml 示例片段 services: n8n: # ... 其他配置 ... extra_hosts: - "host.docker.internal:host-gateway"
其他备选方案
除了上述推荐方案，还有一些其他方法可供参考：
- 使用宿主机 IP 地址：在 n8n 中直接填写你宿主机的本地局域网 IP 地址（如
192.168.1.x）。缺点是如果 IP 地址是动态分配的，可能会发生变化导致连接失败。 - 使用 host 网络模式：在启动 n8n 容器时使用
--network host参数，让容器与宿主机共享网络命名空间。这样容器内的localhost就直接指向宿主机。这种方法主要适用于 Linux，但会消除网络隔离，可能带来安全风险或端口冲突。
总结
总结一下，解决这个连接问题最直接通用的步骤是：
- 在 n8n 的工作流中，将请求的 URL 由
http://localhost:5030/...改为http://host.docker.internal:5030/...。 - 确认你的 API 服务（端口 5030）已配置为监听
0.0.0.0而不仅仅是127.0.0.1。 - （仅限 Linux Docker Engine 用户） 确保 n8n 容器在启动时配置了
host.docker.internal到宿主机的映射。
