跳到主要内容

🚧 服务器连接问题

我们随时为您提供帮助，确保一切设置并顺利运行。以下是针对不同场景的逐步说明，帮助解决与 Ollama 和类似 Hugging Face 等外部服务器的常见连接问题。

🌟 连接到 Ollama 服务器​

🚀 从 Open WebUI 访问 Ollama​

难以从 Open WebUI 连接到 Ollama？可能是因为 Ollama 没有监听允许外部连接的网络接口。让我们来解决这个问题：

  1. 配置 Ollama 以广泛监听 🎧: 将 OLLAMA_HOST 设置为 0.0.0.0，以便让 Ollama 监听所有网络接口。

  2. 更新环境变量: 确保在您的部署环境中正确设置了 OLLAMA_HOST。

  3. 重启 Ollama🔄: 需要重启以使更改生效。

💡 设置完成后，通过访问 WebUI 界面验证 Ollama 是否可用。

有关配置 Ollama 的更详细说明，请参阅 Ollama 的官方文档。

🐳 Docker 连接错误​

如果尝试访问 Ollama 时看到连接错误，可能是因为 WebUI Docker 容器无法与运行在主机上的 Ollama 服务器通信。让我们来修复这个问题：

  1. 调整网络设置 🛠️: 在 Docker 命令中使用 --network=host 标志。这会将容器直接连接到主机的网络。

  2. 更改端口: 请注意内部端口会从 3000 更改为 8080。

示例 Docker 命令:

docker run -d --network=host -v open-webui:/app/backend/data -e OLLAMA_BASE_URL=http://127.0.0.1:11434 --name open-webui --restart always ghcr.io/open-webui/open-webui:main

🔗 运行上述命令后，您的 WebUI 应可通过 http://localhost:8080 访问。

🔒 与 Hugging Face 的 SSL 连接问题​

遇到 SSL 错误？这可能与 Hugging Face 服务器有关。以下是处理方法：

  1. 检查 Hugging Face 服务器状态: 验证他们是否存在已知的故障或问题。

  2. 切换端点: 如果 Hugging Face 无法访问，请在 Docker 命令中切换端点。

解决连接问题的示例 Docker 命令:

docker run -d -p 3000:8080 -e HF_ENDPOINT=https://hf-mirror.com/ --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

🍏 在 MacOS 上使用 Podman​

在 MacOS 上运行 Podman？以下是确保连接的方法：

  1. 启用主机回环: 在您的命令中使用 --network slirp4netns:allow_host_loopback=true。

  2. 设置 OLLAMA_BASE_URL: 确保其指向 http://host.containers.internal:11434。

示例 Podman 命令:

podman run -d --network slirp4netns:allow_host_loopback=true -p 3000:8080 -e OLLAMA_BASE_URL=http://host.containers.internal:11434 -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main