kylefoxaustin/openwebui

OpenWebUI与Ollama Docker镜像

结合https://github.com/open-webui/openwebui%E4%B8%8Ehttps://github.com/ollama/ollama%E7%9A%84Docker%E9%95%9C%E5%83%8F%EF%BC%8C%E6%8F%90%E4%BE%9B%E6%97%A0%E7%BC%9D%E7%9A%84AI%E5%BC%80%E5%8F%91%E4%BD%93%E9%AA%8C%E3%80%82

可用镜像

• kylefoxaustin/openwebui-ollama:latest 或 kylefoxaustin/openwebui-ollama:latest-cpu - CPU版本
• kylefoxaustin/openwebui-ollama:latest-gpu - 带NVIDIA CUDA支持的GPU版本

快速开始

CPU版本

bash
docker run -d \
  --name openwebui \
  -p 8080:8080 \
  -p 11434:11434 \
  -v ollama-data:/root/.ollama \
  -v openwebui-data:/app/backend/data \
  kylefoxaustin/openwebui-ollama:latest

GPU版本

bash
docker run -d \
  --name openwebui-gpu \
  --gpus all \
  -p 8080:8080 \
  -p 11434:11434 \
  -v ollama-data:/root/.ollama \
  -v openwebui-data:/app/backend/data \
  kylefoxaustin/openwebui-ollama:latest-gpu

通过以下地址访问Web界面：http://localhost:8080

使用场景

与本地Ollama安装共存

如果主机已运行Ollama，需将容器的Ollama端口映射到不同的主机端口：

bash
docker run -d \
  --name openwebui \
  -p 8080:8080 \
  -p 11435:11434 \
  -v ollama-data:/root/.ollama \
  -v openwebui-data:/app/backend/data \
  kylefoxaustin/openwebui-ollama:latest

同时运行CPU和GPU容器

要同时运行CPU和GPU容器，需使用不同的端口映射：

bash
# CPU容器
docker run -d \
  --name openwebui-cpu \
  -p 8080:8080 \
  -p 11434:11434 \
  -v ollama-cpu-data:/root/.ollama \
  -v openwebui-cpu-data:/app/backend/data \
  kylefoxaustin/openwebui-ollama:latest-cpu

# GPU容器
docker run -d \
  --name openwebui-gpu \
  --gpus all \
  -p 8081:8080 \
  -p 11435:11434 \
  -v ollama-gpu-data:/root/.ollama \
  -v openwebui-gpu-data:/app/backend/data \
  kylefoxaustin/openwebui-ollama:latest-gpu

通过以下地址访问界面：

• CPU版本：http://localhost:8080
• GPU版本：http://localhost:8081

与外部Ollama配合使用

要将OpenWebUI与外部Ollama实例（如运行在其他服务器或容器中）配合使用：

bash
docker run -d \
  --name openwebui-only \
  -p 8080:8080 \
  -e OLLAMA_BASE_URL=http://<ollama-host>:11434 \
  -v openwebui-data:/app/backend/data \
  kylefoxaustin/openwebui-ollama:latest

将<ollama-host>替换为Ollama服务器的主机名或IP地址。

环境变量

数据持久化

以下卷用于数据持久化：

• /root/.ollama：Ollama模型和配置
• /app/backend/data：OpenWebUI数据（对话、设置等）

故障排除

常见问题

1. 端口冲突：若出现"address already in use"错误，可能有其他服务使用相同端口。如使用场景所示，可使用替代端口。

2. GPU未检测到：确保已正确安装NVIDIA驱动和NVIDIA Container Toolkit。可通过以下命令测试：

   bash
   docker run --gpus all nvidia/cuda:11.8.0-base-ubuntu22.04 nvidia-smi
   

3. 容器崩溃：通过以下命令查看日志：

   bash
   docker logs openwebui
   

4. 模型加载失败：首次拉取模型可能需要时间。查看Ollama日志：

   bash
   docker exec -it openwebui cat /var/log/supervisor/ollama.err.log
   

5. Web界面无法访问：确保内部Ollama实例正常运行：

   bash
   docker exec -it openwebui curl -s http://localhost:11434/api/tags
   

高级配置

Docker Compose

对于更复杂的设置，可使用Docker Compose。以下是示例配置：

yaml
version: '3.8'

services:
  openwebui:
    image: kylefoxaustin/openwebui-ollama:latest-gpu
    container_name: openwebui
    restart: unless-stopped
    ports:
      - "8080:8080"
      - "11434:11434"
    volumes:
      - ollama-data:/root/.ollama
      - openwebui-data:/app/backend/data
    environment:
      - OLLAMA_HOST=0.0.0.0
      - PORT=8080
      - HOST=0.0.0.0
      - OLLAMA_BASE_URL=http://localhost:11434
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: all
              capabilities: [gpu]

volumes:
  ollama-data:
  openwebui-data:

保存为docker-compose.yml并运行：

bash
docker-compose up -d

资源限制

控制CPU和内存使用：

bash
docker run -d \
  --name openwebui \
  --cpus 4 \
  --memory 8G \
  -p 8080:8080 \
  -p 11434:11434 \
  -v ollama-data:/root/.ollama \
  -v openwebui-data:/app/backend/data \
  kylefoxaustin/openwebui-ollama:latest

从源码构建

如需自行构建镜像：

bash
# CPU镜像
docker build -f Dockerfile.cpu -t openwebui-ollama:cpu .

# GPU镜像
docker build -f Dockerfile.gpu -t openwebui-ollama:gpu .

许可证

这些Docker镜像结合了OpenWebUI和Ollama，各自拥有相应的许可证。有关更多信息，请参阅原始项目。

kylefoxaustin