### 解决 Docker 环境中 OpenWebUI 无法访问的问题 如果在使用 Docker 部署 OpenWebUI 的过程中遇到无法访问的情况，可能是由于以下几个原因引起的： #### 1. **端口映射配置错误** 确保容器内的服务监听的端口与主机上暴露的端口一致。默认情况下，OpenWebUI 使用的是 `8080` 端口，而通过 `-p 3000:8080` 参数将该端口映射到主机上的 `3000` 端口[^1]。因此，在浏览器中应访问 `http://localhost:3000` 来查看界面。 如果仍然无法访问，请确认以下几点： - 主机防火墙未阻止 `3000` 端口。 - 容器内部的服务确实启动并绑定到了指定端口。 可以通过执行以下命令验证容器状态以及其网络设置： ```bash docker ps ``` #### 2. **Docker Host 地址解析问题** 某些环境下，默认的 `host.docker.internal` 可能不起作用。此时可以尝试手动替换为主机的实际 IPv4 地址。例如，运行如下命令时需明确指定宿主机 IP 地址[^3]: ```bash sudo docker run -d -p 3000:8080 \ --add-host=host.docker.internal:<HOST_IP> \ -v open-webui:/app/backend/data \ --name open-webui \ --restart always \ ghcr.io/open-webui/open-webui:main ``` 其中 `<HOST_IP>` 是指当前机器的真实局域网地址（可通过 `ifconfig` 或者 `ip addr show` 查看）。 #### 3. **环境变量冲突** 当存在多个依赖组件（如 Ollama 和 OpenWebUI），可能会因默认参数不匹配而导致功能异常。为了防止这种情况发生，建议显式定义所有必要的环境变量来覆盖默认行为。比如调整 Ollama 基础 URL 到特定路径下： ```bash docker run -d -p 3000:8080 \ --add-host=host.docker.internal:host-gateway \ -e OLLAMA_BASE_URL=<YOUR_HOST>:<OLLAMA_PORT> \ -v open-webui:/app/backend/data \ --name open-webui \ --restart always \ ghcr.io/open-webui/open-webui:main ``` 这里 `<YOUR_HOST>` 应填写实际服务器名或者公网/私有IP；同时 `<OLLAMA_PORT>` 对应于已知可用的 ollama service port. #### 脚本化部署方案 对于复杂场景下的自动化运维需求，可编写脚本来简化操作流程。下面给出一段简单的 bash shell 实现例子供参考： ```bash #!/bin/bash IMAGE_NAME="ghcr.io/open-webui/open-webui:main" CONTAINER_NAME="open-webui" read -rp "Enter your host ip address (default is '127.0.0.1'): " HOST_IP HOST_IP=${HOST_IP:-"127.0.0.1"} echo "Starting container..." docker stop ${CONTAINER_NAME} &>/dev/null || true && docker rm ${CONTAINER_NAME} &>/dev/null || true docker volume create open-webui-data &>/dev/null || true docker run -d -p 3000:8080 \ --add-host=host.docker.internal:${HOST_IP} \ -e OLLAMA_BASE_URL="${HOST_IP}:11434" \ -v open-webui-data:/app/backend/data \ --name "${CONTAINER_NAME}" \ --restart unless-stopped \ "${IMAGE_NAME}" echo "Container started successfully." ```