docker本地开发部署open-webui
时间: 2025-04-18 09:48:49 浏览: 71
### 使用 Docker 部署 Open WebUI 的教程
为了在本地开发环境中使用 Docker 成功部署 Open WebUI,考虑到国内网络状况,推荐采用国内镜像源来加速镜像获取过程[^1]。
#### 准备工作
确保已经安装并配置好 Docker 环境。如果尚未完成此操作,则需先访问[Docker官方文档](https://docs.docker.com/get-docker/)按照指引进行设置。
#### 获取镜像
利用优化后的命令行指令从国内镜像仓库拉取最新的 Open WebUI 版本:
```bash
docker pull registry.cn-hangzhou.aliyuncs.com/open-webui/open-webui:main
```
该命令会自动连接至阿里云提供的中国区镜像站,从而显著提升下载效率。
#### 启动容器
通过下面这条定制化的 `docker run` 命令启动一个新的容器实例,并映射必要的端口和服务参数:
```bash
docker run -d \
-p 3000:8080 \
--add-host=host.docker.internal:host-gateway \
-v /path/to/local/directory:/app/backend/data \
--name open-webui \
--restart always \
registry.cn-hangzhou.aliyuncs.com/open-webui/open-webui:main
```
上述命令中的 `-v` 参数用于指定主机上的目录路径 `/path/to/local/directory` 映射到容器内的数据存储位置;请注意替换为实际存在的文件夹地址。而其他选项则保持不变,以确保服务能够稳定运行。
#### 访问应用
一旦容器成功创建并启动之后,在浏览器中输入 http://localhost:3000 即可浏览和交互 Open WebUI 应用程序界面。
#### 维护更新
对于后续版本升级或其他维护需求,可以通过执行 `docker stop`, `docker rm` 和重新运行前述的 `pull` 及 `run` 指令来进行平滑过渡。
阅读全文
相关推荐


















