使用Docker🐳安装 Open WebUI
第一步:拉取Open WebUI镜像 从GitHub容器仓库获取最新镜像:
docker pull ghcr.io/open-webui/open-webui:main
若拉取太慢可使用南京大学镜像源ghcr.nju.edu.cn
docker pull ghcr.nju.edu.cn/open-webui/open-webui:main
第二步:运行容器 使用默认配置运行容器(含数据持久化卷映射):
docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main
关键参数说明:
- 卷映射 (-v open-webui:/app/backend/data):确保数据持久化存储,避免容器重启时数据丢失
- 端口映射 (-p 3000:8080):将WebUI暴露在本地机器的3000端口
访问WebUI 容器运行后访问:
http://IP:3000
更新指南 可通过Watchtower自动更新或手动更新:
选项1:使用Watchtower
docker run --rm --volume /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --run-once open-webui
(如容器名称不同请替换open-webui)
选项2:手动更新
# 停止并删除旧容器
docker rm -f open-webui
# 获取最新镜像
docker pull ghcr.io/open-webui/open-webui:main
# 重新启动
docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main
后续步骤 安装完成后访问:
- Open WebUI:IP:3000
- Python部署时:IP:8080
使用 uv 安装 Open WebUI
1. 安装 uv
根据操作系统选择对应命令:
Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh
2. 运行 Open WebUI
安装完成后,通过以下命令一键运行(需设置 DATA_DIR
环境变量防止数据丢失):
Linux:
DATA_DIR=~/.open-webui uvx --python 3.11 open-webui@latest serve
通过 Python 更新
使用 pip
升级本地 Open-WebUI 包至最新版:
pip install -U open-webui
(-U
或 --upgrade
参数确保获取最新版本)
后续步骤
安装完成后访问:
- Open WebUI 主界面:
http://localhost:3000
- Python 部署时:
http://localhost:8080/