Open WebUI 是一个自托管的 Web 前端工具，专为与本地大语言模型（LLM）交互而设计。本文介绍了官方推荐的 Docker 部署命令、更新方法以及 Docker Compose 配置，帮助你快速搭建并维护 Open WebUI 服务。

目录

1. 环境准备
2. 官方 Docker 命令
3. 官方 Docker Compose 配置
4. 更新指南
5. 验证部署
6. 总结

1. 环境准备

• Docker 安装：请确保你的服务器或本地电脑已安装 Docker。可从 Docker 官网 下载适合的平台版本。
• 网络与端口：本教程中，Open WebUI 将容器内端口 8080 映射到主机端口 3000，请确认该端口未被占用。

2. 官方 Docker 命令

以下为 Open WebUI 官方推荐的 Docker 命令：

docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main

说明：

• -d：后台运行容器。
• -p 3000:8080：将主机端口 3000 映射到容器内的 8080 端口。
• -v open-webui:/app/backend/data：将容器内的数据目录挂载到名为 open-webui 的 Docker 卷，实现数据持久化。
• --name open-webui：为容器命名，方便管理。
• ghcr.io/open-webui/open-webui:main：指定使用的镜像及版本。

3. 官方 Docker Compose 配置

你也可以使用 Docker Compose 来管理服务，下面是官方提供的 Compose 配置（版本 3）：

version: '3'
services:
  openwebui:
    image: ghcr.io/open-webui/open-webui:main
    ports:
      - "3000:8080"
    volumes:
      - open-webui:/app/backend/data
volumes:
  open-webui:

将上述内容保存为 docker-compose.yml 文件后，在该目录下运行：

docker-compose up -d

即可启动 Open WebUI 服务。

4. 更新指南

Open WebUI 提供了简单的更新方式，参考官方文档的 Updating 页面。更新方法如下：

• 使用 Docker 命令：停止当前容器（如果需要），然后运行以下命令拉取最新镜像： docker pull ghcr.io/open-webui/open-webui:main 重启容器即可。若你使用的是 Docker Compose，则可运行： docker-compose pull docker-compose up -d
• 注意：更新过程不会影响挂载的卷数据（如配置和日志）。

更多详细信息请参考官方 更新文档。

5. 验证部署

启动完成后，在浏览器中访问：

http://localhost:3000/

如果你在远程服务器上部署，请将 localhost 替换为服务器 IP 地址。若页面正常显示，则表示部署成功。

6. 总结

本文介绍了 Open WebUI 的官方 Docker 部署命令、 Docker Compose 配置以及更新方法。通过上述步骤，你可以轻松搭建并维护一个自托管的 Open WebUI 服务，用于与本地大语言模型交互。若有任何疑问或遇到问题，欢迎在评论区交流讨论，或参考 Open WebUI 官方 GitHub 获取更多信息。