使用 Python包管理工具 uv 完成 Open WebUI 的安装

@小匠2025-03-29 20:28

uv 是一个极其快速的 Python 包安装器和解析器，用 Rust 编写，旨在作为 pip 和 pip-tools 工作流的替代品

使用 uv 安装（推荐）

macOS/Linux：

kotlin 复制代码

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows：

kotlin 复制代码

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

运行 Open WebUI

安装 UV 后，运行 Open WebUI 就比较简单了。

使用以下命令，确保设置 DATA_DIR 环境变量，以避免数据丢失。

macOS/Linux：

kotlin 复制代码

DATA_DIR=~/.open-webui uvx --python 3.11 open-webui@latest serve

Windows：

kotlin 复制代码

$env:DATA_DIR="C:\open-webui\data"; uvx --python 3.11 open-webui@latest serve

设置离线模式：

kotlin 复制代码

$env:DATA_DIR="H:\open-webui\data"; $env:HF_HUB_OFFLINE=1; $env:ENABLE_OPENAI_API=False; uvx --python 3.11 open-webui@latest serve

环境变量解释

DATA_DIR 指定数据存储路径：DATA_DIR

HF_HUB_OFFLINE 设置离线环境

ENABLE_OPENAI_API 禁用 open api （不禁用的话访问webui时，会去请求open api 导致页面处于长时间请求的状态）