open-webui

环境要求

• Docker 环境（使用 Docker 安装方式时）
• Python 3.11（使用 pip 安装时，避免兼容性问题）
• 如需 GPU 加速，Linux/WSL 需安装 Nvidia CUDA container toolkit
• 某些 Docker 环境可能需要额外网络配置才能连接 Ollama

安装与启动步骤

1. 1Docker 快速启动

   Ollama 在本机时使用此命令，务必挂载数据卷，防止数据库丢失。

   docker run -d -p 3000:8080 --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

   复制

2. 2访问 Web 界面

   容器启动后，在浏览器打开 http://localhost:3000 即可使用。

3. 3连接远程 Ollama

   Ollama 部署在其他服务器时，把 OLLAMA_BASE_URL 换成实际地址再执行。

   docker run -d -p 3000:8080 -e OLLAMA_BASE_URL=https://example.com -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

   复制

4. 4仅用 OpenAI API

   只使用 OpenAI 接口时执行，将 sk-xxxxxxxx 换成自己的真实密钥。

   docker run -d -p 3000:8080 -e OPENAI_API_KEY=sk-xxxxxxxx -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

   复制

5. 5启用 GPU 加速

   使用 :cuda 镜像，需先安装 Nvidia CUDA container toolkit。

   docker run -d -p 3000:8080 --gpus all --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:cuda

   复制

6. 6内置 Ollama 启动

   单容器同时包含 Open WebUI 与 Ollama，有 GPU 与仅 CPU 两条命令按需选择。

   docker run -d -p 3000:8080 --gpus=all -v ollama:/root/.ollama -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:ollama
   docker run -d -p 3000:8080 -v ollama:/root/.ollama -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:ollama

   复制

7. 7pip 本地安装

   需 Python 3.11，安装后运行 serve，访问 http://localhost:8080。

   pip install open-webui
   open-webui serve

   复制

关键配置

如何确认成功

浏览器打开 http://localhost:3000（pip 方式为 http://localhost:8080）并看到聊天界面。

常见问题

注意事项

• Docker 与 pip 两种方式二选一，不要用同名容器重复启动。
• 示例命令中的 sk-xxxxxxxx、https://example.com 需替换为真实值。
• 官方镜像提供 :cuda 和 :ollama 标签，可按需选择。
• Docker Compose、Kustomize、Helm 等更多安装方式见官方文档。