刚接触 AI 的你，按照教程装好了 Ollama（一个可以在本地运行大语言模型的工具）和 Open WebUI（一个漂亮的网页聊天界面），结果打开网页却看到红色的「Server Connection Error」？别慌，90% 的情况都是两个小问题导致的，跟着本文一步步排查，几分钟就能搞定。

第一步：确认 Ollama 是否正常运行

在终端（Windows 是命令提示符或 PowerShell，Mac 是终端）里输入以下命令：

• curl http://localhost:11434

如果返回 Ollama is running，说明 Ollama 正在工作，问题出在 Open WebUI 的连接设置上，跳到第二步。如果提示 Connection refused，说明 Ollama 没启动，请先运行 ollama serve（或打开桌面应用）再试一次。

第二步：修复 Docker 容器的网络问题

大多数新手都踩过这个坑：你在本机安装了 Ollama，它监听在 localhost:11434，然后你用 Docker 运行 Open WebUI，并让它连接 http://localhost:11434 —— 结果失败。原因是：在 Docker 容器内部，localhost 指的是容器自己，而不是你的电脑。所以容器找不到 Ollama。

解决办法：使用 Docker 提供的特殊地址 host.docker.internal，它代表宿主机（你的电脑）。

1. 如果使用 Docker Desktop（Mac/Windows），这个地址默认可用。
2. 如果在 Linux 上，启动容器时需要加参数 --add-host host.docker.internal:host-gateway。

启动 Open WebUI 容器时，设置环境变量 OLLAMA_BASE_URL=http://host.docker.internal:11434，完整命令示例：

• docker run -d -p 3000:8080 -e OLLAMA_BASE_URL=http://host.docker.internal:11434 --name open-webui ghcr.io/open-webui/open-webui:main

然后访问 http://localhost:3000，应该就能正常连接了。

第三步：检查 Open WebUI 设置中的 URL

如果还是连不上，可能是因为你在 Open WebUI 的网页管理界面里手动设置过 Ollama 地址，这个设置会覆盖环境变量。进入 Settings → Connections，确保 Ollama Base URL 填写的是 http://host.docker.internal:11434（或你的实际地址），然后点击「Verify Connection」测试。如果显示绿色成功，问题解决。

第四步：下一步可以做什么

连接成功后，你就可以在 Open WebUI 中下载模型并开始聊天了。在设置页面选择你喜欢的模型（比如 llama3 或 mistral），然后开始你的第一次 AI 对话吧！