跳到主内容

🚧 服务器连接问题

我们在此帮助您顺利完成所有设置和运行。您将在下方找到针对不同场景量身定制的分步说明，以解决与 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