OpenWebUI 安装与配置指南

1. 确保 Python 3.11+ 已安装

在开始安装前，请确认您的系统已安装 Python 3.11 或更高版本。打开 PowerShell 并运行以下命令检查版本：

python --version

如果未安装或版本过低，请从 Python 官网 下载并安装最新版本。

2. 安装 OpenWebUI

使用 pip 安装 OpenWebUI 包，推荐使用清华大学镜像源以加速下载。在 PowerShell 中执行：

pip install open-webui -i https://pypi.tuna.tsinghua.edu.cn/simple

3. 启动 OpenWebUI 服务

OpenWebUI 依赖 Ollama 服务，因此需先启动 Ollama，然后在另一个 PowerShell 窗口启动 OpenWebUI。

• 步骤 1：启动 Ollama 服务

  ollama serve
  

  此命令应在后台运行，不要关闭窗口。
• 步骤 2：启动 OpenWebUI 打开一个新的 PowerShell 窗口，运行：

  open-webui serve
  

如果发生网络连接或下载错误，配置 Hugging Face 国内镜像（推荐）

为加速模型下载，设置 Hugging Face 的国内镜像源。以下是完整配置步骤：

• 步骤 1：设置环境变量
  • 临时生效（仅当前会话）：

    $env:HF_ENDPOINT = "https://hf-mirror.com"
    

  • 永久生效（添加到用户环境变量）：

    [System.Environment]::SetEnvironmentVariable("HF_ENDPOINT", "https://hf-mirror.com", "User")
    

    重启 PowerShell 或系统后生效。
• 步骤 2：升级 huggingface-hub 库 确保在您的 Python 虚拟环境中（如使用），运行：

  pip install --upgrade huggingface-hub>=0.19.0 -i https://pypi.tuna.tsinghua.edu.cn/simple
  

• 步骤 3：重新启动 OpenWebUI 先停止可能运行的旧进程，然后重新启动：

  # 停止之前的 Python 进程
  taskkill /F /IM python.exe 2>$null
  
  # 如果使用虚拟环境（如 conda），先激活
  conda activate openwebui_env
  
  # 设置环境变量并启动 OpenWebUI
  $env:HF_ENDPOINT = "https://hf-mirror.com"
  open-webui serve
  

注意事项

• 虚拟环境建议：为避免依赖冲突，建议在安装前创建并激活虚拟环境（例如使用 conda 或 venv）。例如：

  conda create -n openwebui_env python=3.11
  conda activate openwebui_env
  

• 网络问题：如果遇到下载错误，检查镜像源是否可用，或尝试其他国内源（如阿里云）。
• 服务状态：启动后，访问 http://localhost:8080 或指定端口检查 OpenWebUI 是否正常运行。

如果您在操作中遇到问题，请提供具体错误信息，我将协助您解决。