Open WebUI 命令速查表 - open-webui 自托管 AI 平台 CLI 全参数
Open WebUI 要解决的是"团队要用模型，但没人愿意各自去开各家控制台"这个问题：它把 Ollama 与任意 OpenAI 兼容服务聚到一个带用户体系、管理后台、知识库和会话历史的界面上，于是模型访问从个人 API Key 变成管理员统一下发。安装启动、更新维护、部署配置三组命令里，真正决定成败的是两个操作细节。一是数据目录必须显式指定，否则用临时方式启动时聊天记录、用户设置和知识库索引会随进程结束一起消失，而这类丢失通常在用户反馈"我的会话不见了"时才被发现。二是升级时的并发问题：多副本或多 worker 部署下同时跑数据库迁移会导致库损坏，正确顺序是先收敛到单副本完成迁移，再扩容恢复负载。这两点是自托管 Open WebUI 时最常见的实际故障来源，其余配置项都可以后调。
安装与启动 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。 - 接非 Ollama 的 OpenAI 兼容服务时在管理后台的 Connections 里填 base_url 与 Key，通常还需追加 /v1 后缀，否则列表能保存但请求全部失败。
- 升级前先备份数据目录再拉新镜像：备份往往只需几十兆，却能在迁移出错时保住全部会话与知识库索引。
- 对外暴露时务必先建管理员账号并关闭公开注册，否则任何拿到地址的人都能用你的模型额度。
常见问题
Open WebUI 和 LM Studio 有什么不同？
Open WebUI 是带管理后台、RAG、多模型对话的平台（偏服务端/团队），LM Studio 偏本地桌面推理客户端；两者可配合（Open WebUI 连 LM Studio 的 Ollama 端点）。
必须连 Ollama 吗？
不是。可连任意 OpenAI 兼容 API（含云端、vLLM、LM Studio），也内置推理引擎做本地 RAG。
由 巧匠 维护
公开更新于 2026年9月10日，内容持续校对官方文档。