Open WebUI 命令速查表 - open-webui 自托管 AI 平台 CLI 全参数
Open WebUI 是功能丰富的自托管 AI 平台，可连 Ollama 与任意 OpenAI 兼容 API，内置 RAG、多模型对话与管理后台。open-webui 是它的命令行入口：serve 启动、指定端口与数据目录，也能用 Docker / Helm 部署。本表覆盖安装、启动与部署，读完即可自建一个带管理后台的私有 AI 门户。
安装与启动 6
pip install open-webui用 pip 安装
open-webui serve启动服务（默认 8080）
open-webui serve --port 8088指定端口启动
open-webui serve --host 0.0.0.0对外绑定地址
DATA_DIR=./data open-webui serve指定数据目录启动
python -m open_webui serve用模块方式启动
更新与维护 6
pip install -U open-webui升级到最新版
open-webui serve --help查看启动参数
rm -rf ~/.open-webui清空数据（谨慎）
pip uninstall open-webui卸载包
UVICORN_WORKERS=1 open-webui serve单 worker 跑迁移（升级用）
open-webui --help查看顶层命令
部署与配置 8
docker run -d -p 3000:8080 ghcr.io/open-webui/open-webui:mainDocker 启动
WEBUI_AUTH=False open-webui serve单用户模式（无登录）
OLLAMA_BASE_URL=https://example.com open-webui serve连接远程 Ollama
helm repo add open-webui https://open-webui.github.io/helm-charts添加 Helm 仓库
kubectl get pods查看 K8s 部署状态
DATA_DIR=~/.open-webui uvx open-webui@latest serve用 uvx 启动并固定数据目录
WEBUI_SECRET_KEY=xxx open-webui serve设置持久化密钥避免被踢出
open-webui serve --port 8080显式指定默认端口
提示
- 务必设置 DATA_DIR，否则 uvx 临时目录会在进程结束后丢弃聊天与设置。
- 多 worker（UVICORN_WORKERS>1）或 K8s 多副本升级时，先缩到单副本跑完迁移再扩容，避免库损坏。
- 默认 8080 端口，Docker 常用 `-p 3000:8080` 把 UI 暴露到 3000。
常见问题
Open WebUI 和 LM Studio 有什么不同？
Open WebUI 是带管理后台、RAG、多模型对话的平台（偏服务端/团队），LM Studio 偏本地桌面推理客户端；两者可配合（Open WebUI 连 LM Studio 的 Ollama 端点）。
必须连 Ollama 吗？
不是。可连任意 OpenAI 兼容 API（含云端、vLLM、LM Studio），也内置推理引擎做本地 RAG。
由 巧匠 维护
公开更新于 2026年9月10日，内容持续校对官方文档。