n8n 中文文档

Ollama模型节点常见问题

以下是 Ollama 模型节点 的一些常见错误和问题以及解决或排除这些问题的步骤。

加工参数

Ollama Model 节点是一个子节点[^1]。使用表达式处理多个项目时,子节点的行为与其他节点不同。

大多数节点,包括根节点[^2],将任意数量的项目作为输入,处理这些项目,并输出结果。您可以使用表达式来引用输入项,节点依次解析每个项的表达式。例如,给定五个名称值的输入,表达式 {{ $json.name }} 依次解析为每个名称。

在子节点中,表达式总是解析为第一个项目。例如,给定五个名称值的输入,表达式 {{ $json.name }} 总是解析为第一个名称。

无法连接到远程 Ollama 实例

Ollama Model节点支持Bearer token身份验证,用于连接到经过身份验证的代理(如Open WebUI)后面的远程Ollama实例。

对于远程身份验证连接,请在您的Ollama凭据中配置远程URL和API密钥。

请遵循 Ollama 凭证说明 了解更多信息。

使用 Docker 时无法连接到本地 Ollama 实例

Ollama 模型节点使用 Ollama 凭据 定义的基本 URL 连接到本地托管的 Ollama 实例。当您在 Docker 中运行 n8n 或 Ollama 时,您需要配置网络,以便 n8n 可以连接到 Ollama。

Ollama通常监听localhost(本地网络地址)上的连接。在Docker中,默认情况下,每个容器都有自己的localhost,只能从容器内部访问。如果n8n或Ollama中的任何一个在容器中运行,它们将无法通过localhost连接。

解决方案取决于您如何托管这两个组件。

如果只有 Ollama 在 Docker 中

如果只有Ollama在Docker中运行,请通过在容器内绑定到0.0.0.0来配置Ollama监听所有接口(官方镜像已经以这种方式配置)。

运行容器时,使用-p标志发布端口{:target=_blank .external-link}。默认情况下,Ollama在端口11434上运行,因此您的Docker命令应该如下所示:

docker run -d -v ollama:/root/.ollama -p 11434:11434 --name ollama ollama/ollama

配置 Ollama 凭据 时,localhost 地址应该可以正常工作(将 base URL 基本网址 设置为 http://localhost:11434)。

如果 Docker 中只有 n8n

如果只有n8n在Docker中运行,请通过在主机上绑定到0.0.0.0来配置Ollama监听所有接口。

如果您在Linux上的Docker中运行n8n,请在启动容器时使用--add-host标志将host.docker.internal映射到host-gateway。例如:

docker run -it --rm --add-host host.docker.internal:host-gateway --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n n8nio/n8n

如果您使用Docker Desktop,这会为您自动配置。

配置 Ollama 凭证 时,使用 host.docker.internal 作为主机地址,而不是 localhost。例如,要绑定到默认端口 11434,您可以将基本 URL 设置为 http://host.docker.internal:11434。

如果 Ollama 和 n8n 在单独的 Docker 容器中运行

如果n8n和Ollama都在单独的容器中的Docker中运行,您可以使用Docker网络连接它们。

通过在容器内绑定到0.0.0.0来配置Ollama监听所有接口(官方镜像已经以这种方式配置)。

配置 Ollama 凭证 时,使用 Ollama 容器的名称作为主机地址,而不是 localhost。例如,如果您调用 Ollama 容器 my-ollama 并且它侦听默认端口 11434,则您可以将基本 URL 设置为 http://my-ollama:11434。

如果 Ollama 和 n8n 在同一个 Docker 容器中运行

如果 Ollama 和 n8n 在同一个 Docker 容器中运行,则 localhost 地址不需要任何特殊配置。您可以将 Ollama 配置为在 localhost 上侦听,并在 n8n 中的 Ollama 凭据 中配置基本 URL 以使用 localhost:http://localhost:11434。

错误:连接 ECONNREFUSED ::1:11434

当您的计算机启用了IPv6,但Ollama正在监听IPv4地址时,会出现此错误。

要解决此问题,请更改 Ollama 凭据 中的基本 URL 以连接到 127.0.0.1(IPv4 特定的本地地址),而不是可解析为 IPv4 或 IPv6 的 localhost 别名:http://127.0.0.1:11434。

Ollama 和 HTTP/HTTPS 代理

Ollama在其配置中不支持自定义HTTP代理。这使得在自定义HTTP/HTTPS代理后面使用Ollama变得困难。根据您的代理配置,尽管设置了HTTP_PROXY或HTTPS_PROXY环境变量,它可能根本无法工作。

请参阅Ollama 的常见问题解答 了解更多信息。

[^1]: n8n 集群节点由一个或多个连接到根节点的子节点组成。子节点扩展根节点的功能,提供对特定服务或资源的访问,或提供特定类型的专用处理,例如计算器功能。 [^2]: 每个 n8n 集群节点都包含一个用于定义集群主要功能的根节点。一个或多个子节点连接到根节点,以扩展其功能。

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。